Appendix A: Key File Paths Quick Reference
Core Documents
| File | Description | When Read |
|---|---|---|
.trellis/workflow.md | Development workflow guide | Every session start |
.trellis/worktree.yaml | Multi-Agent worktree config | During parallel development |
.trellis/.version | Current Trellis version | During updates |
Command Definitions
| File | Command |
|---|---|
.claude/commands/trellis/start.md | /trellis:start |
.claude/commands/trellis/parallel.md | /trellis:parallel |
.claude/commands/trellis/before-dev.md | /trellis:before-dev |
.claude/commands/trellis/brainstorm.md | /trellis:brainstorm |
.claude/commands/trellis/check.md | /trellis:check |
.claude/commands/trellis/check-cross-layer.md | /trellis:check-cross-layer |
.claude/commands/trellis/finish-work.md | /trellis:finish-work |
.claude/commands/trellis/break-loop.md | /trellis:break-loop |
.claude/commands/trellis/create-command.md | /trellis:create-command |
.claude/commands/trellis/integrate-skill.md | /trellis:integrate-skill |
.claude/commands/trellis/onboard.md | /trellis:onboard |
.claude/commands/trellis/record-session.md | /trellis:record-session |
.claude/commands/trellis/update-spec.md | /trellis:update-spec |
Agent Definitions
| File | Agent | Role |
|---|---|---|
.claude/agents/dispatch.md | Dispatch | Pure orchestrator |
.claude/agents/plan.md | Plan | Requirements assessment |
.claude/agents/implement.md | Implement | Code implementation |
.claude/agents/check.md | Check | Quality checking |
.claude/agents/debug.md | Debug | Bug fixing |
.claude/agents/research.md | Research | Information search (read-only) |
Hook Scripts
| File | Trigger Timing | Function |
|---|---|---|
.claude/hooks/session-start.py | SessionStart | Auto-inject context |
.claude/hooks/inject-subagent-context.py | PreToolUse (Task) | Spec injection engine |
.claude/hooks/ralph-loop.py | SubagentStop (check) | Quality control loop |
Cursor Command Definitions
| File | Command |
|---|---|
.cursor/commands/trellis-start.md | /trellis-start |
.cursor/commands/trellis-before-dev.md | /trellis-before-dev |
.cursor/commands/trellis-brainstorm.md | /trellis-brainstorm |
.cursor/commands/trellis-check.md | /trellis-check |
.cursor/commands/trellis-check-cross-layer.md | /trellis-check-cross-layer |
.cursor/commands/trellis-finish-work.md | /trellis-finish-work |
.cursor/commands/trellis-break-loop.md | /trellis-break-loop |
.cursor/commands/trellis-create-command.md | /trellis-create-command |
.cursor/commands/trellis-integrate-skill.md | /trellis-integrate-skill |
.cursor/commands/trellis-onboard.md | /trellis-onboard |
.cursor/commands/trellis-record-session.md | /trellis-record-session |
.cursor/commands/trellis-update-spec.md | /trellis-update-spec |
Codex / OpenCode Configuration
| File | Description |
|---|---|
AGENTS.md | Entry file, provides base project context (generated for all platforms) |
.agents/skills/*/SKILL.md | Shared Agent Skills (13 skills) |
.codex/config.toml | Project-scoped Codex configuration |
.codex/agents/*.toml | Custom Codex agents (implement.toml, research.toml, check.toml) |
.codex/skills/parallel/SKILL.md | Codex-specific skill for multi-agent pipelines |
.codex/hooks/session-start.py | SessionStart hook (auto-injects context) |
.codex/hooks.json | Hooks configuration |
Kilo Code Configuration
| File | Description |
|---|---|
.kilocode/workflows/*.md | Workflow commands (equivalent to slash commands) — 13 workflows generated by Trellis |
Kiro Configuration
| File | Description |
|---|---|
.kiro/skills/*/SKILL.md | Agent Skills (YAML frontmatter + instructions) — 12 skills generated by Trellis |
Script Tools
| Script | Function |
|---|---|
.trellis/scripts/task.py | Task management (14 subcommands) |
.trellis/scripts/get-context.py | Get session context |
.trellis/scripts/get-developer.py | Get developer identity |
.trellis/scripts/init-developer.py | Initialize developer |
.trellis/scripts/add-session.py | Record session |
.trellis/scripts/multi-agent/plan.py | Plan phase script |
.trellis/scripts/multi-agent/start.py | Start worktree Agent |
.trellis/scripts/multi-agent/status.py | View status |
.trellis/scripts/multi-agent/create-pr.py | Create PR |
.trellis/scripts/multi-agent/cleanup.py | Clean up worktree |