@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/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

package/Dev/i18n/es/Common/commands/workflow-status.md

@@ -0,0 +1,292 @@
+---
+name: workflow-status
+description: Display current workflow progress and next recommended actions
+arguments:
+  - name: verbose
+    description: Show detailed status with all artifacts
+    required: false
+---
+
+# /workflow:status
+
+## Mission
+
+Display the current state of the development workflow, including completed phases, current progress, and recommended next actions.
+
+## Usage
+
+```bash
+/workflow:status           # Standard status view
+/workflow:status --verbose # Detailed view with all artifacts
+```
+
+## Output Format
+
+### Standard View
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                       WORKFLOW STATUS                             ║
+╠══════════════════════════════════════════════════════════════════╣
+║ Project: my-awesome-app                                           ║
+║ Track: STANDARD                                                   ║
+║ Started: 2026-01-07                                               ║
+║ Current Phase: Design ████████████░░░░ 75%                        ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║  Phase 1: Analysis                                                ║
+║  └── ⏭️  Skipped (Standard track)                                 ║
+║                                                                   ║
+║  Phase 2: Planning                                                ║
+║  └── ✅ Complete                                                  ║
+║      ├── PRD: ✅ Complete                                         ║
+║      ├── Personas: ✅ 3 defined                                   ║
+║      └── Backlog: ✅ 18 stories (89 pts)                          ║
+║                                                                   ║
+║  Phase 3: Design                                                  ║
+║  └── 🔄 In Progress                                               ║
+║      ├── Tech Spec: ✅ Complete                                   ║
+║      ├── Architecture: ✅ C4 diagrams created                     ║
+║      ├── API Design: 🔄 In Progress (18/24 endpoints)             ║
+║      └── ADRs: ✅ 3 created                                       ║
+║                                                                   ║
+║  Phase 4: Implementation                                          ║
+║  └── ⏳ Pending                                                   ║
+║      └── Sprint 1: Ready to start (21 pts)                        ║
+║                                                                   ║
+╠══════════════════════════════════════════════════════════════════╣
+║ NEXT ACTION: Complete API design                                  ║
+║ COMMAND: /workflow:design --continue                              ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### Verbose View (--verbose)
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                   WORKFLOW STATUS (VERBOSE)                       ║
+╠══════════════════════════════════════════════════════════════════╣
+║ Project: my-awesome-app                                           ║
+║ Track: STANDARD                                                   ║
+║ Started: 2026-01-07T10:00:00Z                                     ║
+║ Last Update: 2026-01-07T15:30:00Z                                 ║
+║ Status File: project-management/workflow-status.yaml              ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║ ══════════════════════════════════════════════════════════════   ║
+║ PHASE 2: PLANNING (Complete)                                      ║
+║ ══════════════════════════════════════════════════════════════   ║
+║                                                                   ║
+║ PRD: project-management/prd.md                                    ║
+║ ├── Version: 1.0                                                  ║
+║ ├── Functional Requirements: 12                                   ║
+║ ├── Non-Functional Requirements: 8                                ║
+║ ├── Success Metrics: 5 KPIs defined                               ║
+║ └── Last Modified: 2026-01-07T11:00:00Z                           ║
+║                                                                   ║
+║ Personas: project-management/personas.md                          ║
+║ ├── Primary: Business Owner, Freelancer                           ║
+║ └── Secondary: Accountant                                         ║
+║                                                                   ║
+║ Backlog: project-management/backlog/                              ║
+║ ├── EPICs: 4                                                      ║
+║ │   ├── EPIC-001: User Management (21 pts)                        ║
+║ │   ├── EPIC-002: Payment Integration (24 pts)                    ║
+║ │   ├── EPIC-003: Reporting (23 pts)                              ║
+║ │   └── EPIC-004: Notifications (21 pts)                          ║
+║ ├── User Stories: 18                                              ║
+║ │   ├── P0 (Must Have): 8 stories                                 ║
+║ │   ├── P1 (Should Have): 6 stories                               ║
+║ │   └── P2 (Nice to Have): 4 stories                              ║
+║ └── Total Story Points: 89                                        ║
+║                                                                   ║
+║ Sprints Planned:                                                  ║
+║ ├── Sprint 1: Walking Skeleton (21 pts) - 5 stories               ║
+║ ├── Sprint 2: Core Features (28 pts) - 6 stories                  ║
+║ ├── Sprint 3: Payments (24 pts) - 4 stories                       ║
+║ └── Sprint 4: Polish (16 pts) - 3 stories                         ║
+║                                                                   ║
+║ ══════════════════════════════════════════════════════════════   ║
+║ PHASE 3: DESIGN (In Progress - 75%)                               ║
+║ ══════════════════════════════════════════════════════════════   ║
+║                                                                   ║
+║ Tech Spec: project-management/tech-spec.md ✅                     ║
+║ ├── Version: 1.0                                                  ║
+║ ├── Architecture: Clean Architecture (Hexagonal)                  ║
+║ ├── Stack: Symfony 7.x + React 18 + PostgreSQL 16                 ║
+║ └── Integrations: Stripe, SendGrid, AWS S3                        ║
+║                                                                   ║
+║ Architecture: project-management/architecture/ ✅                 ║
+║ ├── c4-context.md - System context diagram                        ║
+║ ├── c4-container.md - Container diagram                           ║
+║ ├── c4-component.md - Component diagram                           ║
+║ └── erd.md - Entity Relationship Diagram (8 entities)             ║
+║                                                                   ║
+║ API Design: project-management/architecture/api.md 🔄             ║
+║ ├── Designed: 18 endpoints                                        ║
+║ ├── Remaining: 6 endpoints                                        ║
+║ └── Auth: JWT with refresh tokens                                 ║
+║                                                                   ║
+║ ADRs: docs/adr/ ✅                                                ║
+║ ├── ADR-001: Database (PostgreSQL)                                ║
+║ ├── ADR-002: API Style (REST)                                     ║
+║ └── ADR-003: Authentication (JWT)                                 ║
+║                                                                   ║
+║ Security: project-management/architecture/security.md ⏳          ║
+║ └── Status: Pending                                               ║
+║                                                                   ║
+║ ══════════════════════════════════════════════════════════════   ║
+║ PHASE 4: IMPLEMENTATION (Pending)                                 ║
+║ ══════════════════════════════════════════════════════════════   ║
+║                                                                   ║
+║ Sprint 1: sprint-001-walking-skeleton                             ║
+║ ├── Status: Ready to start                                        ║
+║ ├── Stories: 5                                                    ║
+║ ├── Points: 21                                                    ║
+║ └── Tasks: 0 (not yet decomposed)                                 ║
+║                                                                   ║
+╠══════════════════════════════════════════════════════════════════╣
+║ WORKFLOW HEALTH                                                   ║
+╠══════════════════════════════════════════════════════════════════╣
+║ ✅ PRD aligns with backlog                                        ║
+║ ✅ Tech spec covers all requirements                              ║
+║ ✅ Architecture documented                                        ║
+║ ⚠️  API design incomplete (6 endpoints remaining)                 ║
+║ ⚠️  Security review pending                                       ║
+╠══════════════════════════════════════════════════════════════════╣
+║ NEXT ACTIONS                                                      ║
+╠══════════════════════════════════════════════════════════════════╣
+║ 1. Complete API design (6 remaining endpoints)                    ║
+║    Command: /workflow:design --continue                           ║
+║                                                                   ║
+║ 2. Complete security review                                       ║
+║    Command: (included in design phase)                            ║
+║                                                                   ║
+║ 3. Then start implementation                                      ║
+║    Command: /workflow:implement                                   ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### No Workflow Initialized
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                       WORKFLOW STATUS                             ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║  ⚠️  No workflow initialized for this project                     ║
+║                                                                   ║
+║  To get started, run:                                             ║
+║                                                                   ║
+║    /workflow:init                                                 ║
+║                                                                   ║
+║  This will:                                                       ║
+║  • Analyze your project context                                   ║
+║  • Recommend the appropriate track (Quick/Standard/Enterprise)    ║
+║  • Initialize workflow tracking                                   ║
+║  • Guide you through the development phases                       ║
+║                                                                   ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+### Quick Flow Status
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                       WORKFLOW STATUS                             ║
+╠══════════════════════════════════════════════════════════════════╣
+║ Project: my-awesome-app                                           ║
+║ Track: QUICK FLOW                                                 ║
+║ Started: 2026-01-07                                               ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║  Quick Flow - Direct Implementation                               ║
+║  └── 🔄 In Progress                                               ║
+║                                                                   ║
+║  No phases required for Quick Flow.                               ║
+║  Working directly on implementation.                              ║
+║                                                                   ║
+║  Current Task (if tracked):                                       ║
+║  └── TASK-042: Fix login validation bug                           ║
+║      Status: In Progress                                          ║
+║                                                                   ║
+╠══════════════════════════════════════════════════════════════════╣
+║ COMMANDS AVAILABLE                                                ║
+╠══════════════════════════════════════════════════════════════════╣
+║ • /common:fix-bug-tdd     - Continue with TDD approach            ║
+║ • /project:move-task done - Mark task complete                    ║
+║ • /workflow:init          - Start new workflow                    ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+## Status File Structure
+
+The status is read from `project-management/workflow-status.yaml`:
+
+```yaml
+project: my-awesome-app
+track: standard  # quick | standard | enterprise
+initialized_at: 2026-01-07T10:00:00Z
+updated_at: 2026-01-07T15:30:00Z
+current_phase: design
+
+phases:
+  analysis:
+    status: skipped  # pending | in_progress | complete | skipped
+    reason: "Standard track - analysis not required"
+  planning:
+    status: complete
+    completed_at: 2026-01-07T12:00:00Z
+    artifacts:
+      prd:
+        status: complete
+        path: project-management/prd.md
+      personas:
+        status: complete
+        path: project-management/personas.md
+        count: 3
+      backlog:
+        status: complete
+        path: project-management/backlog/
+        epics: 4
+        stories: 18
+        points: 89
+  design:
+    status: in_progress
+    started_at: 2026-01-07T12:00:00Z
+    progress: 75
+    artifacts:
+      tech_spec:
+        status: complete
+        path: project-management/tech-spec.md
+      architecture:
+        status: complete
+        path: project-management/architecture/
+      api_design:
+        status: in_progress
+        progress: "18/24 endpoints"
+      adrs:
+        status: complete
+        count: 3
+        path: docs/adr/
+      security:
+        status: pending
+  implementation:
+    status: pending
+    sprints:
+      - name: sprint-001-walking-skeleton
+        status: pending
+        points: 21
+        stories: 5
+
+next_action: "Complete API design"
+next_command: "/workflow:design --continue"
+```
+
+## Related Commands
+
+- `/workflow:init` - Initialize new workflow
+- `/workflow:analyze` - Analysis phase
+- `/workflow:plan` - Planning phase
+- `/workflow:design` - Design phase
+- `/workflow:implement` - Implementation phase

package/Dev/i18n/es/Common/hooks/HOOKS-QUICKSTART.md

@@ -0,0 +1,46 @@
+# Hooks Quick Start Guide
+
+This directory contains Claude Code hooks for automated quality control and workflow enhancement.
+
+## Setup
+
+1. **Copy hooks to your project:**
+   ```bash
+   cp -r .claude/hooks/scripts/* .claude/hooks/
+   chmod +x .claude/hooks/*.sh
+   ```
+
+2. **Enable hooks in settings.json:**
+   Copy the configuration from `hooks/templates/settings-hooks.json` to your `.claude/settings.json`.
+
+3. **Customize as needed** - Edit the scripts to match your project's tooling.
+
+## Available Hooks
+
+| Hook | Purpose | Event |
+|------|---------|-------|
+| `pre-commit-check.sh` | Block secrets in commits | PreToolUse |
+| `post-edit-lint.sh` | Auto-lint on file save | PostToolUse |
+| `quality-gate.sh` | Run tests before completion | Stop |
+| `session-init.sh` | Load project context | SessionStart |
+| `notify-slack.sh` | Slack notifications | Notification |
+| `block-dangerous-commands.sh` | Block rm -rf, sudo, etc. | PreToolUse |
+
+## Quick Enable
+
+Add to your `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "Stop": [{
+      "matcher": "",
+      "hooks": [{"type": "command", "command": ".claude/hooks/quality-gate.sh"}]
+    }]
+  }
+}
+```
+
+## More Information
+
+See the full documentation: [docs/HOOKS.md](/docs/HOOKS.md)

package/Dev/i18n/es/Common/hooks/scripts/block-dangerous-commands.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# PreToolUse hook: Block dangerous shell commands
+# Exit code 2 = block the command
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+# Dangerous patterns to block
+DANGEROUS_PATTERNS=(
+    "rm -rf /"
+    "rm -rf /*"
+    "rm -rf ~"
+    ":(){:|:&};:"          # Fork bomb
+    "dd if=/dev/zero"
+    "mkfs"
+    "chmod -R 777 /"
+    "chown -R"
+    "> /dev/sda"
+    "mv /* /dev/null"
+)
+
+# Check for dangerous patterns
+for pattern in "${DANGEROUS_PATTERNS[@]}"; do
+    if echo "$COMMAND" | grep -qF "$pattern"; then
+        echo "BLOCKED: Dangerous command detected: $pattern" >&2
+        exit 2
+    fi
+done
+
+# Check for commands that modify system files
+if echo "$COMMAND" | grep -qE "^(sudo|su)\s"; then
+    echo "BLOCKED: Elevated privilege commands not allowed" >&2
+    exit 2
+fi
+
+# Check for commands that could expose secrets
+if echo "$COMMAND" | grep -qE "cat.*\.env|cat.*credentials|cat.*secret"; then
+    echo "BLOCKED: Command might expose secrets" >&2
+    exit 2
+fi
+
+# All checks passed
+exit 0

package/Dev/i18n/es/Common/hooks/scripts/notify-slack.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Notification hook: Send Slack notification when permission is requested
+# This runs on Notification event with matcher "permission_prompt"
+#
+# SETUP: Set SLACK_WEBHOOK_URL environment variable
+# Get webhook URL from: https://api.slack.com/apps -> Incoming Webhooks
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+MESSAGE=$(echo "$INPUT" | jq -r '.message // "Claude Code notification"')
+NOTIFICATION_TYPE=$(echo "$INPUT" | jq -r '.notification_type // "unknown"')
+
+# Only proceed if webhook URL is configured
+if [ -z "$SLACK_WEBHOOK_URL" ]; then
+    exit 0
+fi
+
+# Format message based on notification type
+case "$NOTIFICATION_TYPE" in
+    permission_prompt)
+        SLACK_MESSAGE=":bell: Claude Code needs your attention: $MESSAGE"
+        ;;
+    idle_prompt)
+        SLACK_MESSAGE=":sleeping: Claude Code has been idle for 60+ seconds"
+        ;;
+    *)
+        SLACK_MESSAGE=":robot_face: Claude Code: $MESSAGE"
+        ;;
+esac
+
+# Send to Slack
+curl -s -X POST \
+    -H 'Content-type: application/json' \
+    --data "{\"text\":\"$SLACK_MESSAGE\"}" \
+    "$SLACK_WEBHOOK_URL" > /dev/null 2>&1 || true
+
+exit 0