Recaps & Reports
Recaps are lazily-built activity summaries that help you track what Trinity has accomplished. Reports export this data as formatted PDFs.
Accessing Recaps
Click Recaps in the sidebar's Project section.
Recap Types
Trinity generates recaps at seven granularities:
Daily
What happened today — stories completed, gates resolved, issues encountered, knowledge added. These are the building blocks every higher-level recap aggregates.
Daily recaps are updated by Trinity's post-merge hook — fire-and-forget after each story merges. The hook also handles roadmap progress updates, audit checklist re-checks, and vault learnings in the same pass.
Weekly
Aggregated from daily recaps. Shows the week's progress, patterns, and notable events.
Monthly
Aggregated from weekly recaps. Broader trends and milestone progress.
Quarterly
Aggregated from monthly recaps. Strategic-level progress and trajectory.
Yearly
Aggregated from quarterly recaps. Full-year overview.
Complete
The entire project history in one summary, built from all available recaps.
PRD
Per-PRD summaries — what was planned, what was built, what's left. These use the date column to store the PRD ID rather than a date.
How Recaps Build
Recaps follow a hierarchical build model:
daily → weekly → monthly → quarterly → yearly → complete
Each level aggregates its children in parallel and caches the result. Once built, a recap is stored in the sync DB and doesn't rebuild unless you trigger it.
Lazy Building
Recaps are built on demand — the first time you navigate to a period that hasn't been summarized yet, Trinity generates the recap. Subsequent visits read the cached copy instantly.
Triggering Rebuilds
To force a rebuild (e.g., after manual story changes or if you suspect the cached recap is stale):
- Click the Rebuild button on the recap view
- Trinity regenerates the recap from its source data and invalidates downstream aggregates (rebuilding a daily recap also invalidates the surrounding weekly / monthly / etc.)
Reading Recaps
Each recap includes:
- Summary — narrative overview of the period
- Stories — what was completed, failed, or is in progress
- Gates — decisions made at execution gates
- Knowledge — what was added to the vault
- Issues — problems encountered and how they were handled
Searching Recaps
Use the search feature to find specific information across all recaps:
- Navigate to Recaps
- Click the search icon
- Type your query (e.g., "authentication issues" or "what was the login bug")
Search is agentic — a micro-tier AI triages your query, reads the relevant recaps directly, and synthesizes an answer with citations back to the source recaps.
Smart Picker
The recap picker helps you find available recaps:
- Shows which periods have recaps available
- Filters by type (daily, weekly, monthly, etc.)
- Navigate forward/backward through time periods
Reports
Reports export recap data as formatted PDF documents.
Accessing Reports
- Navigate to Recaps
- Click the Reports button
- Choose your options
- Click Download
Report Types
Executive Report
High-level progress for managers and stakeholders:
- Project status overview
- Milestone progress
- Key decisions and changes
- Risk summary
Technical Report
Developer-focused with implementation details:
- Story completion tables
- Git activity summary
- AI usage statistics
- Pipeline performance metrics
Report Periods
You can generate reports for any recap period:
- Daily, weekly, monthly, quarterly, yearly
- The report pulls data from the corresponding recap
PDF Format
Reports are generated as A4 PDFs with:
- Professional formatting
- Charts and tables
- Proper headers and footers
- Print-ready layout
Tips
- Check daily recaps — they're the most actionable, showing exactly what happened each day
- Use weekly for standup prep — weekly recaps are great for summarizing progress to your team
- Export executive reports for stakeholders — they're designed for non-technical audiences
- Search before rebuilding — the search feature can often find what you need without regenerating recaps