Skip to main content

​
Appendix A: Key File Paths Quick Reference

​
Core Documents

FileDescriptionWhen Read
.trellis/workflow.mdDevelopment workflow guideEvery session start
.trellis/worktree.yamlMulti-Agent worktree configDuring parallel development
.trellis/.versionCurrent Trellis versionDuring updates

​
Command Definitions

FileCommand
.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

FileAgentRole
.claude/agents/dispatch.mdDispatchPure orchestrator
.claude/agents/plan.mdPlanRequirements assessment
.claude/agents/implement.mdImplementCode implementation
.claude/agents/check.mdCheckQuality checking
.claude/agents/debug.mdDebugBug fixing
.claude/agents/research.mdResearchInformation search (read-only)

​
Hook Scripts

FileTrigger TimingFunction
.claude/hooks/session-start.pySessionStartAuto-inject context
.claude/hooks/inject-subagent-context.pyPreToolUse (Task)Spec injection engine
.claude/hooks/ralph-loop.pySubagentStop (check)Quality control loop

​
Cursor Command Definitions

FileCommand
.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

​
OpenCode Configuration

FileDescription
.opencode/commands/trellis/*.mdSlash commands — 12 commands generated by Trellis
.opencode/agents/*.mdSub-agents (implement.md, research.md, check.md)
.agents/skills/*/SKILL.mdShared Agent Skills layer (also read by Codex and other agentskills.io-compatible agents)

​
Codex Configuration

FileDescription
AGENTS.mdEntry file, auto-loaded by Codex each session
.agents/skills/*/SKILL.mdShared Agent Skills (also used by OpenCode / Kimi CLI / Amp / Cline)
.codex/config.tomlProject-scoped Codex configuration
.codex/agents/*.tomlCustom Codex agents (implement.toml, research.toml, check.toml)
.codex/skills/parallel/SKILL.mdCodex-specific skill for multi-agent pipelines
.codex/hooks/session-start.pySessionStart hook (requires codex_hooks = true in ~/.codex/config.toml)
.codex/hooks.jsonHooks configuration

​
iFlow Configuration

FileDescription
.iflow/commands/trellis/*.mdSlash commands — 13 commands generated by Trellis
.iflow/hooks/session-start.pySessionStart hook (shares Python hook script with Claude Code)
.iflow/hooks.jsonHooks configuration
.iflow/settings.jsonProject-scoped iFlow configuration

​
Gemini CLI Configuration

FileDescription
.gemini/commands/trellis/*.tomlTOML command files — 13 commands generated by Trellis
.agents/skills/*/SKILL.mdShared Agent Skills layer (Gemini CLI reads agentskills.io standard path)

​
Kilo Code Configuration

FileDescription
.kilocode/workflows/*.mdWorkflow commands (equivalent to slash commands) — 13 workflows generated by Trellis

​
Kiro Configuration

FileDescription
.kiro/skills/*/SKILL.mdAgent Skills (YAML frontmatter + instructions) — 12 skills generated by Trellis

​
Qoder Configuration

FileDescription
.qoder/skills/*/SKILL.mdAgent Skills — 12 skills generated by Trellis (all workflows delivered as skills; .qoder/commands/ is left for your own custom commands)

​
GitHub Copilot Configuration

FileDescription
.github/copilot-instructions.mdAlways-loaded prelude (carries Trellis context into every chat)
.github/prompts/trellis-*.prompt.mdPer-command prompts (invoked via “Run Prompt” picker) — 13 prompts generated by Trellis

​
Windsurf Configuration

FileDescription
.windsurf/workflows/trellis-*.mdWorkflows — 13 workflows generated by Trellis
.windsurf/rules/trellis.mdAlways-on rule (carries Trellis prelude)

​
CodeBuddy Configuration

FileDescription
.codebuddy/commands/trellis/*.mdSlash commands — 12 commands generated by Trellis (invoked as /trellis:start, etc.)

​
Antigravity Configuration

FileDescription
.agent/workflows/*.mdWorkflow files — content adapted from the shared Codex skill source; invoked via Antigravity’s workflow picker

​
Factory Droid Configuration

FileDescription
.factory/commands/trellis/*.mdSlash commands — 13 commands generated by Trellis
.factory/agents/*.mdSub-agents (implement.md, research.md, check.md)
.factory/skills/*/SKILL.mdAuto-trigger skills
.factory/hooks/session-start.py + .factory/hooks.jsonSessionStart hook

​
Script Tools

ScriptFunction
.trellis/scripts/task.pyTask management (14 subcommands)
.trellis/scripts/get_context.pyGet session context
.trellis/scripts/get_developer.pyGet developer identity
.trellis/scripts/init_developer.pyInitialize developer
.trellis/scripts/add_session.pyRecord session
.trellis/scripts/create_bootstrap.pyFirst-time spec bootstrap
.trellis/scripts/multi_agent/plan.pyPlan phase script
.trellis/scripts/multi_agent/start.pyStart worktree Agent
.trellis/scripts/multi_agent/status.pyView status
.trellis/scripts/multi_agent/create_pr.pyCreate PR
.trellis/scripts/multi_agent/cleanup.pyClean up worktree