zl-q
04b493ed09
- Remove legacy .opencode/ directory and configuration - Update .trellis/ to v0.5.0-rc.6 structure - Refactor scripts: modularize common/, remove multi_agent/ - Add new common modules: git.py, io.py, log.py, types.py, etc. - Update workflow.md and AGENTS.md - Archive completed migration tasks
3.9 KiB
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
- User specified a platform: modify only that platform directory unless shared workflow/spec files must also change.
- User says "all platforms should do this": synchronize equivalent entry points platform by platform; do not modify only one directory.
- User only says "my AI": inspect the configuration directories that actually exist in the project and infer the current AI platform.
- User wants project rules: prefer
.trellis/spec/or a project-local skill. - User wants Trellis behavior: edit
.trellis/workflow.mdplus 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.