/titan

Output Formats

Purpose: Read this file when Titan must emit TITAN_COMPLETE, TITAN_PHASE_COMPLETE, TITAN_STATE, _STEP_COMPLETE:, or EVOLVE_TO_DISCOVER_HANDOFF.

Contents

• TITAN_COMPLETE
• TITAN_PHASE_COMPLETE
• TITAN_STATE
• Decision log linkage
• AUTORUN step output
• EVOLVE_TO_DISCOVER_HANDOFF

Templates for Titan's output artifacts.

TITAN_COMPLETE

Final delivery output when the entire product lifecycle is complete.

## TITAN_COMPLETE

### Product Summary
- **Goal**: [Original user goal, verbatim]
- **Scope**: [S/M/L/XL]
- **Phases Completed**: [N/Total]
- **Duration**: [Phases executed, with timestamps if available]

### SUCCESS_CRITERIA Evaluation
| Criteria | Target | Actual | Status |
|----------|--------|--------|--------|
| [Criteria 1] | [Target metric] | [Achieved metric] | ✅/❌ |

### Deliverables
| Category | Artifact | Location |
|----------|----------|----------|
| Code | [Feature/module name] | [File paths] |
| Tests | [Test suite name] | [File paths] |
| Docs | [Document name] | [File paths] |
| Config | [Config name] | [File paths] |

### Architecture Decisions Summary
| Decision | Choice | Risk Score | Rationale |
|----------|--------|------------|-----------|
| [DEC-001] | [Choice made] | [Score] | [Brief rationale] |

### Quality Metrics
- **Test coverage**: [N%]
- **Security audit**: PASS / FAIL (details: [summary])
- **Performance targets**: MET / UNMET (details: [summary])
- **Code quality gate**: PASS / FAIL

### Known Limitations
- [Limitation]: [Reason + mitigation]

### Recommended Next Steps (EVOLVE Phase)
1. [Action item with priority]

### Risk Log Summary
- **Total decisions logged**: [N]
- **High-risk decisions**: [N]
- **Final risk budget**: [N/100]
- **User escalations used**: [N/1]
- **Stall recoveries**: L1:[N] L2:[N] L3:[N] L4:[N]

TITAN_PHASE_COMPLETE

Output at each phase transition.

## TITAN_PHASE_COMPLETE: [PHASE_NAME]

### Phase Summary
- **Phase**: [Phase N of Total]
- **Epics completed**: [N/Total]
- **Agents deployed**: [Agent list]
- **Duration**: [Start → End]

### Key Decisions
| Decision | Choice | Risk |
|----------|--------|------|
| [DEC-NNN] | [Choice] | [Score] |

### Artifacts Produced
| Type | File | Description |
|------|------|-------------|
| [code/test/doc/config] | [path] | [what it is] |

### Exit Criteria Verification
| Criteria | Status | Notes |
|----------|--------|-------|
| [Criteria 1] | ✅/❌ | [Details if failed] |

### Velocity Report
- Epic completion rate: [N%]
- Stall count: [N]
- Rally usage: [N teams launched]

### Next Phase Preview
- **Phase**: [Next phase name]
- **Planned Epics**: [Count]
- **Key agents**: [Primary agents]
- **Expected challenges**: [Known risks]

TITAN_STATE

Persisted state format (written to .agents/titan-state.md).

## TITAN_STATE
- **Project**: [Project name]
- **Goal**: [Original user goal, verbatim]
- **Scope**: S / M / L / XL
- **Current Phase**: [Phase name]
- **Phase Progress**: [Current phase N / Total phases]
- **Epic Progress**: [Completed / Total in current phase]
- **Risk Budget**: [Cumulative score / 100]
- **Stall Budget**:
  - Tactical: [Used / Limit per phase] (Project: [Used / 10])
  - Operational: [Used / Limit per phase] (Project: [Used / 5])
  - Strategic: [Used / Limit per phase] (Project: [Used / 3])
- **SUCCESS_CRITERIA**:
  - [Criteria 1]: [Target] → [Current status]
- **Blockers**: [Current blockers or "None"]
- **Next Action**: [Specific next step]
- **Decision Log**: [Path to decision log file]
- **Last Updated**: [YYYY-MM-DD HH:MM]
- **Update Trigger**: [epic_complete | phase_transition | decision_recorded | antistall_activated | antistall_resolved | rally_start | rally_complete | magi_verdict | scope_change | session_boundary]

### Phase Status
| Phase | Status | Entry Date | Exit Date | Epics |
|-------|--------|------------|-----------|-------|
| DISCOVER | ✅/🔄/⏳/⏭️ | [date] | [date] | [N/N] |
| DEFINE | ... | ... | ... | ... |
| ARCHITECT | ... | ... | ... | ... |
| BUILD | ... | ... | ... | ... |
| HARDEN | ... | ... | ... | ... |
| VALIDATE | ... | ... | ... | ... |
| LAUNCH | ... | ... | ... | ... |
| GROW | ... | ... | ... | ... |
| EVOLVE | ... | ... | ... | ... |

### Current Roadmap
#### [Phase name] — [Status]
- [x] Epic 1: [Description]
- [ ] Epic 2: [Description] ← CURRENT
- [ ] Epic 3: [Description]

Decision Log

Decision Log format → reference/decision-matrix.md

AUTORUN Step Output

_STEP_COMPLETE.Output schema → reference/autorun-schema.md.

_AGENT_CONTEXT:
  Role: Titan
  Phase: [Current phase]
  Task: [Phase objective]
  State: [TITAN_STATE summary]

EVOLVE_TO_DISCOVER_HANDOFF

Structured handoff from EVOLVE phase back to DISCOVER for the next iteration cycle.

## EVOLVE_TO_DISCOVER_HANDOFF

### Iteration Summary
- **Iteration**: [N] → [N+1]
- **Duration**: [Start date → End date]
- **Overall Assessment**: [Summary of iteration outcomes]

### Updated Personas
| Persona | Changes | Evidence |
|---------|---------|----------|
| [Persona name] | [What changed about this persona] | [Feedback/data source] |

### Refined SUCCESS_CRITERIA
| Original Criteria | Actual Result | Revised Criteria | Rationale |
|------------------|---------------|-----------------|-----------|
| [Original target] | [What was achieved] | [Updated target for next iteration] | [Why adjusted] |

### Tech Debt Priorities
| Item | Severity | Effort | Priority |
|------|----------|--------|----------|
| [Tech debt item] | [High/Medium/Low] | [S/M/L] | [P0/P1/P2] |

### Feature Backlog
| Feature | Source | Priority | Estimated Scope Impact |
|---------|--------|----------|----------------------|
| [Feature from feedback] | [Voice/Pulse/Growth] | [P0/P1/P2] | [S/M/L adjustment] |

### Iteration Learnings
- **What worked**: [Effective patterns, agents, approaches]
- **What didn't**: [Ineffective approaches, stalls, issues]
- **Process improvements**: [Recommendations for next cycle]
- **Agent performance**: [Notable agent effectiveness observations]