What problem does it solve?
Provides a single authoritative reference for the vanilla Mindfold Trellis system so teams can understand its architecture, lifecycle hooks, agent pipeline, and multi-session worktree model without accidentally introducing project-specific changes into the canonical documentation.
Core Features & Use Cases
- Architecture & Design: Detailed system layers (skills, hooks, persistence) and diagrams to explain how Trellis orchestrates AI agents and file-based context.
- Hooks & Context Injection: Explanations of SessionStart, PreToolUse, and SubagentStop hooks and how they inject specs and enforce the Ralph Loop verification.
- Agents & Pipelines: Agent definitions, allowed tools, JSONL context patterns, and multi-agent vs multi-session workflows for dispatch, implement, check, debug, research, and plan agents.
- Multi-Session / Worktrees: Guidance and scripts for creating isolated git worktrees, starting sessions, monitoring, and creating PRs.
- Customization & Upgrade Protocols: How-to guides for adding commands, agents, specs, and hooks plus a self-iteration protocol that mandates project-local documentation in trellis-local.
- Use Cases: Onboarding new contributors, adding a custom agent, modifying hook behavior safely, or upgrading Trellis while preserving project customizations.
Quick Start
Read this trellis-meta skill to learn the canonical Trellis design and then create a project-local .claude/skills/trellis-local/SKILL.md to record any project-specific changes before modifying hooks, agents, or specs.