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

package/Project/i18n/en/commands/update-story.md

@@ -1,150 +1,9 @@
 ---
-description: Update a User Story
-argument-hint: [arguments]
+description: "Deprecated (removed in 9.0): use /project:backlog edit story"
+deprecated: true
+replaced-by: /project:backlog
 ---
 
-# Update a User Story
+> ⚠️ `/project:update-story` is deprecated and will be removed in 9.0. Use `/project:backlog edit story`.
 
-Modify information of an existing User Story.
-
-## Arguments
-
-$ARGUMENTS (format: US-XXX [field] [value])
-- **US-ID** (required): User Story ID (e.g., US-001)
-- **Field** (optional): Field to modify
-- **Value** (optional): New value
-
-## 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.
-
-## Modifiable Fields
-
-| Field | Description | Example |
-|-------|-------------|---------|
-| `name` | US name | "New name" |
-| `points` | Story points | 1, 2, 3, 5, 8 |
-| `epic` | Parent EPIC | EPIC-002 |
-| `persona` | Related persona | P-001 |
-| `story` | US text | "As a..." |
-| `criteria` | Acceptance criteria | (interactive mode) |
-
-## Process
-
-### Interactive Mode (without field arguments)
-
-```
-/project:update-story US-001
-```
-
-Display information and offer modifications:
-
-```
-📖 US-001: User login
-
-Current fields:
-1. Name: User login
-2. EPIC: EPIC-001
-3. Points: 5
-4. Persona: P-001 (Standard User)
-5. Story: As a user, I want...
-6. Acceptance criteria: [3 criteria]
-
-Which field to modify? (1-6, or 'q' to quit)
->
-```
-
-### Direct Mode
-
-```
-/project:update-story US-001 points 8
-```
-
-### Modify Acceptance Criteria
-
-In interactive mode, option to:
-- Add a criterion
-- Modify existing criterion
-- Delete a criterion
-
-```
-Current acceptance criteria:
-1. CA-1: Login with email/password
-2. CA-2: Error message on failure
-3. CA-3: Redirect after success
-
-Action? (a)dd, (m)odify, (d)elete, (q)uit
-> a
-
-New criterion (Gherkin format):
-GIVEN:
-WHEN:
-THEN:
-```
-
-### Steps
-
-1. Validate that US exists
-2. Read current file
-3. Modify requested field
-4. Update modification date
-5. Save file
-6. Update parent EPIC if changed
-7. Update index
-
-## Output Format
-
-```
-✅ User Story updated!
-
-📖 US-001: User login
-
-Modification:
-  Points: 5 → 8
-
-⚠️ Warning: 8 points is the maximum recommended.
-   Consider splitting this US if too complex.
-
-File: project-management/backlog/user-stories/US-001-user-login.md
-```
-
-## EPIC Change
-
-If changing parent EPIC:
-
-```
-✅ User Story moved!
-
-📖 US-001: User login
-
-Modification:
-  EPIC: EPIC-001 → EPIC-002
-
-Updates:
-  - EPIC-001: US removed from list
-  - EPIC-002: US added to list
-  - Index: Updated
-```
-
-## Examples
-
-```
-# Interactive mode
-/project:update-story US-001
-
-# Change points
-/project:update-story US-001 points 3
-
-# Change EPIC
-/project:update-story US-001 epic EPIC-002
-
-# Change name
-/project:update-story US-001 name "User login with SSO"
-```
-
-## Validation
-
-- Points: Fibonacci (1, 2, 3, 5, 8)
-- If points > 8: Warning to split
-- EPIC: Must exist
-- Persona: Must be defined in personas.md
+Run `/project:backlog edit story $ARGUMENTS`: read `.claude/commands/project/backlog.md` and follow it with these arguments.

package/Project/i18n/en/scaffold/CLAUDE.md

@@ -18,69 +18,69 @@ Expert in architecture, technical decomposition and Scrum facilitation.
 
 | Command | Description |
 |---------|-------------|
-| `/project:generate-backlog` | Generate the full backlog |
-| `/project:decompose-tasks N` | Break sprint N into tasks |
-| `/project:analyze-backlog` | Analyze the existing backlog |
-| `/project:migrate-backlog` | Migrate an existing backlog |
-| `/project:sync-backlog` | Synchronize the backlog index |
+| `/workflow:plan --only=backlog` | Generate the full backlog |
+| `/workflow:start N` | Break sprint N into tasks |
+| `/project:migrate --analyze` | Analyze the existing backlog |
+| `/project:migrate` | Migrate an existing backlog |
+| `/project:migrate --resync` | Synchronize the backlog index |
 
 ### EPIC Management (`/project:`)
 
 | Command | Description |
 |---------|-------------|
-| `/project:add-epic "Name"` | Create a new EPIC |
-| `/project:list-epics` | List all EPICs |
-| `/project:update-epic EPIC-XXX` | Edit an EPIC |
+| `/project:backlog add epic "Name"` | Create a new EPIC |
+| `/project:backlog list epic` | List all EPICs |
+| `/project:backlog edit epic EPIC-XXX` | Edit an EPIC |
 
 ### User Story Management (`/project:`)
 
 | Command | Description |
 |---------|-------------|
-| `/project:add-story EPIC-XXX "Name"` | Create a User Story |
-| `/project:list-stories` | List User Stories |
-| `/project:update-story US-XXX` | Edit a User Story |
-| `/project:update-stories` | Update multiple User Stories |
+| `/project:backlog add story EPIC-XXX "Name"` | Create a User Story |
+| `/project:backlog list story` | List User Stories |
+| `/project:backlog edit story US-XXX` | Edit a User Story |
+| `/project:migrate --stories` | Update multiple User Stories |
 
 ### Task Management (`/project:`)
 
 | Command | Description |
 |---------|-------------|
-| `/project:add-task US-XXX "[TYPE] Desc" Xh` | Create a task |
-| `/project:list-tasks` | List tasks |
-| `/project:move-task TASK-XXX status` | Change status |
+| `/project:backlog add task US-XXX "[TYPE] Desc" Xh` | Create a task |
+| `/project:backlog list task` | List tasks |
+| `/project:backlog move task TASK-XXX status` | Change status |
 
 ### Visualization & Execution (`/project:`)
 
 | Command | Description |
 |---------|-------------|
-| `/project:board` | Show the sprint Kanban |
-| `/project:batch-status` | Batch status of items |
-| `/project:run-sprint N` | Run a full sprint |
-| `/project:run-epic EPIC-XXX` | Run a full EPIC |
-| `/project:run-queue` | Run the queue |
-| `/project:generate-prd` | Generate the PRD |
-| `/project:generate-tech-spec` | Generate the technical spec |
+| `/workflow:status --board` | Show the sprint Kanban |
+| `/workflow:status --queue` | Batch status of items |
+| `/workflow:implement N` | Run a full sprint |
+| `/workflow:implement --epic EPIC-XXX` | Run a full EPIC |
+| `/workflow:implement --queue` | Run the queue |
+| `/workflow:plan --only=prd` | Generate the PRD |
+| `/workflow:design` | Generate the technical spec |
 
 ### Sprint (`/sprint:`)
 
 | Command | Description |
 |---------|-------------|
-| `/sprint:status` | Detailed sprint metrics |
-| `/sprint:transition US-XXX status` | Change a User Story's status/sprint |
-| `/sprint:next-story` | Next story ready for dev |
-| `/sprint:auto-route` | Automatic story routing |
-| `/sprint:dev US-XXX` | Develop a story |
+| `/workflow:status` | Detailed sprint metrics |
+| `/project:backlog move story US-XXX status` | Change a User Story's status/sprint |
+| `/project:backlog next story` | Next story ready for dev |
+| `/project:backlog move story --auto` | Automatic story routing |
+| `/workflow:implement US-XXX` | Develop a story |
 
 ### Quality Gates (`/gate:`)
 
 | Command | Description |
 |---------|-------------|
-| `/gate:validate-backlog` | Validate backlog compliance (score /100) |
-| `/gate:validate-prd` | Validate the PRD |
-| `/gate:validate-techspec` | Validate the technical spec |
-| `/gate:validate-story US-XXX` | Validate a User Story (DoD) |
-| `/gate:validate-sprint N` | Validate a sprint |
-| `/gate:report` | Full quality report |
+| `/gate:check backlog` | Validate backlog compliance (score /100) |
+| `/gate:check prd` | Validate the PRD |
+| `/gate:check spec` | Validate the technical spec |
+| `/gate:check story US-XXX` | Validate a User Story (DoD) |
+| `/gate:check sprint N` | Validate a sprint |
+| `/gate:check all` | Full quality report |
 
 ## Technical stack
 
@@ -102,13 +102,13 @@ project-management/
 │   └── user-stories/
 │       └── US-XXX-name.md        # INVEST + 3C + Gherkin SMART
 └── sprints/
-    └── sprint-XXX-goal/
+    └── sprint-{N}-{slug}/
         ├── sprint-goal.md        # Sprint Goal + Ceremonies + Retro
         ├── sprint-dependencies.md
-        ├── tasks/
-        │   ├── README.md
-        │   └── US-XXX-tasks.md   # Detailed tasks
-        └── task-board.md         # Kanban
+        ├── board.md              # Kanban
+        └── tasks/
+            ├── README.md
+            └── TASK-XXX.md       # One file per task
 ```
 
 ## Applied SCRUM standards
@@ -150,25 +150,25 @@ project-management/
 
 ```bash
 # 1. Initialize the backlog
-/project:generate-backlog
+/workflow:plan --only=backlog
 
 # 2. Validate compliance
-/gate:validate-backlog
+/gate:check backlog
 
 # 3. Plan sprint 1
-/project:decompose-tasks 001
+/workflow:start 001
 
 # 4. Get the next story
-/sprint:next-story
+/project:backlog next story
 
 # 5. Develop a story
-/sprint:dev US-XXX
+/workflow:implement US-XXX
 
 # 6. Track the sprint
-/sprint:status
+/workflow:status
 
 # 7. Prepare the next sprint
-/project:decompose-tasks 002
+/workflow:start 002
 ```
 
 ## Naming conventions
@@ -178,8 +178,8 @@ project-management/
 | Epic | EPIC-XXX-name | EPIC-001-authentication |
 | User Story | US-XXX-name | US-001-signup |
 | Persona | P-XXX | P-001 |
-| Sprint | sprint-XXX-goal | sprint-001-walking_skeleton |
-| Task | T-XXX-YY | T-001-05 |
+| Sprint | sprint-{N}-{slug} | sprint-1-walking_skeleton |
+| Task | TASK-XXX | TASK-005 |
 
 ## Code quality
 

package/Project/i18n/en/scaffold/project-management__README.md

@@ -12,7 +12,7 @@ project-management/
 │   ├── user-stories/         # User Stories
 │   └── tasks/                # Tasks not assigned to a sprint
 ├── sprints/
-│   └── sprint-XXX/
+│   └── sprint-{N}-{slug}/
 │       ├── sprint-goal.md    # Sprint goal and info
 │       ├── board.md          # Kanban board
 │       └── tasks/            # Sprint tasks
@@ -23,12 +23,12 @@ project-management/
 
 ## Workflow
 
-1. `/project:add-epic` - Create an EPIC
-2. `/project:add-story` - Add User Stories
-3. `/sprint:transition US-XXX sprint-N` - Plan the sprint
-4. `/project:add-task` or `/project:decompose-tasks` - Create tasks
-5. `/project:board` - Track progress
-6. `/project:move-task` - Update statuses
+1. `/project:backlog add epic` - Create an EPIC
+2. `/project:backlog add story` - Add User Stories
+3. `/project:backlog move story US-XXX sprint-N` - Plan the sprint
+4. `/project:backlog add task` or `/workflow:start` - Create tasks
+5. `/workflow:status --board` - Track progress
+6. `/project:backlog move task` - Update statuses
 
 ## Statuses
 

package/Project/i18n/en/templates/board.md

@@ -1,31 +1,44 @@
 # Sprint {NUMERO} - Kanban Board
 
+> **Generated view**: regenerated from `.bmad/sprint-status.yaml` by `/workflow:status --board`. Do not edit by hand.
 > **Sprint Goal**: {SPRINT_GOAL}
 > **Period**: {DATE_DEBUT} → {DATE_FIN}
 
 ---
 
-## 🔴 To Do
+## backlog
 
-_No tasks_
+_No stories_
 
 ---
 
-## 🟡 In Progress
+## ready-for-dev
 
-_No tasks_
+_No stories_
 
 ---
 
-## ⏸️ Blocked
+## in-progress
 
-_No blocked tasks_
+_No stories_
 
 ---
 
-## 🟢 Done
+## review
 
-_No completed tasks_
+_No stories_
+
+---
+
+## blocked
+
+_No blocked stories_
+
+---
+
+## done
+
+_No completed stories_
 
 ---
 
@@ -49,4 +62,4 @@ _No completed tasks_
 
 ---
 
-_Last updated: {DATE}_
+_Last generated: {DATE}_

package/Project/i18n/en/templates/epic.md

@@ -2,7 +2,7 @@
 
 ## Metadata
 - **ID**: EPIC-{ID}
-- **Status**: 🔴 To Do
+- **Status**: derived from its stories in .bmad/sprint-status.yaml
 - **Priority**: {PRIORITE}
 - **MMF**: {MINIMUM_MARKETABLE_FEATURE}
 - **Created on**: {DATE}
@@ -19,9 +19,9 @@
 
 ## User Stories
 
-| ID | Name | Status | Points | Sprint |
-|----|-----|--------|--------|--------|
-| - | - | - | - | - |
+| ID | Name | Points | Sprint |
+|----|-----|--------|--------|
+| - | - | - | - |
 
 ## Success Criteria
 

package/Project/i18n/en/templates/prd.md

@@ -235,7 +235,7 @@ Every functional requirement in section 5 uses a unique FR-xxx ID. These IDs ser
 | Covered by Code | {n} | {%} |
 | Covered by Tests | {n} | {%} |
 
-> Run `/project:coverage-map` to generate an up-to-date coverage report.
+> Run `/project:trace --gaps` to generate an up-to-date coverage report.
 > Run `/project:trace` to view the full bidirectional traceability matrix.
 
 ---

package/Project/i18n/en/templates/sprint-status.md

@@ -0,0 +1,60 @@
+# Sprint Status Schema (`.bmad/sprint-status.yaml`)
+
+`.bmad/sprint-status.yaml` is the **single source of truth for story and task STATUS**. Markdown files (`US-*.md`, `EPIC-*.md`, `TASK-*.md`, `board.md`) hold **content only**: no status field, no status emoji. Epic status is **derived** from its stories' statuses (never stored).
+
+- Story statuses: `backlog | ready-for-dev | in-progress | review | done | blocked`
+- Task statuses: `to-do | in-progress | done | blocked`
+- Story transitions follow the BMAD state machine (see `/project:backlog move story`).
+
+```yaml
+# .bmad/sprint-status.yaml
+version: "1.0"
+metadata:
+  sprint_id: "sprint-2"
+  name: "User management"
+  start_date: "2026-11-02"
+  end_date: "2026-11-13"
+  goal: "Users can sign up, log in and edit their profile"
+  capacity_points: 21
+stories:
+  US-010:
+    title: "User sign-up"
+    status: "in-progress"
+    previous_status: "ready-for-dev"
+    tdd_phase: "green"
+    story_points: 5
+    epic_id: "EPIC-002"
+    priority: "must"
+    dependencies: ["US-001"]
+    tasks:
+      total: 2
+      completed: 1
+      list: ["TASK-001", "TASK-002"]
+      status:
+        TASK-001: "done"
+        TASK-002: "in-progress"
+    history:
+      - timestamp: "2026-11-02T09:00:00Z"
+        from: "ready-for-dev"
+        to: "in-progress"
+        by: "dev"
+        reason: "Implementation started"
+archived_sprints:
+  sprint-1:
+    stories:
+      US-001: { status: "done", points: 5 }
+routing:
+  auto_transitions:
+    enabled: true
+    run_on_session_start: false
+    run_on_task_complete: true
+    rules: []
+```
+
+## Rules
+
+- Content (title, description, acceptance criteria, task details) is written in the markdown files; status is written only in this file.
+- `tasks.completed` is the count of tasks whose status is `done`; `tasks.total` is the length of `tasks.list`.
+- Every story transition updates `status` and `previous_status` and appends a `history` entry (`timestamp`, `from`, `to`, `by`, `reason`).
+- Epic status is computed from its stories (all `backlog` = not started, any other non-`done` = in progress, all `done` = done); it is never written anywhere.
+- If the file is missing, create it from the `/workflow:init` skeleton before writing.

package/Project/i18n/en/templates/task.md

@@ -4,7 +4,7 @@
 - **ID**: TASK-{ID}
 - **US**: {US_ID}
 - **Type**: {TYPE}
-- **Status**: 🔴 To Do
+- **Status**: tracked in .bmad/sprint-status.yaml
 - **Estimation**: {ESTIMATION}h
 - **Time spent**: 0h
 - **Created on**: {DATE}

package/Project/i18n/en/templates/user-story.md

@@ -4,7 +4,7 @@
 - **ID**: US-{ID}
 - **EPIC**: {EPIC_ID}
 - **Sprint**: {SPRINT}
-- **Status**: 🔴 To Do
+- **Status**: tracked in .bmad/sprint-status.yaml
 - **Points**: {POINTS}
 - **Persona**: {PERSONA_ID}
 - **Created on**: {DATE}
@@ -39,13 +39,15 @@ THEN {expected result}
 
 ## Tasks
 
-| ID | Type | Description | Status | Estimation |
-|----|------|-------------|--------|------------|
-| - | - | - | 🔴 | - |
+| ID | Type | Description | Estimation |
+|----|------|-------------|------------|
+| - | - | - | - |
+
+_Task statuses are tracked in `.bmad/sprint-status.yaml`._
 
 ## Progress
 
-0/0 tasks completed (0%)
+0/0 tasks completed (0%) <!-- derived from .bmad/sprint-status.yaml -->
 
 ## Definition of Done