75 lines
3.9 KiB
Markdown
75 lines
3.9 KiB
Markdown
|
# Platform File Map
|
||
|
|
|
||
|
|
This page lists common Trellis file locations in a user project by platform. Whether a platform directory exists in an actual project depends on which `trellis init --<platform>` commands the user ran.
|
||
|
|
|
||
|
|
## Matrix
|
||
|
|
|
||
|
|
| Platform | CLI flag | Main directory | Skill directory | Agent directory | Hooks/extensions |
|
||
|
|
| --- | --- | --- | --- | --- | --- |
|
||
|
|
| Claude Code | `--claude` | `.claude/` | `.claude/skills/` | `.claude/agents/` | `.claude/hooks/` + `.claude/settings.json` |
|
||
|
|
| Cursor | `--cursor` | `.cursor/` | `.cursor/skills/` | `.cursor/agents/` | `.cursor/hooks.json` + `.cursor/hooks/` |
|
||
|
|
| OpenCode | `--opencode` | `.opencode/` | `.opencode/skills/` | `.opencode/agents/` | `.opencode/plugins/` |
|
||
|
|
| Codex | `--codex` | `.codex/` | `.agents/skills/` | `.codex/agents/` | `.codex/hooks/` + `.codex/hooks.json` |
|
||
|
|
| Kilo | `--kilo` | `.kilocode/` | `.kilocode/skills/` | Usually none | `.kilocode/workflows/` |
|
||
|
|
| Kiro | `--kiro` | `.kiro/` | `.kiro/skills/` | `.kiro/agents/` | `.kiro/hooks/` |
|
||
|
|
| Gemini CLI | `--gemini` | `.gemini/` | `.agents/skills/` | `.gemini/agents/` | `.gemini/settings.json` + `.gemini/hooks/` |
|
||
|
|
| Antigravity | `--antigravity` | `.agent/` | `.agent/skills/` | Usually none | `.agent/workflows/` |
|
||
|
|
| Windsurf | `--windsurf` | `.windsurf/` | `.windsurf/skills/` | Usually none | `.windsurf/workflows/` |
|
||
|
|
| Qoder | `--qoder` | `.qoder/` | `.qoder/skills/` | `.qoder/agents/` | `.qoder/hooks/` + `.qoder/settings.json` |
|
||
|
|
| CodeBuddy | `--codebuddy` | `.codebuddy/` | `.codebuddy/skills/` | `.codebuddy/agents/` | `.codebuddy/hooks/` + `.codebuddy/settings.json` |
|
||
|
|
| GitHub Copilot | `--copilot` | `.github/` | `.github/skills/` | `.github/agents/` | `.github/copilot/hooks/` + prompts |
|
||
|
|
| Factory Droid | `--droid` | `.factory/` | `.factory/skills/` | `.factory/droids/` | `.factory/hooks/` + settings |
|
||
|
|
| Pi Agent | `--pi` | `.pi/` | `.pi/skills/` | `.pi/agents/` | `.pi/extensions/trellis/` + `.pi/settings.json` |
|
||
|
|
|
||
|
|
## Capability Groups
|
||
|
|
|
||
|
|
### Trellis Sub-Agent Support
|
||
|
|
|
||
|
|
These platforms usually have `trellis-research`, `trellis-implement`, and `trellis-check` files:
|
||
|
|
|
||
|
|
- Claude Code
|
||
|
|
- Cursor
|
||
|
|
- OpenCode
|
||
|
|
- Codex
|
||
|
|
- Kiro
|
||
|
|
- Gemini CLI
|
||
|
|
- Qoder
|
||
|
|
- CodeBuddy
|
||
|
|
- GitHub Copilot
|
||
|
|
- Factory Droid
|
||
|
|
- Pi Agent
|
||
|
|
|
||
|
|
When changing implementation/check/research behavior, look for the corresponding platform agent files first.
|
||
|
|
|
||
|
|
### Main-Session Workflow Platforms
|
||
|
|
|
||
|
|
These platforms rely more on workflows/skills to guide the main session:
|
||
|
|
|
||
|
|
- Kilo
|
||
|
|
- Antigravity
|
||
|
|
- Windsurf
|
||
|
|
|
||
|
|
When changing behavior, inspect workflows and skills first. Do not assume Trellis sub-agents exist.
|
||
|
|
|
||
|
|
### Shared `.agents/skills/`
|
||
|
|
|
||
|
|
Codex writes the shared `.agents/skills/` layer. Some tools that support agentskills.io can also read this directory. If the user wants multiple compatible tools to share one skill, consider `.agents/skills/` first, but do not assume every platform reads it.
|
||
|
|
|
||
|
|
## Decision Rules When Modifying Platform Files
|
||
|
|
|
||
|
|
1. User specified a platform: modify only that platform directory unless shared workflow/spec files must also change.
|
||
|
|
2. User says "all platforms should do this": synchronize equivalent entry points platform by platform; do not modify only one directory.
|
||
|
|
3. User only says "my AI": inspect the configuration directories that actually exist in the project and infer the current AI platform.
|
||
|
|
4. User wants project rules: prefer `.trellis/spec/` or a project-local skill.
|
||
|
|
5. User wants Trellis behavior: edit `.trellis/workflow.md` plus platform hooks/agents/skills/commands.
|
||
|
|
|
||
|
|
## When Paths Differ
|
||
|
|
|
||
|
|
Platform ecosystems change, and user projects may already be customized. If this table disagrees with local files, use the actual settings/config in the user project as authoritative:
|
||
|
|
|
||
|
|
- Check the hook that settings registers.
|
||
|
|
- Check the script that a command/prompt/workflow points to.
|
||
|
|
- Judge behavior by the read rules currently written in the agent file.
|
||
|
|
|
||
|
|
Do not delete a custom file just because it is not listed in this path table.
|