/story

IPAD Project Story

User Input

$ARGUMENTS

Instructions

Note: The IPAD Kit Project Context hook has already detected all projects, artifacts, and external documents. Use that context below.

Prerequisites

This command requires at least 3 IPAD artifacts for a meaningful narrative. If fewer than 3 are present, inform the user and suggest generating more artifacts first.

Template Override

Check for a custom template in this order:

1. .ipad/templates/story-template.md (project-level override)
2. ${CLAUDE_PLUGIN_ROOT}/templates/story-template.md (plugin default)

If neither exists, generate using the structure defined in these instructions.

Step 1: Identify Project and Read All Artifacts Chronologically

1. Parse the project ID from $ARGUMENTS (e.g., 001).
2. Locate the project directory matching projects/{NNN}-*/.
3. Read ALL IPAD artifacts, sorted by generation date (from footer metadata or file modification date).
4. For each artifact extract: document ID, type, version, date, key findings, decisions, recommendations, cross-references, and quantitative metrics.
5. Read external documents in projects/000-global/external/ and projects/{PROJECT_DIR}/external/ for strategic context.

Step 2: Read Reference Data

1. Maturity Model: ${CLAUDE_PLUGIN_ROOT}/references/framework/maturity-model/overview.md — journey context.
2. Principles: ${CLAUDE_PLUGIN_ROOT}/references/principles.md — governance achievement context.
3. Glossary: ${CLAUDE_PLUGIN_ROOT}/references/glossary.md — consistent terminology.

Step 3: Reconstruct Project Timeline

Map artifacts to implementation phases:

1. Discovery: Assessment, stakeholder mapping, benchmarking
2. Analysis: Gap analysis, entity modelling, data architecture
3. Strategy: Roadmap, business case, investment funnel
4. Design: Governance, data quality, contracts, security
5. Reporting: Review, traceability, compliance, executive report

Note which phases are complete, in progress, or not started.

Step 4: Generate Project Narrative

Document Header

Field	Value
Document ID	IPAD-{PROJECT_ID}-STRY-v1.0
Project	{PROJECT_NAME}
Journey Start	{EARLIEST_ARTIFACT_DATE}
Current Phase	{CURRENT_PHASE}
Artifacts Produced	{COUNT}
Date	{DATE}
Status	Draft

Output Sections

1. Project Timeline — Chronological table: Date | Artifact | Milestone | Significance. Include a Mermaid timeline diagram showing phases and key milestones.
2. Key Decisions — Significant architecture and governance decisions extracted from artifacts. For each: Decision, Context, Rationale, Impact, Source artifact.
3. Milestone Achievements — Per completed phase: deliverables produced, value provided, how they build on previous work. Written as narrative, not just lists.
4. Challenges and Resolutions — From gap analysis, roadmap risks, compliance issues, review findings. For each: challenge description, resolution (or open status), documenting artifact.
5. Governance Achievements — Principles compliance score (PCMP), quality coverage (DQAL), governance roles (GOVR), traceability coverage (TRAC), review score (REVW). Before/after comparisons where possible.
6. Stakeholder Impact — From STKE if available: engagement per group, value delivered, anticipated benefits. If absent, derive from assessment and roadmap context.
7. Lessons Learned — What worked well, what to approach differently, recommendations for peer IPAs, process improvements.
8. Next Steps — Artifacts to generate next (with /ipad-kit: commands), upcoming roadmap milestones, dependencies to resolve, timeline expectations.
9. Metrics and Evidence — Quantitative table: Metric | Value | Source (maturity score, entities defined, quality rules, governance coverage, compliance %, artifact count).

Step 5: Write Output

Write to projects/{project-dir}/IPAD-{PROJECT_ID}-STRY-v1.0.md. If a previous version exists, increment the version number.

IMPORTANT — Auto-Populate Document Information Fields:

• Document ID: IPAD-{PROJECT_ID}-STRY-v{VERSION}
• Date: Current date (YYYY-MM-DD)
• Project: From project directory name
• Journey Start: Earliest artifact date
• Current Phase: Determined from artifact inventory
• Artifacts Produced: Total count
• Status: Draft

Generation Metadata Footer:

---
**Generated by**: IPAD Kit `/ipad-kit:story` command
**Generated on**: {DATE}
**IPAD Kit Version**: {IPAD_KIT_VERSION}
**Project**: {PROJECT_NAME} (Project {PROJECT_ID})
**Source Artifacts**: {LIST_OF_ALL_ARTIFACT_IDS}
**Reference Data**: maturity-model/overview.md, principles.md, glossary.md