---
name: code-story
description: Narrative templates for git history documentation. Used by /git:code-story command.
---

# Code Story Skill

Provides narrative templates for transforming git history into documentary-style stories.

## Templates

Read the appropriate template based on detail level:
- [resources/minimal-template.md](resources/minimal-template.md) - 1-2 page executive summary
- [resources/standard-template.md](resources/standard-template.md) - 5-10 page story with acts
- [resources/comprehensive-template.md](resources/comprehensive-template.md) - 20+ page deep dive

## Narrative Guidelines

### Voice and Tone
- Documentary style: informative yet engaging
- Third-person perspective
- Acknowledge the human element
- Find the drama in technical decisions
- Celebrate achievements without hyperbole

### What Makes a Good Code Story
- **Genesis moment**: First commit sets the stage
- **Character development**: Contributors evolve
- **Conflict and resolution**: Bugs, refactors, breaking changes
- **Turning points**: Direction-changing decisions
- **Present connection**: Link past to current state

### Commit Citation Format
- Short SHA in backticks: `abc1234`
- Include date and author for key commits
- Link to GitHub if remote is github.com