@sandrinio/vbounce 1.4.0 → 1.6.0

package/templates/sprint_report.md

@@ -25,6 +25,7 @@ sprint_id: "S-{XX}"
 sprint_goal: "{One-sentence North Star}"
 dates: "{MM/DD - MM/DD}"
 status: "Achieved / Partially Achieved / Failed"
+total_tokens_used: {N}
 delivery_ref: "D-{NN}_{release_name}"
 delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 ---
@@ -50,12 +51,12 @@ delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 ### Not Completed
 > Stories that were planned but didn't make it (escalated, deferred, or partially done).
 
-- {e.g., "STORY-001-03: Email notifications — Escalated (template integration failed 3x)"}
+- {e.g., "STORY-001-03-email_notifications — Escalated (template integration failed 3x)"}
 
 ### Product Docs Affected
 > Any product documentation files modified, created, or identified for updates. Handed off to Scribe agent.
 
-- {e.g., "product_documentation/api_reference.md — Added rate limiting details"}
+- {e.g., "vdocs/api_reference.md — Added rate limiting details"}
 
 ---
 
@@ -63,13 +64,13 @@ delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 
 | Story | Epic | Label | Final State | Bounces (QA) | Bounces (Arch) | Correction Tax |
 |-------|------|-------|-------------|--------------|----------------|----------------|
-| STORY-{ID}: {name} | EPIC-{ID} | L{N} | Done / Escalated / Parking Lot | {N} | {N} | {X}% |
+| STORY-{ID}-{story_name} | EPIC-{ID} | L{N} | Done / Escalated / Parking Lot | {N} | {N} | {X}% |
 
 ### Story Highlights
-- **{STORY-ID}**: {1-sentence summary of what was built and any notable decisions}
+- **STORY-{ID}-{story_name}**: {1-sentence summary of what was built and notable decisions}
 
 ### Escalated Stories (if any)
-- **{STORY-ID}**: Escalated after {N} bounces. Root cause: {why}. Recommendation: {rewrite spec / descope / kill}.
+- **STORY-{ID}-{story_name}**: Escalated after {N} bounces. Root cause: {why}. Recommendation: {rewrite spec / descope / kill}.
 
 ---
 
@@ -104,13 +105,13 @@ delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 
 | Story | Tokens | Duration | Agent Sessions | Bounces | Cost |
 |-------|--------|----------|----------------|---------|------|
-| STORY-{ID} | {N} | {Xh Ym} | {N} | {N} | ${X.XX} |
+| STORY-{ID}-{story_name} | {N} | {Xh Ym} | {N} | {N} | ${X.XX} |
 
 ### Threshold Alerts
 > Flag any metrics that crossed warning or critical thresholds. If none, write "No threshold alerts."
 
-- {e.g., "STORY-001-05: Correction Tax 10% (🟡) — root cause: test architecture rework due to ESM timer conflict"}
-- {e.g., "STORY-002-03: 2 QA bounces — spec ambiguity in edge case handling"}
+- {e.g., "STORY-001-05-test_arch: Correction Tax 10% (🟡) — root cause: test architecture rework due to ESM timer conflict"}
+- {e.g., "STORY-002-03-edge_cases: 2 QA bounces — spec ambiguity in edge case handling"}
 
 ---
 
@@ -120,7 +121,7 @@ delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 
 | Source | Lesson | Approved? |
 |--------|--------|-----------|
-| STORY-{ID} Dev Report | {What happened and proposed rule} | Pending / Yes / No |
+| STORY-{ID}-{story_name} Dev Report | {What happened and proposed rule} | Pending / Yes / No |
 
 ---
 
@@ -135,17 +136,55 @@ delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 ### What Didn't Go Well
 > Problems encountered, root causes, and impact on the sprint.
 
-- {e.g., "STORY-001-03 escalated because the spec was ambiguous — 3 QA bounces wasted"}
-- {e.g., "Merge conflict on STORY-002-01 required a fix story — cost an extra half-day"}
+- {e.g., "STORY-001-03-api_spec escalated because the spec was ambiguous — 3 QA bounces wasted"}
+- {e.g., "Merge conflict on STORY-002-01-database required a fix story — cost an extra half-day"}
 
-### Process Improvements
-> Changes to the V-Bounce delivery process itself — not just this project, but how we work.
+### Framework Self-Assessment
+> Aggregated from agent Process Feedback sections. Categorized by area of the V-Bounce framework.
+> Severity: **Friction** (slowed work) or **Blocker** (required workaround).
+> These feed the `improve` skill for framework evolution.
 
-- {e.g., "Story specs for L3+ stories should require Architect pre-review before bouncing"}
-- {e.g., "QA found the same import ordering issue in 3 stories — add linting rule to Dev setup, not just LESSONS.md"}
-- {e.g., "L3 stories consumed 4x the tokens of L2s — add a complexity budget to sprint planning"}
-- {e.g., "First-pass success rate was 40% — require Ambiguity 🟢 on all stories, not just Context Pack checks"}
-- {e.g., "Sprint Integration Audit (Step 6) found no issues in 3 consecutive sprints — consider making it conditional for small sprints"}
+#### Templates
+> Template sections that were confusing, incomplete, had unused fields, or were missing critical information.
+
+| Finding | Source Agent | Severity | Suggested Fix |
+|---------|-------------|----------|---------------|
+| {e.g., "Story §3 missing 'existing modules to reuse' field"} | Developer | Friction | {Add a reuse checklist to the story template} |
+
+#### Agent Handoffs
+> Information that was missing, redundant, or unclear when passed between agents via reports.
+
+| Finding | Source Agent | Severity | Suggested Fix |
+|---------|-------------|----------|---------------|
+| {e.g., "Dev report didn't specify test runner — QA had to discover it"} | QA | Friction | {Add 'test_runner' to Dev report YAML frontmatter} |
+
+#### RAG Pipeline
+> Context quality issues — irrelevant results, missing critical context, stale embeddings.
+
+| Finding | Source Agent | Severity | Suggested Fix |
+|---------|-------------|----------|---------------|
+| {e.g., "Query for 'auth constraints' returned old sprint results"} | Developer | Friction | {Add date-weighted ranking to vbounce_ask.mjs} |
+
+#### Skills
+> Skill instructions that were unclear, had gaps, or could be improved for better agent performance.
+
+| Finding | Source Agent | Severity | Suggested Fix |
+|---------|-------------|----------|---------------|
+| {e.g., "vibe-code-review Deep Audit missing accessibility dimension"} | Architect | Friction | {Add dimension 7 to deep-audit.md} |
+
+#### Process Flow
+> Steps that were unnecessary, wrongly ordered, or missing for this type of work.
+
+| Finding | Source Agent | Severity | Suggested Fix |
+|---------|-------------|----------|---------------|
+| {e.g., "Fast Track stories still triggered Architect pass in the checklist"} | Team Lead | Blocker | {Update agent-team SKILL.md Step 4 skip logic} |
+
+#### Tooling & Scripts
+> Script failures, validation gaps, or automation opportunities.
+
+| Finding | Source Agent | Severity | Suggested Fix |
+|---------|-------------|----------|---------------|
+| {e.g., "validate_report.mjs doesn't check for Process Feedback section"} | Team Lead | Friction | {Add optional section validation} |
 
 ---
 

package/templates/story.md

@@ -12,8 +12,11 @@ Ambiguity Score:
 - 🟡 Medium: Logic clear, files TBD
 - 🟢 Low: Ready for coding
 
-Output location: `product_plans/{delivery}/EPIC-{NNN}_{epic_name}/STORY-{EpicID}-{StoryID}.md`
-(Stories live inside their parent Epic folder — a Story never exists without an Epic.)
+Output location (Draft/Refinement): `product_plans/backlog/EPIC-{NNN}_{epic_name}/STORY-{EpicID}-{StoryID}-{StoryName}.md`
+
+Sprint Lifecycle Rule:
+- When a sprint starts, this Story file is MOVED to `product_plans/sprints/sprint-{XX}/`.
+- When the sprint completes, this Story file is MOVED to `product_plans/archive/sprints/sprint-{XX}/`.
 
 Document Hierarchy Position: LEVEL 4 (Charter → Roadmap → Epic → **Story**)
 
@@ -39,7 +42,7 @@ Do NOT output these instructions.
 </instructions>
 
 ---
-story_id: "STORY-{EpicID}-{StoryID}"
+story_id: "STORY-{EpicID}-{StoryID}-{StoryName}"
 parent_epic_ref: "EPIC-{ID}"
 status: "Draft / Refinement / Probing/Spiking / Ready to Bounce / Bouncing / QA Passed / Architect Passed / Sprint Review / Done / Escalated / Parking Lot"
 ambiguity: "🔴 High / 🟡 Medium / 🟢 Low"