@the-bearded-bear/claude-craft 8.19.1 → 8.19.2

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

@@ -0,0 +1,208 @@
+# Claude Code Configuration - Project Management
+
+## Available agents
+
+### 🎯 Product Owner (`@po`)
+Expert in backlog management, personas, User Stories and prioritization.
+- CSPO certified (Certified Scrum Product Owner)
+- Skilled in: INVEST, 3C, Gherkin, SMART, MoSCoW, MMF
+
+### 🔧 Tech Lead (`@tech`)
+Expert in architecture, technical decomposition and Scrum facilitation.
+- CSM certified (Certified Scrum Master)
+- Skilled in: Symfony, Flutter, API Platform, Hexagonal Architecture
+
+## Custom commands
+
+### Backlog Generation & Management (`/project:`)
+
+| 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+## Technical stack
+
+```yaml
+web: Symfony UX + Turbo (Twig, Stimulus, Live Components)
+mobile: Flutter (Dart, Material/Cupertino)
+api: API Platform (REST, OpenAPI)
+database: PostgreSQL + Doctrine ORM
+infrastructure: Docker
+tests: PHPUnit, Flutter Test
+quality: PHPStan max, Dart analyzer
+```
+
+## Project structure
+
+```
+project-management/
+├── README.md                     # Overview
+├── personas.md                   # Persona definitions (min 3)
+├── definition-of-done.md         # Project DoD
+├── dependencies-matrix.md        # Dependencies matrix (Mermaid)
+├── backlog/
+│   ├── epics/
+│   │   └── EPIC-XXX-name.md      # With MMF
+│   └── user-stories/
+│       └── US-XXX-name.md        # INVEST + 3C + Gherkin SMART
+└── sprints/
+    └── sprint-XXX-goal/
+        ├── sprint-goal.md        # Sprint Goal + Ceremonies + Retro
+        ├── sprint-dependencies.md
+        ├── tasks/
+        │   ├── README.md
+        │   └── US-XXX-tasks.md   # Detailed tasks
+        └── task-board.md         # Kanban
+```
+
+## Applied SCRUM standards
+
+### Fundamentals
+- **3 Pillars**: Transparency, Inspection, Adaptation
+- **Agile Manifesto**: 4 values, 12 principles
+- **Sprint**: fixed 2 weeks
+- **Velocity**: 20-40 points/sprint
+
+### User Stories
+- Format: "As a [P-XXX]... I want... So that..."
+- **INVEST** validation: Independent, Negotiable, Valuable, Estimable, Sized ≤8pts, Testable
+- The **3 Cs**: Card, Conversation, Confirmation
+- **Vertical Slicing**: Symfony + Flutter + API + PostgreSQL
+
+### Acceptance Criteria
+- **Gherkin** format: GIVEN [context] / WHEN [actor] [action] / THEN [result]
+- **SMART** validation: Specific, Measurable, Achievable, Realistic, Time-bound
+- Minimum: 1 nominal + 2 alternative + 2 error cases
+
+### Epics
+- **MMF** (Minimum Marketable Feature) mandatory
+- Dependencies with a **Mermaid** graph
+
+### Sprints
+- Sprint 1 = **Walking Skeleton** (minimal complete feature)
+- **Sprint Goal** in one sentence
+- **Ceremonies**: Planning (Part 1 & 2), Daily, Review, Retro, Refinement
+- Retrospective **Prime Directive** included
+
+### Tasks
+- Estimation in **hours** (0.5h - 8h max)
+- Types: [DB], [BE], [FE-WEB], [FE-MOB], [TEST], [DOC], [REV], [OPS]
+- Dependencies with a **Mermaid** graph
+- Statuses: 🔲 To Do | 🔄 In Progress | 👀 Review | ✅ Done | 🚫 Blocked
+
+## Recommended workflow
+
+```bash
+# 1. Initialize the backlog
+/project:generate-backlog
+
+# 2. Validate compliance
+/gate:validate-backlog
+
+# 3. Plan sprint 1
+/project:decompose-tasks 001
+
+# 4. Get the next story
+/sprint:next-story
+
+# 5. Develop a story
+/sprint:dev US-XXX
+
+# 6. Track the sprint
+/sprint:status
+
+# 7. Prepare the next sprint
+/project:decompose-tasks 002
+```
+
+## Naming conventions
+
+| Element | Format | Example |
+|---------|--------|---------|
+| 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 |
+
+## Code quality
+
+### Backend (Symfony)
+- PHPStan max level
+- Tests > 80% coverage
+- Hexagonal architecture
+- PSR-12
+
+### Mobile (Flutter)
+- Strict Dart analyzer
+- Widget tests
+- BLoC/Riverpod
+- Material Design 3
+
+### API (API Platform)
+- Auto-generated OpenAPI
+- Validation constraints
+- Serialization groups
+- Security voters

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

@@ -0,0 +1,40 @@
+# Project Management
+
+This directory contains the project management.
+
+## Structure
+
+```
+project-management/
+├── backlog/
+│   ├── index.md              # Index with all statuses
+│   ├── epics/                # Project EPICs
+│   ├── user-stories/         # User Stories
+│   └── tasks/                # Tasks not assigned to a sprint
+├── sprints/
+│   └── sprint-XXX/
+│       ├── sprint-goal.md    # Sprint goal and info
+│       ├── board.md          # Kanban board
+│       └── tasks/            # Sprint tasks
+└── metrics/
+    ├── velocity.md           # Velocity per sprint
+    └── burndown.md           # Burndown charts
+```
+
+## 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
+
+## Statuses
+
+| Icon | Status | Description |
+|------|--------|-------------|
+| 🔴 | To Do | Not started yet |
+| 🟡 | In Progress | In progress |
+| ⏸️ | Blocked | Blocked |
+| 🟢 | Done | Completed |

package/Project/i18n/de/scaffold/project-management__backlog__index.md

@@ -0,0 +1,58 @@
+# Backlog Index
+
+> Last updated: $(date +%Y-%m-%d)
+
+---
+
+## Global Summary
+
+| Type | 🔴 To Do | 🟡 In Progress | ⏸️ Blocked | 🟢 Done | Total |
+|------|----------|----------------|------------|---------|-------|
+| EPICs | 0 | 0 | 0 | 0 | 0 |
+| User Stories | 0 | 0 | 0 | 0 | 0 |
+| Tasks | 0 | 0 | 0 | 0 | 0 |
+
+---
+
+## EPICs
+
+| ID | Name | Status | Priority | US | Progress |
+|----|------|--------|----------|-----|----------|
+| - | No EPIC created | - | - | - | - |
+
+---
+
+## Current Sprint
+
+_No active sprint_
+
+---
+
+## Prioritized Backlog (Outside Sprint)
+
+| US | EPIC | Points | Priority | Status |
+|----|------|--------|----------|--------|
+| - | - | - | - | - |
+
+---
+
+## Status Legend
+
+| Icon | Status | Description |
+|------|--------|-------------|
+| 🔴 | To Do | Not started yet |
+| 🟡 | In Progress | Being worked on |
+| ⏸️ | Blocked | Blocked by an impediment |
+| 🟢 | Done | Completed |
+
+### Workflow
+
+```
+🔴 To Do ──→ 🟡 In Progress ──→ 🟢 Done
+     │              │
+     │              ↓
+     └────→ ⏸️ Blocked ←────┘
+                │
+                ↓
+           🟡 In Progress
+```

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

@@ -0,0 +1,208 @@
+# Claude Code Configuration - Project Management
+
+## Available agents
+
+### 🎯 Product Owner (`@po`)
+Expert in backlog management, personas, User Stories and prioritization.
+- CSPO certified (Certified Scrum Product Owner)
+- Skilled in: INVEST, 3C, Gherkin, SMART, MoSCoW, MMF
+
+### 🔧 Tech Lead (`@tech`)
+Expert in architecture, technical decomposition and Scrum facilitation.
+- CSM certified (Certified Scrum Master)
+- Skilled in: Symfony, Flutter, API Platform, Hexagonal Architecture
+
+## Custom commands
+
+### Backlog Generation & Management (`/project:`)
+
+| 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+### 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 |
+
+## Technical stack
+
+```yaml
+web: Symfony UX + Turbo (Twig, Stimulus, Live Components)
+mobile: Flutter (Dart, Material/Cupertino)
+api: API Platform (REST, OpenAPI)
+database: PostgreSQL + Doctrine ORM
+infrastructure: Docker
+tests: PHPUnit, Flutter Test
+quality: PHPStan max, Dart analyzer
+```
+
+## Project structure
+
+```
+project-management/
+├── README.md                     # Overview
+├── personas.md                   # Persona definitions (min 3)
+├── definition-of-done.md         # Project DoD
+├── dependencies-matrix.md        # Dependencies matrix (Mermaid)
+├── backlog/
+│   ├── epics/
+│   │   └── EPIC-XXX-name.md      # With MMF
+│   └── user-stories/
+│       └── US-XXX-name.md        # INVEST + 3C + Gherkin SMART
+└── sprints/
+    └── sprint-XXX-goal/
+        ├── sprint-goal.md        # Sprint Goal + Ceremonies + Retro
+        ├── sprint-dependencies.md
+        ├── tasks/
+        │   ├── README.md
+        │   └── US-XXX-tasks.md   # Detailed tasks
+        └── task-board.md         # Kanban
+```
+
+## Applied SCRUM standards
+
+### Fundamentals
+- **3 Pillars**: Transparency, Inspection, Adaptation
+- **Agile Manifesto**: 4 values, 12 principles
+- **Sprint**: fixed 2 weeks
+- **Velocity**: 20-40 points/sprint
+
+### User Stories
+- Format: "As a [P-XXX]... I want... So that..."
+- **INVEST** validation: Independent, Negotiable, Valuable, Estimable, Sized ≤8pts, Testable
+- The **3 Cs**: Card, Conversation, Confirmation
+- **Vertical Slicing**: Symfony + Flutter + API + PostgreSQL
+
+### Acceptance Criteria
+- **Gherkin** format: GIVEN [context] / WHEN [actor] [action] / THEN [result]
+- **SMART** validation: Specific, Measurable, Achievable, Realistic, Time-bound
+- Minimum: 1 nominal + 2 alternative + 2 error cases
+
+### Epics
+- **MMF** (Minimum Marketable Feature) mandatory
+- Dependencies with a **Mermaid** graph
+
+### Sprints
+- Sprint 1 = **Walking Skeleton** (minimal complete feature)
+- **Sprint Goal** in one sentence
+- **Ceremonies**: Planning (Part 1 & 2), Daily, Review, Retro, Refinement
+- Retrospective **Prime Directive** included
+
+### Tasks
+- Estimation in **hours** (0.5h - 8h max)
+- Types: [DB], [BE], [FE-WEB], [FE-MOB], [TEST], [DOC], [REV], [OPS]
+- Dependencies with a **Mermaid** graph
+- Statuses: 🔲 To Do | 🔄 In Progress | 👀 Review | ✅ Done | 🚫 Blocked
+
+## Recommended workflow
+
+```bash
+# 1. Initialize the backlog
+/project:generate-backlog
+
+# 2. Validate compliance
+/gate:validate-backlog
+
+# 3. Plan sprint 1
+/project:decompose-tasks 001
+
+# 4. Get the next story
+/sprint:next-story
+
+# 5. Develop a story
+/sprint:dev US-XXX
+
+# 6. Track the sprint
+/sprint:status
+
+# 7. Prepare the next sprint
+/project:decompose-tasks 002
+```
+
+## Naming conventions
+
+| Element | Format | Example |
+|---------|--------|---------|
+| 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 |
+
+## Code quality
+
+### Backend (Symfony)
+- PHPStan max level
+- Tests > 80% coverage
+- Hexagonal architecture
+- PSR-12
+
+### Mobile (Flutter)
+- Strict Dart analyzer
+- Widget tests
+- BLoC/Riverpod
+- Material Design 3
+
+### API (API Platform)
+- Auto-generated OpenAPI
+- Validation constraints
+- Serialization groups
+- Security voters

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

@@ -0,0 +1,40 @@
+# Project Management
+
+This directory contains the project management.
+
+## Structure
+
+```
+project-management/
+├── backlog/
+│   ├── index.md              # Index with all statuses
+│   ├── epics/                # Project EPICs
+│   ├── user-stories/         # User Stories
+│   └── tasks/                # Tasks not assigned to a sprint
+├── sprints/
+│   └── sprint-XXX/
+│       ├── sprint-goal.md    # Sprint goal and info
+│       ├── board.md          # Kanban board
+│       └── tasks/            # Sprint tasks
+└── metrics/
+    ├── velocity.md           # Velocity per sprint
+    └── burndown.md           # Burndown charts
+```
+
+## 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
+
+## Statuses
+
+| Icon | Status | Description |
+|------|--------|-------------|
+| 🔴 | To Do | Not started yet |
+| 🟡 | In Progress | In progress |
+| ⏸️ | Blocked | Blocked |
+| 🟢 | Done | Completed |

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

@@ -0,0 +1,58 @@
+# Backlog Index
+
+> Last updated: $(date +%Y-%m-%d)
+
+---
+
+## Global Summary
+
+| Type | 🔴 To Do | 🟡 In Progress | ⏸️ Blocked | 🟢 Done | Total |
+|------|----------|----------------|------------|---------|-------|
+| EPICs | 0 | 0 | 0 | 0 | 0 |
+| User Stories | 0 | 0 | 0 | 0 | 0 |
+| Tasks | 0 | 0 | 0 | 0 | 0 |
+
+---
+
+## EPICs
+
+| ID | Name | Status | Priority | US | Progress |
+|----|------|--------|----------|-----|----------|
+| - | No EPIC created | - | - | - | - |
+
+---
+
+## Current Sprint
+
+_No active sprint_
+
+---
+
+## Prioritized Backlog (Outside Sprint)
+
+| US | EPIC | Points | Priority | Status |
+|----|------|--------|----------|--------|
+| - | - | - | - | - |
+
+---
+
+## Status Legend
+
+| Icon | Status | Description |
+|------|--------|-------------|
+| 🔴 | To Do | Not started yet |
+| 🟡 | In Progress | Being worked on |
+| ⏸️ | Blocked | Blocked by an impediment |
+| 🟢 | Done | Completed |
+
+### Workflow
+
+```
+🔴 To Do ──→ 🟡 In Progress ──→ 🟢 Done
+     │              │
+     │              ↓
+     └────→ ⏸️ Blocked ←────┘
+                │
+                ↓
+           🟡 In Progress
+```