Example Session: Content Creation¶

Profile: content-creation Scenario: Extract pattern from production code, create documentation Duration: ~3 hours

Session Flow¶

1. Research Phase (45 min)¶

Text Only

User: /research "authentication patterns in our codebase"

Skills loaded: research

Actions: - Scan codebase for auth implementations - Trace git history for evolution - Find existing documentation - Identify common patterns

Findings: - 3 different auth approaches used - JWT most common (12 services) - OAuth for external integrations - API keys for internal services

2. Pattern Extraction (30 min)¶

Text Only

User: Extract the JWT auth pattern

Skills loaded: research, meta

Actions: - Identify core components - Document decision rationale - Capture variations - Note failure modes

Output: Pattern specification

3. Documentation Writing (60 min)¶

Text Only

User: Create documentation for this pattern

Skills loaded: documentation

Actions: - Write pattern overview - Create usage examples - Document configuration options - Add troubleshooting section

Outputs: 1. docs/patterns/jwt-authentication.md 2. docs/how-to/implement-jwt-auth.md 3. docs/reference/auth-api.md

4. Quality Review (20 min)¶

Text Only

User: Review docs for Diátaxis compliance

Skills loaded: documentation

Actions: - Check document placement - Verify content type matches location - Ensure cross-references work - Validate completeness

Feedback: Minor adjustments to how-to guide

5. Retrospective (25 min)¶

Text Only

User: /retro "pattern extraction session"

Skills loaded: meta

Actions: - Capture what worked - Document challenges - Extract reusable insights - Update institutional memory

Output: Retrospective in .agents/learnings/

Skills Used Summary¶

Skill	When	Purpose
research	Research, Extract	Find and analyze code
meta	Extract, Retro	Pattern synthesis, learning
documentation	Write, Review	Create and audit docs

Session Outcome¶

✅ Pattern extracted and documented
✅ 3 documentation files created
✅ Diátaxis compliant
✅ Retrospective captured

Time: ~3 hours (pattern now reusable for team)

Artifacts Created¶

Text Only

docs/
├── patterns/
│   └── jwt-authentication.md     # Pattern overview
├── how-to/
│   └── implement-jwt-auth.md     # Step-by-step guide
└── reference/
    └── auth-api.md               # API documentation

.agents/
├── research/
│   └── 2025-12-30-auth-patterns.md
├── patterns/
│   └── jwt-auth-pattern.md
└── retros/
    └── 2025-12-30-pattern-extraction.md