@sandrinio/vbounce 1.0.0 → 1.3.0

package/templates/delivery_plan.md

@@ -10,6 +10,7 @@ FOLLOW THIS EXACT STRUCTURE. Output sections in order 1-7.
 6b. **§5b Open Questions**: Operational questions that may block active sprint stories
 7. **§6 Completed Sprints**: ONE-LINE summaries of finished sprints (full detail in version history)
 8. **§7 Change Log**: Auto-appended on updates
+9. **§8 Applied Hotfixes**: Ledger of L1 Trivial fixes that bypassed Epic/Story hierarchy (auto-appended by `hotfix_manager.sh ledger`)
 
 Sprint Lifecycle:
 - When a sprint completes: update Sprint Registry row to "Completed",
@@ -186,3 +187,13 @@ DO NOT manually edit the table rows - they are managed by the system.
 | Date | Change | By |
 |------|--------|-----|
 | {YYYY-MM-DD} | Initial creation from Roadmap | Architect |
+
+---
+
+## 8. Applied Hotfixes
+
+> L1 Trivial fixes that bypassed the Epic/Story hierarchy. Auto-appended by `hotfix_manager.sh ledger`.
+
+| Date | Title | Brief Description |
+|------|-------|-------------------|
+| — | — | No hotfixes applied yet |

package/templates/hotfix.md

@@ -47,6 +47,8 @@ Do NOT output these instructions.
 - **Files to Modify**: `{filepath}`
 - **Instructions**: {e.g., "Change the padding-left from 10px to 20px" or "Fix the typo in the error message."}
 
+> **CONSTRAINT**: If this fix requires modifying more than 2 files, STOP immediately and escalate to the Team Lead. The task must be promoted to an Epic/Story.
+
 ---
 
 ## 3. Verification
@@ -54,4 +56,5 @@ Do NOT output these instructions.
 
 - [ ] {Simple step, e.g., "Open the settings modal and verify the button is aligned."}
 - [ ] Automated tests still pass (`npm test`).
+- [ ] **Framework Integrity**: If `brains/` or `skills/` were modified, log to `brains/CHANGELOG.md` and run `./scripts/pre_bounce_sync.sh`.
 - [ ] **Post-Fix Action**: Run `./scripts/hotfix_manager.sh ledger "HOTFIX: {Name}" "{Brief Fix Description}"`

package/templates/sprint_report.md

@@ -97,7 +97,7 @@ Do NOT output these instructions.
 | **Total QA Bounces** | {N} | across all stories |
 | **Total Architect Bounces** | {N} | across all stories |
 | **Bounce Ratio** | {X}% | (total bounces / total stories) |
-| **Average Correction Tax** | {X}% | (0% = autonomous, 100% = human rewrote everything) |
+| **Average Correction Tax** | {X}% | 🟢 0-5% · 🟡 6-15% · 🔴 16%+ requires process review |
 | **First-Pass Success Rate** | {X}% | stories that passed QA on first try |
 | **Merge Conflicts** | {N} simple, {N} complex | |
 
@@ -107,6 +107,12 @@ Do NOT output these instructions.
 |-------|--------|----------|----------------|---------|------|
 | STORY-{ID} | {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"}
+
 ---
 
 ## 4. Lessons Learned

package/templates/story.md

@@ -148,3 +148,4 @@ POST /api/resource
 - [ ] LESSONS.md consulted before implementation.
 - [ ] No violations of Roadmap ADRs.
 - [ ] Documentation (API/Tech Stack) updated.
+- [ ] **Framework Integrity**: If `brains/` or `skills/` were modified, log to `brains/CHANGELOG.md` and run `./scripts/pre_bounce_sync.sh`.