shapeup-sdlc 1.6.2

package/skills/ba-pitch-analyzer/assets/templates/cross-context/migration-plan.tmpl.md

@@ -0,0 +1,104 @@
+---
+type: migration-plan
+feature: FEATURE_SLUG
+skill_version: "2.5"
+affected_tables: []
+change_type: additive | breaking | destructive
+backward_compatible: true | false
+tags: [cross-context, migration]
+depends_on: ["[[_cross-context/context-map]]"]
+status: draft
+---
+
+# Migration Plan: FEATURE TITLE
+
+> Generated only when feature modifies existing production schema.
+> Each migration task maps to a TASK-M0N in tasks/_index.md.
+
+---
+
+## Change Summary
+
+| Table | Change Type | Breaking | Rollback Window |
+|-------|------------|---------|----------------|
+| `table_name` | add column / rename / drop | ✅ yes / ❌ no | 48h |
+
+**Backward compatible:** YES / NO
+**Estimated rows affected:** ~N rows
+**Estimated migration time:** < Ns (no lock) / ~Ns (with lock)
+
+---
+
+## Migration Tasks
+
+### TASK-M01 — [description, e.g. Add nullable columns]
+
+```sql
+-- UP
+ALTER TABLE table_name ADD COLUMN col_name TYPE DEFAULT NULL;
+
+-- ROLLBACK
+ALTER TABLE table_name DROP COLUMN col_name;
+```
+
+Lock type: **none** (nullable add) / **table lock** (not null without default)
+Safe to run: during deploy / after deploy / off-hours only
+
+---
+
+### TASK-M02 — [description, e.g. Backfill existing rows]
+
+```sql
+-- UP (run in batches of 1000 to avoid lock escalation)
+UPDATE table_name
+SET col_name = [derived value]
+WHERE col_name IS NULL
+LIMIT 1000;
+
+-- Verify
+SELECT COUNT(*) FROM table_name WHERE col_name IS NULL;
+-- Expected: 0
+
+-- ROLLBACK: not needed (nullable — old code ignores new column)
+```
+
+Estimated rows: ~N | Estimated time: ~Ns | Lock: none
+
+---
+
+### TASK-M03 — [description, e.g. Enforce NOT NULL constraint]
+
+```sql
+-- UP — only run after M02 verified
+ALTER TABLE table_name ALTER COLUMN col_name SET NOT NULL;
+
+-- ROLLBACK
+ALTER TABLE table_name ALTER COLUMN col_name DROP NOT NULL;
+```
+
+**Prerequisite:** M02 complete AND verified (0 null rows)
+
+---
+
+## Deploy Sequence
+
+```
+M01 ──► deploy app v[N] ──► verify (smoke test) ──► M02 ──► verify ──► M03
+  │                                                                       │
+  └─ rollback window: run ROLLBACK scripts in reverse order ◄────────────┘
+                      M03-rollback → M02 (no-op) → M01-rollback
+```
+
+**Rollback window:** 48h after M03
+**Rollback owner:** [team]
+**Runbook location:** [link or path]
+
+---
+
+## Risk Assessment
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|-----------|
+| Lock escalation on M03 | low | high — table unavailable | Run during low-traffic window |
+| Backfill timeout on M02 | medium | medium — partial migration | Batch size 1000, resumable |
+| App v[N-1] reads new column | low | low — nullable, ignored | Backward compatible by design |

package/skills/ba-pitch-analyzer/assets/templates/cross-context/team-handoff.tmpl.md

@@ -0,0 +1,79 @@
+---
+type: team-handoff
+feature: FEATURE_SLUG
+skill_version: "2.5"
+teams: []
+tags: [cross-context, coordination]
+depends_on:
+  - "[[_cross-context/context-map]]"
+  - "[[_cross-context/event-choreography]]"
+status: draft
+---
+
+# Team Handoff: FEATURE TITLE
+
+> Explicit interface contracts between teams.
+> Each row is a commitment: From Team delivers Artifact by Ready-When condition.
+
+---
+
+## Handoff Register
+
+| From Team | To Team | Artifact | Ready When | Blocker Risk |
+|-----------|---------|----------|-----------|-------------|
+| [Team A] (API) | [Team B] (Mobile) | [[contracts/[repo].contract.md]] | TASK-00N done | 🔴 blocks Mobile TASK-00N |
+| [Team B] (API) | [Team A] (API) | `EventName` schema | TASK-00N done | 🟡 blocks integration test |
+| [Team B] (Mobile) | QA | E2E test cases | TASK-00N done | 🟡 blocks QA sprint entry |
+
+---
+
+## Blocking Dependencies
+
+```
+[Team B] CANNOT start TASK-00N ([description])
+  until [Team A] completes TASK-00N ([description])
+  Mitigation: use contract stub from [[contracts/[repo].contract.md]]
+  Stub ready: TASK-00N (unblocked — no dependency)
+
+[Team C] CANNOT start integration tests
+  until [Team A] EventName schema is stable
+  Mitigation: use ⚠️ SPECULATIVE contract — mark tests as xfail until confirmed
+```
+
+---
+
+## Parallel Work Windows
+
+```
+Wave 1 — No cross-team dependencies (start immediately):
+  [Team A]: TASK-001, TASK-002, TASK-003
+  [Team B]: TASK-004, TASK-005 (using contract stub)
+
+Wave 2 — After Team A TASK-003 done:
+  [Team B]: TASK-006 (replace stub with real contract)
+  [Team C]: TASK-007 (integration tests — real contract available)
+
+Wave 3 — After Wave 2 complete:
+  QA: E2E test suite
+```
+
+---
+
+## Communication Protocol
+
+| Trigger | Owner | Notify | Channel |
+|---------|-------|--------|---------|
+| Contract changes after stub distributed | [Team A] | [Team B], QA | [channel] |
+| TASK-00N delayed > 1 day | [Team A] | [Team B] | [channel] |
+| Schema breaking change detected | Any | All teams | [channel] |
+
+---
+
+## Definition of Done (Cross-Context)
+
+Feature is complete when ALL of the following are true:
+- [ ] All TASK-MNN migrations run and verified in staging
+- [ ] All contracts have no remaining ⏳ TBD fields
+- [ ] Event choreography happy path verified end-to-end
+- [ ] All dead-letter scenarios have runbooks
+- [ ] `synthesis.md` Health Dashboard — Coverage 🟢, Risk 🟢

package/skills/ba-pitch-analyzer/assets/templates/domain-model.tmpl.md

@@ -0,0 +1,79 @@
+---
+type: domain-model
+feature: FEATURE_SLUG
+bounded_context: CONTEXT
+entities: []
+value_objects: []
+domain_events: []
+repositories: []
+tags: [ddd]
+depends_on: ["[[_index]]"]
+status: draft
+---
+
+# Domain Model: FEATURE TITLE
+
+## Bounded Context
+`CONTEXT` context — owns [describe what this context is responsible for].
+[Note any context boundaries: what this context does NOT own]
+
+---
+
+## Aggregate: [Name]
+
+**Aggregate Root:** `[EntityName]`
+
+**Invariants:**
+- [invariant 1 — must be enforced by the aggregate root]
+- [invariant 2]
+
+```
+[EntityName] (Aggregate Root)
+├── id: [EntityName]Id (VO)
+├── status: [EntityName]Status ([value1] | [value2] | [value3])
+├── [field]: [Type]
+└── [childEntity]: [ChildEntity][] (Entity, owned by root)
+    ├── id: [ChildEntity]Id (VO)
+    └── [field]: [Type]
+```
+
+**State Transitions:**
+```
+[state1] ──[method()]──► [state2] ──[method()]──► [state3]
+                              └───[method()]────► [state4]
+```
+
+---
+
+## Value Objects
+
+| Value Object | Fields | Invariants |
+|---|---|---|
+| `[Name]Id` | value: string | UUID v4 format |
+| `[Name]` | [fields] | [rule] |
+
+---
+
+## Domain Events
+
+| Event | Emitted When | Payload Fields | Consumers |
+|---|---|---|---|
+| `[EntityName][PastTense]` | [trigger] | id, [fields] | [other contexts] |
+
+---
+
+## Repository Interfaces
+
+```typescript
+interface [EntityName]Repository {
+  findById(id: [EntityName]Id): Promise<[EntityName] | null>
+  save(entity: [EntityName]): Promise<void>
+  // [named business queries]
+}
+```
+
+---
+
+## Related
+- [[ux-behavior]] — screen states map to aggregate status values
+- [[usecases/_index]] — use cases that operate on this aggregate

package/skills/ba-pitch-analyzer/assets/templates/feedback.tmpl.md

@@ -0,0 +1,87 @@
+---
+type: feedback
+feature: FEATURE_SLUG
+sprint_date: YYYY-MM-DD
+po_spec_accuracy: ~        # Fill after sprint: 1-5
+dev_execution_accuracy: ~  # Fill after sprint: 1-5
+---
+
+# Post-Sprint Feedback: FEATURE TITLE
+
+> Fill this document during sprint retro.
+> Scores feed into `.claude/metrics.md` and drive SKILL improvements.
+
+---
+
+## Scores
+
+| Dimension | Score (1–5) | Meaning |
+|-----------|-------------|---------|
+| PO Spec Accuracy | ~ | Did generated docs reflect what PO intended? |
+| Dev Execution Accuracy | ~ | Did tasks lead to correct implementation? |
+
+**Score guide:**
+- 5 — Perfect, no corrections needed
+- 4 — Minor gaps, handled without blocking
+- 3 — Moderate gaps, caused 1–2 clarification rounds
+- 2 — Significant misalignment, rework required
+- 1 — Spec was wrong, had to re-generate from scratch
+
+---
+
+## PO Notes
+
+*Fill after reviewing delivered implementation against original pitch intent.*
+
+**What the spec got right:**
+- ...
+
+**What was missing or wrong:**
+- ...
+
+**Did the appetite hold?**
+Estimated: N weeks/days | Actual: N weeks/days
+
+---
+
+## Dev Notes
+
+*Fill during retro — be specific about which parts of the spec caused friction.*
+
+**Specs that needed clarification mid-sprint:**
+
+| Spec | What was unclear | What was needed |
+|------|-----------------|-----------------|
+| [[usecases/UC-Name]] | [description] | [what would have helped] |
+| [[domain-model#Section]] | [description] | [what would have helped] |
+
+**Specs that were well-written:**
+- [[usecases/UC-Name]] — [why it worked well]
+
+**Domain model accuracy:**
+- [ ] Aggregate design matched reality
+- [ ] Invariants were correct
+- [ ] Repository interfaces were usable as-is
+
+---
+
+## Improvement Signals
+
+*The most important section — drives SKILL v.next.*
+*Flag which reference file or template needs updating.*
+
+| Signal | Affects | Action |
+|--------|---------|--------|
+| [what was missing] | `references/[file].md` | [what to add/change] |
+| [what was wrong] | `assets/templates/[file].tmpl.md` | [what to fix] |
+
+---
+
+## Update metrics.md
+
+After filling this doc, update `.claude/metrics.md` with PO and Dev scores:
+
+```bash
+# The row for this feature should already exist from SKILL generation
+# Just fill in the PO* and Dev* columns
+```

package/skills/ba-pitch-analyzer/assets/templates/integration.tmpl.md

@@ -0,0 +1,64 @@
+---
+type: integration
+feature: FEATURE_SLUG
+affected_services: []
+domain_events_consumed: []
+domain_events_produced: []
+tags: [integration]
+depends_on: ["[[domain-model]]", "[[usecases/_index]]"]
+status: draft
+---
+
+# Integration Map: FEATURE TITLE
+
+## Impact Summary
+
+| System | Severity | Direction | Summary |
+|--------|----------|-----------|---------|
+| [package/service] | 🔴/🟡/🟢 | →/←/↔ | [one line] |
+
+---
+
+## [Package / Service Name]
+
+**Severity:** 🟢 Isolated
+**Direction:** → produces
+
+### What Changes
+[1-3 sentences]
+
+### Data Flow
+```
+[Feature] ──[event / call]──► [Service]
+           payload: { field1, field2 }
+```
+
+### Risk
+[What breaks silently if coordination is missed]
+
+### Mitigation
+[How to prevent]
+
+### Related Use Cases
+- [[usecases/UC-Name]] — the UC whose tasks implement this integration point
+  (find the tasks via their `use_case_refs` on the LOCAL board — never link them here)
+
+---
+
+<!-- Repeat section for each affected system -->
+
+---
+
+## Event Coordination
+
+| Event | Producer | Consumers | Deploy Order |
+|-------|----------|-----------|-------------|
+| `[EventName]` | this feature | [service A, service B] | consumers first |
+
+---
+
+## Environment Variables Required
+
+| Variable | Service | Purpose |
+|----------|---------|---------|
+| `[VAR_NAME]` | [service] | [what it's for] |

package/skills/ba-pitch-analyzer/assets/templates/run-state.tmpl.md

@@ -0,0 +1,77 @@
+---
+type: run-state
+feature: FEATURE_SLUG
+last_run: YYYY-MM-DD
+skill_version: "2.8"
+lens: lite | standard
+pitch_hash: HASH
+assess_done: false
+assess_l0_score: 0
+assess_confidence: 0
+phases_completed: []
+phases_skipped: []
+files_generated: []
+human_edited_files: []
+discovered_rounds: 0
+upgrade_available: standard | cross-context | none
+upgrade_adds: []
+---
+
+# Run State: FEATURE TITLE
+
+> Internal file — do not edit manually.
+> Used by skill to enable incremental upgrades and Phase 0 cache reuse.
+
+## Phases
+
+| Phase | Status | Skipped Reason |
+|-------|--------|---------------|
+| 0 Assess | ✅ done / ⬜ skipped | — |
+| 1 Ingest | ✅ done / ♻️ cached | cached from Phase 0 |
+| 1b API Feasibility | ✅ done / ⬜ skipped | no third-party detected |
+| 2 DDD Analysis | ✅ done | — |
+| 2b Contracts | ✅ done / ⬜ skipped | lite mode |
+| 3 UX Behavior | ✅ done | — |
+| 4 Use Cases | ✅ done | — |
+| 5 Integration | ✅ done / ⬜ skipped | lite mode |
+| 6 Tasks | ✅ done | — |
+| 7a Audit | ✅ done | — |
+| 7b Scope Summary | ✅ done | — |
+| 7c Synthesis | ✅ done | — |
+| 8 Index | ✅ done | — |
+
+## Files Generated
+
+<!-- Auto-populated after run — one entry per file -->
+- path/to/file.md
+
+## Human-Edited Files
+
+<!-- Populated when upgrade detects mtime > generation timestamp -->
+<!-- These files will NOT be overwritten on upgrade -->
+- path/to/file.md — edited YYYY-MM-DD
+
+## Upgrade Available
+
+```bash
+# Check current upgrade options
+/ba-pitch-analyzer --status shapeup/FEATURE_SLUG/spec/
+
+# Upgrade to standard lens (adds contracts + integration + full synthesis)
+/ba-pitch-analyzer --upgrade standard shapeup/FEATURE_SLUG/spec/
+
+# Upgrade specific module only
+/ba-pitch-analyzer --upgrade contracts shapeup/FEATURE_SLUG/spec/
+/ba-pitch-analyzer --upgrade synthesis shapeup/FEATURE_SLUG/spec/
+```
+
+## Metrics
+
+```
+assess_tokens_est  : N–N
+actual_tokens      : N        (filled post-run)
+assess_ucs_est     : N
+actual_ucs         : N        (filled post-run)
+assess_tasks_est   : N–N
+actual_tasks       : N        (filled post-run)
+```

package/skills/ba-pitch-analyzer/assets/templates/scope-summary.tmpl.md

@@ -0,0 +1,105 @@
+---
+type: scope-summary
+feature: FEATURE_SLUG
+generated_at: YYYY-MM-DD
+total_tasks: 0
+total_estimated_hours: 0
+packages_touched: []
+critical_path_length: 0
+critical_path_tasks: []
+external_blockers: []
+audit_score: 0
+---
+
+# Feature Scope Summary: FEATURE TITLE
+
+> Generated from task graph. Use this document in sprint planning.
+> Audit score below 90 means spec needs human review before execution.
+
+---
+
+## At a Glance
+
+| | |
+|---|---|
+| Total tasks | N |
+| Estimated effort | Nh (~N days) |
+| Packages touched | N |
+| Critical path depth | N tasks |
+| External blockers | N items before sprint can start |
+| Spec audit score | N/100 [✅/⚠️/🚫] |
+
+---
+
+## Critical Path
+
+The longest sequential chain — minimum time to complete if parallelized optimally.
+
+```
+TASK-NNN → TASK-NNN → TASK-NNN → TASK-NNN
+  Nh          Nh          Nh          Nh
+```
+
+**Critical path estimate:** Nh total
+*(All other work can happen in parallel alongside this chain)*
+
+---
+
+## Package Distribution
+
+| Package | Tasks | Est. Hours | % of effort |
+|---------|-------|------------|-------------|
+| packages/shared | N | Nh | N% |
+| apps/api | N | Nh | N% |
+| apps/web | N | Nh | N% |
+| **Total** | **N** | **Nh** | 100% |
+
+---
+
+## Parallel Opportunities
+
+Tasks with no interdependency that can run simultaneously:
+
+| Group | Tasks | Can start after |
+|-------|-------|----------------|
+| Group A | TASK-NNN, TASK-NNN | TASK-NNN completes |
+| Group B | TASK-NNN | TASK-NNN completes |
+
+---
+
+## External Blockers
+
+Items that must be resolved BEFORE sprint starts:
+
+**Environment Variables**
+- [ ] `VAR_NAME` — [what it's for, where to get it]
+
+**Third-party Setup**
+- [ ] [Service] sandbox account — [how to obtain]
+
+**Internal Dependencies**
+- [ ] [Other team/service] must deploy [X] first — see [[integration#section]]
+
+---
+
+## Risks (from Pitch)
+
+Carried from [[_index#Rabbit-Holes]]:
+
+| Risk | Impact | Mitigation | Related UC |
+|------|--------|------------|-----------|
+| [risk] | high/med/low | [mitigation] | [[usecases/UC-Name]] |
+
+---
+
+## Execution Recommendation
+
+<!-- Filled from spec-lint.mjs output -->
+
+**Audit Score: N/100**
+
+```
+[✅ Ready for autonomous execution — run /execute-plan tasks/_index.md]
+[⚠️ Review recommended — PO + Dev 15-min walkthrough before /execute-plan]
+[🚫 Blocked — fix critical issues in Audit Report first]
+```