> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Appendix A: Key File Paths Quick Reference

## Appendix A: Key File Paths Quick Reference

> [!NOTE]
>
> 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/.runtime/sessions/<session-key>.json` | Active task for one AI session/window | Continue, hooks, sub-agent launch |

### Shipped commands (Claude Code)

| File | Invoked as |
| - | - |
| `.claude/commands/trellis/finish-work.md` | `/trellis:finish-work` |
| `.claude/commands/trellis/continue.md` | `/trellis:continue` |

On platforms where SessionStart is automatic, `start` is not installed as a user-facing command. Agent-less platforms still ship a manual start workflow.

### 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 |

### Other platforms

Each platform writes into its own directory (see chapter 13 for the full layout):

* `.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/skills/`, `.codex/agents/` (TOML), `.codex/hooks/`, `AGENTS.md`
* `.kiro/steering/`, `.kiro/prompts/`, `.kiro/skills/`, `.kiro/agents/`
* `.gemini/commands/trellis/` (TOML), `.gemini/agents/`, `.gemini/hooks/`
* `.qoder/commands/`, `.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/`
* `.pi/prompts/`, `.pi/agents/`, `.pi/extensions/trellis/`, `.pi/settings.json`
* `.kilocode/workflows/`, `.kilocode/skills/`
* `.agent/workflows/`, `.agent/skills/` (Antigravity)
* `.devin/workflows/`, `.devin/skills/`
* `.agents/skills/` (shared cross-platform layer)

### 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 |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.