@the-bearded-bear/claude-craft 8.23.3 → 8.26.0-next.2a54921

package/Project/i18n/en/commands/list-stories.md

@@ -1,120 +1,9 @@
 ---
-description: List User Stories
-argument-hint: [arguments]
+description: "Deprecated (removed in 9.0): use /project:backlog list story"
+deprecated: true
+replaced-by: /project:backlog
 ---
 
-# List User Stories
+> ⚠️ `/project:list-stories` is deprecated and will be removed in 9.0. Use `/project:backlog list story`.
 
-Display list of User Stories with filtering by EPIC, Sprint or Status.
-
-## Arguments
-
-$ARGUMENTS (optional, format: [filter] [value])
-- **epic EPIC-XXX**: Filter by EPIC
-- **sprint N**: Filter by sprint
-- **status STATUS**: Filter by status (todo, in-progress, blocked, done)
-- **backlog**: Display only USs not assigned to a sprint
-
-## Process
-
-### Step 1: Read User Stories
-
-1. Scan directory `project-management/backlog/user-stories/`
-2. Read each file US-XXX-*.md
-3. Extract metadata from each US
-
-### Step 2: Filter
-
-Apply filters according to $ARGUMENTS:
-- By parent EPIC
-- By assigned sprint
-- By status
-- Unassigned (backlog)
-
-### Step 3: Calculate statistics
-
-For each US:
-- Count total tasks
-- Count tasks by status
-- Calculate progress percentage
-
-### Step 4: Display
-
-Generate formatted table grouped by EPIC or Sprint depending on context.
-
-## Output Format - By EPIC
-
-```
-📖 User Stories - EPIC-001: Authentication
-
-| ID | Name | Sprint | Status | Points | Tasks | Progress |
-|----|-----|--------|--------|--------|-------|-------------|
-| US-001 | User login | Sprint 1 | 🟡 In Progress | 5 | 4/6 | ██████░░░░ 67% |
-| US-002 | Registration | Sprint 1 | 🔴 To Do | 3 | 0/5 | ░░░░░░░░░░ 0% |
-| US-003 | Forgot password | Backlog | 🔴 To Do | 3 | - | - |
-
-───────────────────────────────────────────────────
-Total: 3 US | 11 points | 🔴 2 | 🟡 1 | 🟢 0
-```
-
-## Output Format - By Sprint
-
-```
-📖 User Stories - Sprint 1
-
-| ID | EPIC | Name | Status | Points | Tasks | Progress |
-|----|------|-----|--------|--------|-------|-------------|
-| US-001 | EPIC-001 | User login | 🟡 In Progress | 5 | 4/6 | ██████░░░░ 67% |
-| US-002 | EPIC-001 | Registration | 🔴 To Do | 3 | 0/5 | ░░░░░░░░░░ 0% |
-| US-005 | EPIC-002 | Product list | 🟢 Done | 5 | 6/6 | ██████████ 100% |
-
-───────────────────────────────────────────────────
-Sprint 1: 3 US | 13 points | Done: 5 pts (38%)
-```
-
-## Output Format - Backlog
-
-```
-📖 Backlog (Unassigned USs)
-
-| ID | EPIC | Name | Priority | Points | Status |
-|----|------|-----|----------|--------|--------|
-| US-003 | EPIC-001 | Forgot password | High | 3 | 🔴 To Do |
-| US-006 | EPIC-002 | Product detail | Medium | 5 | 🔴 To Do |
-| US-007 | EPIC-002 | Search | Low | 8 | 🔴 To Do |
-
-───────────────────────────────────────────────────
-Backlog: 3 US | 16 points to plan
-```
-
-## Examples
-
-```
-# List all USs
-/project:list-stories
-
-# List USs of an EPIC
-/project:list-stories epic EPIC-001
-
-# List USs of current sprint
-/project:list-stories sprint 1
-
-# List in-progress USs
-/project:list-stories status in-progress
-
-# List blocked USs
-/project:list-stories status blocked
-
-# List backlog (unassigned)
-/project:list-stories backlog
-```
-
-## Suggested Actions
-
-Depending on context, suggest:
-```
-Actions:
-  /sprint:transition US-XXX sprint-2     # Assign to sprint
-  /sprint:transition US-XXX in-progress  # Change status
-  /project:add-task US-XXX "[BE] ..." 4h  # Add task
-```
+Run `/project:backlog list story $ARGUMENTS`: read `.claude/commands/project/backlog.md` and follow it with these arguments.

package/Project/i18n/en/commands/list-tasks.md

@@ -1,132 +1,9 @@
 ---
-description: List Tasks
-argument-hint: [arguments]
+description: "Deprecated (removed in 9.0): use /project:backlog list task"
+deprecated: true
+replaced-by: /project:backlog
 ---
 
-# List Tasks
+> ⚠️ `/project:list-tasks` is deprecated and will be removed in 9.0. Use `/project:backlog list task`.
 
-Display list of tasks with filtering by User Story, Sprint, Type or Status.
-
-## Arguments
-
-$ARGUMENTS (optional, format: [filter] [value])
-- **us US-XXX**: Filter by User Story
-- **sprint N**: Filter by sprint
-- **type TYPE**: Filter by type (DB, BE, FE-WEB, FE-MOB, TEST, DOC, OPS, REV)
-- **status STATUS**: Filter by status (todo, in-progress, blocked, done)
-
-## Process
-
-### Step 1: Read Tasks
-
-1. Scan task directories:
-   - `project-management/sprints/sprint-XXX/tasks/`
-   - `project-management/backlog/tasks/` (if exists)
-2. Read each file TASK-XXX.md
-3. Extract metadata
-
-### Step 2: Filter
-
-Apply filters according to $ARGUMENTS.
-
-### Step 3: Calculate
-
-- Total estimated hours
-- Completed hours
-- Breakdown by type
-- Breakdown by status
-
-### Step 4: Display
-
-Generate formatted table.
-
-## Output Format - By User Story
-
-```
-🔧 Tasks - US-001: User login
-
-| ID | Type | Description | Status | Est. | Spent |
-|----|------|-------------|--------|------|-------|
-| TASK-001 | [DB] | User entity | 🟢 Done | 2h | 2h |
-| TASK-002 | [BE] | User repository | 🟢 Done | 3h | 3.5h |
-| TASK-003 | [BE] | Login API endpoint | 🟡 In Progress | 4h | 2h |
-| TASK-004 | [FE-WEB] | Auth controller | 🔴 To Do | 3h | - |
-| TASK-005 | [FE-MOB] | Login screen | ⏸️ Blocked | 6h | - |
-| TASK-006 | [TEST] | AuthService tests | 🔴 To Do | 3h | - |
-
-───────────────────────────────────────────────────
-US-001: 6 tasks | 21h estimated | 7.5h completed (36%)
-🔴 2 | 🟡 1 | ⏸️ 1 | 🟢 2
-```
-
-## Output Format - By Sprint
-
-```
-🔧 Tasks - Sprint 1
-
-By status:
-🔴 To Do (8 tasks, 24h)
-🟡 In Progress (3 tasks, 10h)
-⏸️ Blocked (2 tasks, 8h)
-🟢 Done (12 tasks, 35h)
-
-By type:
-[DB]     ████████░░ 5 tasks
-[BE]     ██████████ 8 tasks
-[FE-WEB] ██████░░░░ 4 tasks
-[FE-MOB] ████░░░░░░ 3 tasks
-[TEST]   ██████░░░░ 4 tasks
-[DOC]    ██░░░░░░░░ 1 task
-
-───────────────────────────────────────────────────
-Sprint 1: 25 tasks | 77h estimated | 35h completed (45%)
-```
-
-## Output Format - Blocked
-
-```
-⏸️ Blocked Tasks
-
-| ID | US | Type | Description | Blocker |
-|----|-----|------|-------------|----------|
-| TASK-005 | US-001 | [FE-MOB] | Login screen | Waiting for auth API |
-| TASK-012 | US-003 | [BE] | Email service | Missing SMTP config |
-
-───────────────────────────────────────────────────
-2 blocked tasks | 14h waiting
-
-Actions:
-  Resolve TASK-005: Complete TASK-003 first
-  Resolve TASK-012: Configure SMTP in .env
-```
-
-## Examples
-
-```
-# List all tasks
-/project:list-tasks
-
-# List tasks of a US
-/project:list-tasks us US-001
-
-# List tasks of sprint 1
-/project:list-tasks sprint 1
-
-# List backend tasks
-/project:list-tasks type BE
-
-# List in-progress tasks
-/project:list-tasks status in-progress
-
-# List blocked tasks
-/project:list-tasks status blocked
-```
-
-## Status Color Codes
-
-| Icon | Status | Meaning |
-|-------|--------|---------------|
-| 🔴 | To Do | Not started |
-| 🟡 | In Progress | In progress |
-| ⏸️ | Blocked | Blocked |
-| 🟢 | Done | Completed |
+Run `/project:backlog list task $ARGUMENTS`: read `.claude/commands/project/backlog.md` and follow it with these arguments.

package/Project/i18n/en/commands/metrics.md

@@ -1,227 +1,9 @@
 ---
-name: metrics
-description: Generate project metrics dashboard with sprint velocity, spec coverage, and quality indicators
-arguments:
-  - name: sprint
-    description: Sprint ID for sprint-specific metrics (e.g., Sprint-3)
-    required: false
-  - name: format
-    description: Output format (dashboard, json, markdown)
-    required: false
+description: "Deprecated (removed in 9.0): use /project:report metrics"
+deprecated: true
+replaced-by: /project:report
 ---
 
-# /project:metrics
+> ⚠️ `/project:metrics` is deprecated and will be removed in 9.0. Use `/project:report metrics`.
 
-## Mission
-
-Generate a comprehensive project metrics dashboard showing sprint velocity, burndown progress, spec coverage, quality gate pass rates, and regression tracking. This provides data-driven visibility into project health.
-
-## Prerequisites
-
-- `.bmad/sprint-status.yaml` exists with sprint data
-- `project-management/backlog/` contains user stories
-- Optional: `.bmad/metrics/` with historical data
-- Optional: `project-management/prd.md` for coverage metrics
-
-## Plan Mode
-
-> **Plan mode is mandatory.** Before executing, Claude activates plan mode to analyze impacted code, propose an implementation plan, and wait for your validation before making any changes.
-
-## Metrics Categories
-
-### 1. Sprint Velocity
-
-Track team throughput across sprints:
-
-| Metric | Description | Source |
-|--------|-------------|--------|
-| Velocity | Story points completed per sprint | sprint-status.yaml |
-| Average velocity | Rolling average (last 3 sprints) | metrics history |
-| Commitment ratio | Completed / committed points | sprint-status.yaml |
-| Carryover | Points carried to next sprint | sprint-status.yaml |
-
-### 2. Spec Coverage
-
-Track requirement-to-code coverage:
-
-| Metric | Description | Source |
-|--------|-------------|--------|
-| Requirement coverage | % FR-xxx covered by stories | PRD + stories |
-| Story coverage | % stories with code references | stories + code |
-| Test coverage | % ACs with corresponding tests | stories + tests |
-| Traceability completeness | % full chains (FR→US→Code→Test) | trace matrix |
-
-### 3. Quality Gates
-
-Track gate pass rates:
-
-| Metric | Description | Source |
-|--------|-------------|--------|
-| PRD gate pass rate | % PRD validations passing (≥80%) | gate history |
-| Story gate pass rate | % story DoD checks passing | gate history |
-| Sprint ready pass rate | % sprint readiness checks passing | gate history |
-| First-pass rate | % passing on first attempt | gate history |
-
-### 4. Sprint Health
-
-Track sprint execution health:
-
-| Metric | Description | Source |
-|--------|-------------|--------|
-| Stories done | Completed / total stories | sprint-status.yaml |
-| Tasks done | Completed / total tasks | sprint-status.yaml |
-| Blocked stories | Currently blocked count | sprint-status.yaml |
-| TDD compliance | % stories following TDD cycle | sprint-status.yaml |
-
-### 5. Regression
-
-Track quality over time:
-
-| Metric | Description | Source |
-|--------|-------------|--------|
-| Bugs found | Bugs found per sprint (QA recette) | qa sessions |
-| Bugs fixed | Bugs fixed per sprint | qa sessions |
-| Regression rate | Bugs reintroduced | regression registry |
-| Escape rate | Bugs found in prod/review | sprint history |
-
-## Workflow
-
-### Step 1: Collect Data
-
-1. Read `.bmad/sprint-status.yaml` for current sprint
-2. Read `.bmad/metrics/` for historical data (if exists)
-3. Run `/project:trace` data to get coverage metrics
-4. Read gate validation history
-5. Read QA recette session data (if exists)
-
-### Step 2: Calculate Metrics
-
-1. Compute velocity (current + rolling average)
-2. Compute spec coverage percentages
-3. Compute gate pass rates
-4. Compute sprint health indicators
-5. Compare with previous sprints for trends
-
-### Step 3: Generate Dashboard
-
-```
-╔══════════════════════════════════════════════════════════╗
-║               PROJECT METRICS DASHBOARD                  ║
-╠══════════════════════════════════════════════════════════╣
-║ Sprint: Sprint-3 | Date: 2026-02-19                      ║
-╠══════════════════════════════════════════════════════════╣
-║                                                          ║
-║ VELOCITY                                                 ║
-║ ──────────────────────────────────────────────────────── ║
-║ Current sprint:    18/21 pts completed (86%)             ║
-║ Average velocity:  19 pts/sprint (last 3)                ║
-║ Commitment ratio:  86% (target: >80%)              ✅    ║
-║ Carryover:         3 pts (1 story)                       ║
-║                                                          ║
-║ SPEC COVERAGE                                            ║
-║ ──────────────────────────────────────────────────────── ║
-║ Requirements:      12/15 FR-xxx covered (80%)      ⚠️    ║
-║ Story coverage:    8/10 stories have code refs     ⚠️    ║
-║ Test coverage:     24/28 ACs have tests (86%)      ✅    ║
-║ Full traceability: 7/10 complete chains (70%)      ⚠️    ║
-║                                                          ║
-║ QUALITY GATES                                            ║
-║ ──────────────────────────────────────────────────────── ║
-║ PRD gate:          1/1 passed (100%)               ✅    ║
-║ Story DoD:         6/8 passed (75%)                ⚠️    ║
-║ Sprint ready:      1/1 passed (100%)               ✅    ║
-║ First-pass rate:   70%                             ⚠️    ║
-║                                                          ║
-║ SPRINT HEALTH                                            ║
-║ ──────────────────────────────────────────────────────── ║
-║ Stories:           6/8 done (75%)                         ║
-║ Tasks:             22/28 done (79%)                       ║
-║ Blocked:           1 story (US-015)                ⚠️    ║
-║ TDD compliance:    100%                            ✅    ║
-║                                                          ║
-║ REGRESSION                                               ║
-║ ──────────────────────────────────────────────────────── ║
-║ Bugs found:        4 (this sprint)                       ║
-║ Bugs fixed:        3 (75% fix rate)                      ║
-║ Regressions:       0                               ✅    ║
-║ Escape rate:       0%                              ✅    ║
-║                                                          ║
-║ TRENDS (vs previous sprint)                              ║
-║ ──────────────────────────────────────────────────────── ║
-║ Velocity:          ↑ +2 pts (was 16)                     ║
-║ Spec coverage:     ↑ +10% (was 70%)                      ║
-║ First-pass rate:   ↓ -5% (was 75%)                       ║
-║ Blocked stories:   → same (was 1)                        ║
-╚══════════════════════════════════════════════════════════╝
-```
-
-### Step 4: Store Metrics
-
-Save current metrics to `.bmad/metrics/sprint-{id}.json`:
-
-```json
-{
-  "sprint_id": "Sprint-3",
-  "date": "2026-02-19",
-  "velocity": {
-    "completed": 18,
-    "committed": 21,
-    "ratio": 0.86
-  },
-  "coverage": {
-    "requirements": 0.80,
-    "stories": 0.80,
-    "tests": 0.86,
-    "traceability": 0.70
-  },
-  "gates": {
-    "prd_pass_rate": 1.0,
-    "story_pass_rate": 0.75,
-    "sprint_ready_rate": 1.0,
-    "first_pass_rate": 0.70
-  },
-  "health": {
-    "stories_done": 6,
-    "stories_total": 8,
-    "tasks_done": 22,
-    "tasks_total": 28,
-    "blocked": 1,
-    "tdd_compliance": 1.0
-  },
-  "regression": {
-    "bugs_found": 4,
-    "bugs_fixed": 3,
-    "regressions": 0,
-    "escape_rate": 0.0
-  }
-}
-```
-
-## Example Session
-
-```
-User: /project:metrics --sprint=Sprint-3
-
-Claude: Generating metrics dashboard for Sprint-3...
-
-[Dashboard displayed]
-
-Key observations:
-- Velocity is trending up (+2 pts vs Sprint-2). Good momentum.
-- Spec coverage at 80% — 3 requirements still uncovered (FR-008, FR-011, FR-014)
-- Story DoD pass rate at 75% — US-009 and US-012 failed first attempt
-- 1 blocked story (US-015) — waiting for API credentials
-
-Recommendations:
-1. Address 3 uncovered requirements before Sprint-4
-2. Unblock US-015 to complete sprint scope
-3. Review DoD failures for common patterns
-```
-
-## Related Commands
-
-- `/project:burndown` — Generate burndown chart
-- `/project:trace` — View traceability matrix
-- `/project:coverage-map` — Check requirement coverage
-- `/sprint:status` — View sprint status
-- `/workflow:retro` — Sprint retrospective (uses metrics)
+Run `/project:report metrics $ARGUMENTS`: read `.claude/commands/project/report.md` and follow it with these arguments.

package/Project/i18n/en/commands/migrate-backlog.md

@@ -1,190 +1,9 @@
 ---
-description: "Migrate existing backlog to BMAD v6 format"
-argument-hint: "[--dry-run] [--force]"
+description: "Deprecated (removed in 9.0): use /project:migrate"
+deprecated: true
+replaced-by: /project:migrate
 ---
 
-# Migrate Backlog
+> ⚠️ `/project:migrate-backlog` is deprecated and will be removed in 9.0. Use `/project:migrate`.
 
-Convert existing backlog to BMAD v6 format with sprint-status.yaml tracking.
-
-## Arguments
-
-$ARGUMENTS (format: [--dry-run] [--force])
-- **--dry-run** (optional): Preview changes without applying
-- **--force** (optional): Overwrite existing BMAD files
-
-## Prerequisites
-
-Run `/project:analyze-backlog` first to understand current structure.
-
-## Plan Mode
-
-> **Plan mode is mandatory.** Before executing, Claude activates plan mode to analyze impacted code, propose an implementation plan, and wait for your validation before making any changes.
-
-## Process
-
-### Step 1: Validate prerequisites
-
-1. Check that `.bmad/` directory exists (create if needed)
-2. Check for existing `sprint-status.yaml` (warn if exists and no --force)
-3. Verify backlog analysis was run
-
-### Step 2: Create BMAD structure
-
-```
-.bmad/
-├── sprint-status.yaml    # Main tracking file
-├── batch-queue.yaml      # Batch processing queue
-├── gates/                # Quality gate configs
-├── hooks/                # Claude Code hooks
-└── lib/                  # Helper scripts
-```
-
-### Step 3: Parse existing backlog
-
-For each User Story found:
-1. Extract all metadata
-2. Parse acceptance criteria (Gherkin format)
-3. Identify related tasks
-4. Determine current status
-5. Calculate completion percentage
-
-### Step 4: Generate sprint-status.yaml
-
-Transform each story to BMAD v6 format:
-
-```yaml
-stories:
-  US-001:
-    title: "User login"
-    status: "in-progress"           # Mapped from emoji status
-    previous_status: "ready-for-dev"
-    assigned_to: ""
-    tdd_phase: "red"                # Default for in-progress
-    current_task: "TASK-001"
-    story_points: 5
-    epic_id: "EPIC-001"
-    tasks:
-      total: 4
-      completed: 2
-      list:
-        - id: "TASK-001"
-          title: "Backend auth endpoint"
-          status: "in-progress"
-          type: "BE"
-        - id: "TASK-002"
-          title: "Frontend login form"
-          status: "done"
-          type: "FE"
-    acceptance_criteria:
-      total: 3
-      validated: 1
-    history:
-      - timestamp: "2026-01-29T10:00:00Z"
-        from: "backlog"
-        to: "in-progress"
-        by: "migration"
-        reason: "BMAD v6 migration"
-```
-
-### Step 5: Status mapping
-
-Map existing status indicators:
-| Original | BMAD v6 Status |
-|----------|----------------|
-| 🔴 To Do | backlog |
-| 🟡 In Progress | in-progress |
-| 🟢 Done | done |
-| ⏸️ Blocked | blocked |
-| Sprint-X assigned | ready-for-dev |
-
-### Step 6: Initialize TDD phase
-
-Set initial TDD phase based on task completion:
-- 0% tasks done → `red`
-- 1-99% tasks done → `green`
-- 100% tasks done → `refactor` or `done`
-
-### Step 7: Create backup (unless --dry-run)
-
-1. Copy existing backlog to `.bmad/backup/`
-2. Timestamp the backup
-3. Log backup location
-
-### Step 8: Apply migration (unless --dry-run)
-
-1. Write `sprint-status.yaml`
-2. Update story files with BMAD metadata comments
-3. Create `.bmad/migration-log.md`
-
-## Output Format
-
-```
-🔄 BMAD v6 Migration
-====================
-
-## Pre-flight Check
-✅ Backlog location: project-management/backlog/
-✅ BMAD directory: .bmad/ (created)
-✅ No existing sprint-status.yaml
-
-## Migration Summary
-
-### Stories Migrated: {COUNT}
-| ID | Title | Status | TDD Phase |
-|----|-------|--------|-----------|
-| US-001 | Login | in-progress | green |
-| US-002 | Signup | backlog | - |
-
-### Tasks Migrated: {COUNT}
-### Acceptance Criteria: {COUNT}
-
-## Files Created
-- .bmad/sprint-status.yaml
-- .bmad/batch-queue.yaml
-- .bmad/backup/backlog-2026-01-29.tar.gz
-- .bmad/migration-log.md
-
-## Next Steps
-1. Review sprint-status.yaml
-2. Run `/sprint:status` to verify
-3. Configure sprint metadata (dates, goals)
-4. Set up quality gates with `/gate:configure`
-```
-
-## Dry Run Output
-
-```
-🔄 BMAD v6 Migration (DRY RUN)
-==============================
-
-⚠️ No changes will be made
-
-## Would Create:
-- .bmad/sprint-status.yaml (42 KB)
-- .bmad/batch-queue.yaml (2 KB)
-
-## Would Migrate:
-- 12 User Stories
-- 45 Tasks
-- 36 Acceptance Criteria
-
-Run without --dry-run to apply changes.
-```
-
-## Example
-
-```
-/project:migrate-backlog --dry-run
-/project:migrate-backlog
-/project:migrate-backlog --force
-```
-
-## Rollback
-
-If migration fails:
-```bash
-# Restore from backup
-tar -xzf .bmad/backup/backlog-*.tar.gz -C project-management/
-rm .bmad/sprint-status.yaml
-```
+Run `/project:migrate $ARGUMENTS`: read `.claude/commands/project/migrate.md` and follow it with these arguments.