@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/en/Common/commands/workflow-init.md

@@ -0,0 +1,257 @@
+---
+name: workflow-init
+description: Analyze project context and recommend the optimal development workflow track
+arguments:
+  - name: scope
+    description: Optional scope hint (bug, feature, platform, migration)
+    required: false
+  - name: track
+    description: Force a specific track (--quick, --standard, --enterprise)
+    required: false
+---
+
+# /workflow:init
+
+## Mission
+
+Analyze the current project context and recommend the optimal development workflow track. Initialize workflow tracking and guide the user through the appropriate phases.
+
+## Workflow
+
+### Step 1: Context Discovery
+
+```
+╔══════════════════════════════════════════════════════════╗
+║             WORKFLOW INITIALIZATION                       ║
+╠══════════════════════════════════════════════════════════╣
+║ Analyzing project context...                              ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+**Analyze:**
+
+1. **Project Structure**
+   - Check for `.claude/` directory
+   - Detect technology stack from files
+   - Identify framework (Symfony, Flutter, React, etc.)
+
+2. **Existing Documentation**
+   - `project-management/prd.md` - PRD exists?
+   - `project-management/tech-spec.md` - Tech Spec exists?
+   - `project-management/backlog/` - Backlog exists?
+   - `README.md` - Project description
+
+3. **Codebase Size**
+   - Count source files
+   - Estimate complexity
+   - Identify components/modules
+
+4. **Git Context**
+   - Current branch
+   - Recent commits
+   - Open changes
+
+### Step 2: Complexity Assessment
+
+**Scoring Matrix:**
+
+| Factor | Quick (1) | Standard (2) | Enterprise (3) |
+|--------|-----------|--------------|----------------|
+| Files to modify | 1-5 | 5-50 | 50+ |
+| New entities/tables | 0 | 1-3 | 4+ |
+| External integrations | 0 | 1 | 2+ |
+| User stories estimated | 1-3 | 3-15 | 15+ |
+| Teams involved | 1 | 1 | 2+ |
+| Security implications | Low | Medium | High |
+
+**Calculate Score:**
+- Score 6-8: Quick Flow
+- Score 9-14: Standard
+- Score 15+: Enterprise
+
+### Step 3: Track Recommendation
+
+```
+╔══════════════════════════════════════════════════════════╗
+║               PROJECT ANALYSIS COMPLETE                   ║
+╠══════════════════════════════════════════════════════════╣
+║ Project: my-awesome-app                                   ║
+║ Stack: Symfony 7.x + React 18                             ║
+║ Status: Existing project with backlog                     ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║ COMPLEXITY ASSESSMENT:                                    ║
+║ ├── Files impacted:      ~25        [Standard]            ║
+║ ├── New entities:        2          [Standard]            ║
+║ ├── Integrations:        1 (Stripe) [Standard]            ║
+║ ├── Estimated stories:   8          [Standard]            ║
+║ ├── Teams:               1          [Quick]               ║
+║ └── Security:            High       [Enterprise]          ║
+║                                                           ║
+║ ═══════════════════════════════════════════════════════  ║
+║ RECOMMENDED TRACK: STANDARD                               ║
+║ ═══════════════════════════════════════════════════════  ║
+║                                                           ║
+║ Reasoning:                                                ║
+║ • Feature scope requires planning (8 stories)             ║
+║ • External integration needs tech design                  ║
+║ • Security implications require careful architecture      ║
+║ • Single team can handle without full enterprise process  ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+### Step 4: Phase Planning
+
+Based on track, show the workflow:
+
+**Quick Flow:**
+```
+╔══════════════════════════════════════════════════════════╗
+║              QUICK FLOW WORKFLOW                          ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║  ┌──────────────────┐                                     ║
+║  │  IMPLEMENTATION  │ ← Start here                        ║
+║  └──────────────────┘                                     ║
+║                                                           ║
+║ No documentation required. Direct to coding.              ║
+║                                                           ║
+║ Commands:                                                 ║
+║ • /common:fix-bug-tdd    - Fix with TDD                   ║
+║ • /project:add-task      - Track the work                 ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+**Standard:**
+```
+╔══════════════════════════════════════════════════════════╗
+║              STANDARD WORKFLOW                            ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║  ┌──────────┐    ┌──────────┐    ┌──────────────┐        ║
+║  │ PLANNING │ →  │  DESIGN  │ →  │IMPLEMENTATION│        ║
+║  └──────────┘    └──────────┘    └──────────────┘        ║
+║       ↑                                                   ║
+║   Start here                                              ║
+║                                                           ║
+║ Phase 1 - Planning:                                       ║
+║ • /project:generate-prd    - Create/update PRD            ║
+║ • /project:generate-backlog - Create user stories         ║
+║                                                           ║
+║ Phase 2 - Design:                                         ║
+║ • /project:generate-tech-spec - Technical design          ║
+║                                                           ║
+║ Phase 3 - Implementation:                                 ║
+║ • /project:sprint-dev      - TDD/BDD development          ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+**Enterprise:**
+```
+╔══════════════════════════════════════════════════════════╗
+║              ENTERPRISE WORKFLOW                          ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║  ┌──────────┐  ┌──────────┐  ┌────────┐  ┌────────────┐  ║
+║  │ ANALYSIS │→ │ PLANNING │→ │ DESIGN │→ │IMPLEMENTATION│ ║
+║  └──────────┘  └──────────┘  └────────┘  └────────────┘  ║
+║       ↑                                                   ║
+║   Start here                                              ║
+║                                                           ║
+║ Phase 1 - Analysis:                                       ║
+║ • /workflow:analyze        - Research & exploration       ║
+║                                                           ║
+║ Phase 2 - Planning:                                       ║
+║ • /project:generate-prd    - Full PRD                     ║
+║ • /project:generate-backlog - Complete backlog            ║
+║                                                           ║
+║ Phase 3 - Design:                                         ║
+║ • /project:generate-tech-spec - Full tech spec            ║
+║ • /common:architecture-decision - ADRs                    ║
+║                                                           ║
+║ Phase 4 - Implementation:                                 ║
+║ • /project:sprint-dev      - Sprint-by-sprint dev         ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+### Step 5: Initialize Tracking
+
+Create workflow status file:
+
+```yaml
+# project-management/workflow-status.yaml
+project: my-awesome-app
+track: standard
+initialized_at: 2026-01-07T10:00:00Z
+current_phase: planning
+
+phases:
+  analysis:
+    status: skipped
+    reason: "Standard track - analysis not required"
+  planning:
+    status: pending
+    artifacts:
+      prd: pending
+      personas: pending
+      backlog: pending
+  design:
+    status: pending
+    artifacts:
+      tech_spec: pending
+      architecture: pending
+  implementation:
+    status: pending
+
+next_action: "Generate or update PRD"
+next_command: "/project:generate-prd"
+```
+
+### Step 6: Prompt Next Action
+
+```
+╔══════════════════════════════════════════════════════════╗
+║                    READY TO START                         ║
+╠══════════════════════════════════════════════════════════╣
+║ Workflow initialized: STANDARD track                      ║
+║ Status file: project-management/workflow-status.yaml      ║
+║                                                           ║
+║ ─────────────────────────────────────────────────────────║
+║ NEXT STEP: Planning Phase                                 ║
+║ ─────────────────────────────────────────────────────────║
+║                                                           ║
+║ Start with: /workflow:plan                                ║
+║                                                           ║
+║ Or jump to specific tasks:                                ║
+║ • /project:generate-prd     - Create requirements doc     ║
+║ • /project:generate-backlog - Create user stories         ║
+║                                                           ║
+║ Check progress anytime: /workflow:status                  ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+## Override Options
+
+```bash
+# Force specific track
+/workflow:init --quick          # Force Quick Flow
+/workflow:init --standard       # Force Standard
+/workflow:init --enterprise     # Force Enterprise
+
+# Provide scope hint
+/workflow:init bug              # Hint: this is a bug fix
+/workflow:init feature          # Hint: new feature
+/workflow:init platform         # Hint: platform work
+```
+
+## Related Commands
+
+- `/workflow:status` - Check current workflow progress
+- `/workflow:plan` - Start planning phase
+- `/workflow:design` - Start design phase
+- `/workflow:implement` - Start implementation phase
+- `/workflow:analyze` - Start analysis phase (Enterprise only)

package/Dev/i18n/en/Common/commands/workflow-plan.md

@@ -0,0 +1,224 @@
+---
+name: workflow-plan
+description: Execute the Planning phase - PRD creation, personas, and backlog generation
+arguments:
+  - name: continue
+    description: Continue from where left off
+    required: false
+---
+
+# /workflow:plan
+
+## Mission
+
+Execute the Planning phase of the development workflow. This phase focuses on creating the Product Requirements Document, defining personas, and generating the initial product backlog.
+
+## When to Use
+
+- **Standard** and **Enterprise** tracks
+- After `/workflow:init` (or `/workflow:analyze` for Enterprise)
+- When starting feature planning
+
+## Workflow
+
+### Step 1: Planning Setup
+
+```
+╔══════════════════════════════════════════════════════════╗
+║             PLANNING PHASE - STARTING                     ║
+╠══════════════════════════════════════════════════════════╣
+║ Track: Standard                                           ║
+║ Phase: 2 of 4 - Planning                                  ║
+║                                                           ║
+║ Objectives:                                               ║
+║ • Create or update Product Requirements Document          ║
+║ • Define user personas                                    ║
+║ • Generate product backlog with prioritized user stories  ║
+║ • Set success metrics and KPIs                            ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+### Step 2: Check Existing Artifacts
+
+```
+╔══════════════════════════════════════════════════════════╗
+║              EXISTING ARTIFACTS CHECK                     ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║ Checking project-management/ ...                          ║
+║                                                           ║
+║ PRD:                                                      ║
+║ ├── ❌ prd.md                    Not found               ║
+║                                                           ║
+║ Personas:                                                 ║
+║ ├── ❌ personas.md               Not found               ║
+║                                                           ║
+║ Backlog:                                                  ║
+║ ├── ❌ backlog/                  Not found               ║
+║                                                           ║
+║ Analysis (Enterprise):                                    ║
+║ ├── ✅ analysis/constraints.md   Available               ║
+║ └── ✅ analysis/research.md      Available               ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+### Step 3: Planning Tasks
+
+Execute planning tasks in order:
+
+```
+╔══════════════════════════════════════════════════════════╗
+║               PLANNING TASKS                              ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║ □ Task 1: Generate PRD                                    ║
+║   Command: /project:generate-prd                          ║
+║   Output: project-management/prd.md                       ║
+║                                                           ║
+║ □ Task 2: Define Personas                                 ║
+║   (Included in PRD generation)                            ║
+║   Output: project-management/personas.md                  ║
+║                                                           ║
+║ □ Task 3: Generate Backlog                                ║
+║   Command: /project:generate-backlog                      ║
+║   Output: project-management/backlog/                     ║
+║                                                           ║
+║ □ Task 4: Validate Backlog                                ║
+║   Command: /project:validate-backlog                      ║
+║   Ensures SCRUM compliance                                ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+### Step 4: Execute PRD Generation
+
+Invoke the PRD generation command:
+
+```
+Starting /project:generate-prd...
+
+[PRD generation workflow runs]
+
+✅ PRD created: project-management/prd.md
+✅ Personas extracted: project-management/personas.md
+```
+
+### Step 5: Execute Backlog Generation
+
+After PRD is complete:
+
+```
+Starting /project:generate-backlog...
+
+Using PRD as input:
+• 3 personas identified
+• 12 functional requirements extracted
+• 8 non-functional requirements noted
+
+Generating backlog structure...
+
+[Backlog generation workflow runs]
+
+✅ Backlog created with:
+   • 4 EPICs
+   • 18 User Stories
+   • Sprint 1 planned (Walking Skeleton)
+```
+
+### Step 6: Validation
+
+Run backlog validation:
+
+```
+╔══════════════════════════════════════════════════════════╗
+║              BACKLOG VALIDATION                           ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║ INVEST Criteria Check:                                    ║
+║ ├── Independent:    18/18 ✅                              ║
+║ ├── Negotiable:     18/18 ✅                              ║
+║ ├── Valuable:       18/18 ✅                              ║
+║ ├── Estimable:      18/18 ✅                              ║
+║ ├── Sized (≤8pts):  16/18 ⚠️  (2 stories need split)     ║
+║ └── Testable:       18/18 ✅                              ║
+║                                                           ║
+║ 3C Criteria Check:                                        ║
+║ ├── Card:           18/18 ✅                              ║
+║ ├── Conversation:   18/18 ✅                              ║
+║ └── Confirmation:   18/18 ✅                              ║
+║                                                           ║
+║ Acceptance Criteria (Gherkin):                            ║
+║ └── Valid format:   18/18 ✅                              ║
+║                                                           ║
+║ WARNINGS:                                                 ║
+║ • US-007: 13 points - consider splitting                  ║
+║ • US-012: 21 points - must be split                       ║
+║                                                           ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+### Step 7: Phase Completion
+
+```
+╔══════════════════════════════════════════════════════════╗
+║             PLANNING PHASE COMPLETE                       ║
+╠══════════════════════════════════════════════════════════╣
+║                                                           ║
+║ Artifacts Created:                                        ║
+║ ✅ prd.md              Product Requirements Document      ║
+║ ✅ personas.md         3 user personas                    ║
+║ ✅ backlog/            Complete SCRUM backlog             ║
+║    ├── epics/          4 EPICs                            ║
+║    └── user-stories/   18 User Stories                    ║
+║                                                           ║
+║ Summary:                                                  ║
+║ • Total Story Points: 89                                  ║
+║ • Sprint 1 Scope: 21 points (Walking Skeleton)            ║
+║ • Estimated Sprints: 4-5                                  ║
+║                                                           ║
+║ ─────────────────────────────────────────────────────────║
+║ NEXT PHASE: Design (Solutioning)                          ║
+║ Command: /workflow:design                                 ║
+║ ─────────────────────────────────────────────────────────║
+║                                                           ║
+║ The tech spec will be based on PRD requirements.          ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+## Agents Involved
+
+- **product-owner**: PRD creation, persona definition, prioritization
+- **tech-lead**: Technical feasibility review, estimation guidance
+
+## Output Files
+
+| File | Purpose |
+|------|---------|
+| `prd.md` | Product Requirements Document |
+| `personas.md` | User persona definitions |
+| `backlog/epics/` | EPIC definitions |
+| `backlog/user-stories/` | User Story files |
+| `sprints/sprint-001/` | First sprint structure |
+
+## Continue Option
+
+If interrupted, use `--continue` to resume:
+
+```bash
+/workflow:plan --continue
+
+# Detects:
+# ✅ PRD complete
+# ⏳ Backlog in progress (12/18 stories)
+# → Continues from story 13
+```
+
+## Related Commands
+
+- `/workflow:init` - Initialize workflow
+- `/workflow:analyze` - Previous phase (Enterprise)
+- `/workflow:design` - Next phase
+- `/workflow:status` - Check progress
+- `/project:generate-prd` - Direct PRD generation
+- `/project:generate-backlog` - Direct backlog generation