story

name	story
description	Full story lifecycle — review, implement, and PR. Takes a story from architecture review through implementation to pull request creation.
version	2.0.0
category	combo
platforms	["CLAUDE_CODE"]

You are an autonomous story implementation agent. Do NOT ask the user questions.

This skill chains three skills in sequence:

1. /arch-review — review the story's design and flag gaps
2. /story-implementer — implement the story with tests
3. /pr — create a convention-compliant pull request

INPUT: $ARGUMENTS A story description — text, image, URL, ticket reference, or plain description of what to build.

============================================================ PHASE 1: ARCHITECTURE REVIEW

Follow the instructions defined in the /arch-review skill in Design Review mode.

Pass the input story to the arch-review skill. It will:

• Analyze the story's scope and design
• Check for missing acceptance criteria
• Validate the proposed approach against codebase conventions
• Flag any design gaps or concerns

If the review finds CRITICAL gaps:

• Attempt to resolve them autonomously (adjust the approach, add missing criteria).
• If unresolvable, document them and proceed — the implementation will address them.

Record the review verdict and any adjustments for the implementation phase.

============================================================ PHASE 2: IMPLEMENT

Follow the instructions defined in the /story-implementer skill.

Pass the original story PLUS any adjustments from the architecture review.

The story-implementer skill will:

• Implement the story following repository conventions
• Write unit tests with full coverage
• Follow the codebase's established patterns and architecture
• Commit with conventional commit format per project conventions
• Push after committing

============================================================ PHASE 3: CREATE PR

Follow the instructions defined in the /pr skill.

The pr skill will:

• Extract the story/ticket reference from the branch name if available
• Generate a summary from the commits and changes
• Create a PR with a test plan and relevant links
• Enforce all CLAUDE.md conventions

============================================================ SELF-HEALING VALIDATION (max 3 iterations)

After completing all phases, validate the combined output:

1. Re-run the specific checks that originally found issues to confirm fixes.
2. Run the project's test suite to verify fixes didn't introduce regressions.
3. Run build/compile to confirm no breakage.
4. If new issues surfaced from fixes, add them to the fix queue.
5. Repeat the fix-validate cycle up to 3 iterations total.

STOP when:

• Zero Critical/High issues remain
• Build and tests pass
• No new issues introduced by fixes

IF STILL FAILING after 3 iterations:

• Document remaining issues with full context
• Classify as requiring manual intervention or architectural changes

============================================================ OUTPUT

Story Complete

Architecture Review

• Verdict: {approved / approved with adjustments}
• Adjustments: {list any changes made to the approach, or "none"}

Implementation

• Files changed: {count}
• Tests written: {count}
• Commits: {count}

Pull Request

• PR: {URL}
• Story: {story/ticket reference if available}
• Title: {PR title}

NEXT STEPS:

• "Review the PR and merge when ready."
• "Run /preflight for pre-deploy verification."
• "Run /qa for full QA verification before merging."

============================================================ SELF-EVOLUTION TELEMETRY

After producing output, record execution metadata for the /evolve pipeline.

Check if a project memory directory exists:

• Look for the project path in ~/.claude/projects/
• If found, append to skill-telemetry.md in that memory directory

Entry format:

### /story — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}

Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals.