Documentation
Everything you need to know about Trinity — from your first project to advanced configuration.
Get startedGetting Started
Welcome
Core concepts — Projects, PRDs, Stories, the Agent Pipeline, and Knowledge Base.
Prerequisites
Git, GitHub CLI, Node.js, and Claude Code — what to install and how to configure it.
First Project
Step-by-step guide from launch to your first shipped PR.
Navigating
UI layout, sidebar navigation, project switcher, and keyboard shortcuts.
Project Setup
Onboarding Wizard
9-step wizard: Explore, Clarify, Phasing, Design, Structure, Review, Ready, Setup, Skills.
Import Existing
6-step import flow: Scan, Review, Secrets, Docs, Skills, Save.
Project Settings
Branching, merge strategy, execution gates, Docker, and per-repo overrides.
Project Assets
Upload wireframes, specs, and brand guides with AI-generated descriptions.
Planning
Dashboard
PRD management, progress tracking, phase overview, and blocked story visibility.
PRD Planning
4-phase AI pipeline: Architect, Story Writer, Dependency Mapper, Calibrator.
Architect
AI-powered architecture analysis — stack decisions, trade-offs, and design recommendations.
Align
Phase-adaptive project health checks — roadmap quality pre-PRD, execution health post-PRD.
Dependency Graph
Visual dependency graph with layout management and cross-PRD views.
Execution
Stories
Story structure, status lifecycle, acceptance criteria, tags, and linking.
Running
Workers, the 4-agent pipeline, git worktrees, monitoring, and retries.
Gates
8 human checkpoints: deviation approval, missing assets, blocked stories, and more.
Releases
Group PRDs into shippable units with semver tagging, dependency DAGs, and release branches.
Checkpoints
Quality and release checkpoints with per-repo semver tagging.
Knowledge & Insights
Knowledge Base
Project vault with books, chapters, and pages. Agents write learnings after every run.
Gotchas
Framework-specific pitfall libraries consulted by agents to avoid known issues.
Recaps & Reports
Daily, weekly, monthly summaries with PDF export for stakeholders.
Metrics
Success rate, cost per story, cycle time, pipeline funnel, and worker health.
Audit Tracking
Link stories to audit findings. Auto-check addressed items after merge.