Appendix A: Key File Paths Quick Reference
This appendix uses Claude Code’s directory layout as the example (.claude/commands/, .claude/agents/, .claude/skills/, .claude/hooks/). See the “Other platforms” section below, or chapter 13 for the full per-platform layout.
Core files
| File | Description | Read on |
|---|
.trellis/workflow.md | Development workflow contract | Every session start |
.trellis/config.yaml | Packages, update.skip, task hooks | Init and updates |
.trellis/.version | Current Trellis version | Updates |
.trellis/.template-hashes.json | Template file hashes | Updates |
.trellis/.developer | Developer identity | Every session |
.trellis/.current-task | Pointer to the active task | Sub-agent launch |
Shipped commands (Claude Code)
| File | Invoked as |
|---|
.claude/commands/trellis/start.md | /trellis:start |
.claude/commands/trellis/finish-work.md | /trellis:finish-work |
.claude/commands/trellis/continue.md | /trellis:continue |
Shipped sub-agents (Claude Code)
| File | Sub-agent | Role |
|---|
.claude/agents/trellis-implement.md | trellis-implement | Writes code, no git commit |
.claude/agents/trellis-check.md | trellis-check | Verify + self-fix |
.claude/agents/trellis-research.md | trellis-research | Read-only codebase search |
Shipped skills (Claude Code)
| File | Skill | Triggers when… |
|---|
.claude/skills/trellis-brainstorm/SKILL.md | trellis-brainstorm | User describes a feature / bug / request |
.claude/skills/trellis-before-dev/SKILL.md | trellis-before-dev | About to write code in an active task |
.claude/skills/trellis-check/SKILL.md | trellis-check | Implementation finished |
.claude/skills/trellis-update-spec/SKILL.md | trellis-update-spec | Worth capturing a learning |
.claude/skills/trellis-break-loop/SKILL.md | trellis-break-loop | A tricky bug was just resolved |
Hook scripts (Claude Code)
| File | Trigger | Function |
|---|
.claude/hooks/session-start.py | SessionStart | Auto-inject context |
.claude/hooks/inject-workflow-state.py | UserPromptSubmit | Workflow-state breadcrumb |
.claude/hooks/inject-subagent-context.py | PreToolUse (Task) | Spec injection engine |
.cursor/commands/, .cursor/skills/, .cursor/agents/, .cursor/hooks/, .cursor/hooks.json, .cursor/rules/trellis.mdc.opencode/commands/trellis/, .opencode/agents/, .opencode/skills/, .opencode/plugins/.codex/prompts/, .codex/skills/, .codex/agents/ (TOML), .codex/hooks/, AGENTS.md.kiro/steering/, .kiro/prompts/, .kiro/skills/, .kiro/agents/.gemini/commands/trellis/ (TOML), .gemini/skills/, .gemini/agents/, .gemini/hooks/.qoder/rules/, .qoder/skills/, .qoder/agents/, .qoder/hooks/.codebuddy/commands/trellis/, .codebuddy/skills/, .codebuddy/agents/, .codebuddy/hooks/.factory/commands/trellis/, .factory/droids/, .factory/skills/, .factory/hooks/.github/copilot-instructions.md, .github/prompts/, .github/skills/, .github/agents/, .github/copilot/hooks/.kilocode/workflows/, .kilocode/skills/.agent/workflows/, .agent/skills/ (Antigravity).windsurf/workflows/, .windsurf/rules/.agents/skills/ (shared cross-platform layer, written by Codex configurator)
Scripts
| Script | Function |
|---|
.trellis/scripts/task.py | Task management |
.trellis/scripts/get_context.py | Session context |
.trellis/scripts/add_session.py | Record session |
.trellis/scripts/create_bootstrap.py | First-time spec bootstrap |
.trellis/scripts/get_developer.py | Developer identity utility |
.trellis/scripts/init_developer.py | Developer initialization |
