@the-bearded-bear/claude-craft 3.0.0

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

package/Dev/i18n/pt/Common/hooks/scripts/post-edit-lint.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# Post-edit hook: Auto-lint modified files
+# This hook runs after Write or Edit operations
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract the file path that was modified
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+if [ -z "$FILE_PATH" ]; then
+    exit 0
+fi
+
+# Get file extension
+EXT="${FILE_PATH##*.}"
+
+# Run appropriate linter based on file type
+case "$EXT" in
+    js|jsx|ts|tsx)
+        if command -v npx &> /dev/null && [ -f "package.json" ]; then
+            npx eslint --fix "$FILE_PATH" 2>/dev/null || true
+        fi
+        ;;
+    php)
+        if command -v php-cs-fixer &> /dev/null; then
+            php-cs-fixer fix "$FILE_PATH" --quiet 2>/dev/null || true
+        elif command -v vendor/bin/php-cs-fixer &> /dev/null; then
+            vendor/bin/php-cs-fixer fix "$FILE_PATH" --quiet 2>/dev/null || true
+        fi
+        ;;
+    py)
+        if command -v black &> /dev/null; then
+            black --quiet "$FILE_PATH" 2>/dev/null || true
+        fi
+        if command -v isort &> /dev/null; then
+            isort --quiet "$FILE_PATH" 2>/dev/null || true
+        fi
+        ;;
+    dart)
+        if command -v dart &> /dev/null; then
+            dart format "$FILE_PATH" 2>/dev/null || true
+        fi
+        ;;
+    go)
+        if command -v gofmt &> /dev/null; then
+            gofmt -w "$FILE_PATH" 2>/dev/null || true
+        fi
+        ;;
+    rs)
+        if command -v rustfmt &> /dev/null; then
+            rustfmt "$FILE_PATH" 2>/dev/null || true
+        fi
+        ;;
+esac
+
+exit 0

package/Dev/i18n/pt/Common/hooks/scripts/pre-commit-check.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# Pre-commit hook: Block commits with secrets or sensitive data
+# Exit code 2 = block, Exit code 0 = allow
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract the command being executed
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+# Check for sensitive patterns in staged files
+check_secrets() {
+    local patterns=(
+        "password\s*="
+        "api_key\s*="
+        "secret\s*="
+        "token\s*="
+        "AWS_ACCESS_KEY"
+        "AWS_SECRET_KEY"
+        "PRIVATE_KEY"
+        "-----BEGIN.*PRIVATE KEY-----"
+    )
+
+    for pattern in "${patterns[@]}"; do
+        if git diff --cached --name-only 2>/dev/null | xargs grep -lE "$pattern" 2>/dev/null; then
+            return 1
+        fi
+    done
+    return 0
+}
+
+# Check for large files
+check_file_size() {
+    local max_size=10485760  # 10MB
+    while read -r file; do
+        if [ -f "$file" ]; then
+            size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)
+            if [ "$size" -gt "$max_size" ]; then
+                echo "File too large: $file ($size bytes)" >&2
+                return 1
+            fi
+        fi
+    done < <(git diff --cached --name-only 2>/dev/null)
+    return 0
+}
+
+# Check for .env files
+check_env_files() {
+    if git diff --cached --name-only 2>/dev/null | grep -qE "\.env$|\.env\..+$"; then
+        echo "BLOCKED: Attempting to commit .env file" >&2
+        return 1
+    fi
+    return 0
+}
+
+# Main checks
+if ! check_env_files; then
+    exit 2
+fi
+
+if ! check_secrets; then
+    echo "BLOCKED: Potential secrets detected in staged files" >&2
+    exit 2
+fi
+
+if ! check_file_size; then
+    exit 2
+fi
+
+# All checks passed
+exit 0

package/Dev/i18n/pt/Common/hooks/scripts/quality-gate.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+# Quality gate hook: Run tests before accepting Claude's response
+# This runs on Stop event to validate work before completion
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+CWD=$(echo "$INPUT" | jq -r '.cwd // "."')
+
+cd "$CWD" 2>/dev/null || true
+
+# Detect project type and run appropriate tests
+run_tests() {
+    # Node.js / JavaScript
+    if [ -f "package.json" ]; then
+        if npm test --silent 2>/dev/null; then
+            return 0
+        else
+            return 1
+        fi
+    fi
+
+    # PHP / Symfony
+    if [ -f "composer.json" ]; then
+        if [ -f "vendor/bin/phpunit" ]; then
+            if vendor/bin/phpunit --testdox 2>/dev/null; then
+                return 0
+            else
+                return 1
+            fi
+        fi
+    fi
+
+    # Python
+    if [ -f "pyproject.toml" ] || [ -f "setup.py" ]; then
+        if command -v pytest &> /dev/null; then
+            if pytest -q 2>/dev/null; then
+                return 0
+            else
+                return 1
+            fi
+        fi
+    fi
+
+    # Flutter / Dart
+    if [ -f "pubspec.yaml" ]; then
+        if command -v flutter &> /dev/null; then
+            if flutter test --reporter compact 2>/dev/null; then
+                return 0
+            else
+                return 1
+            fi
+        fi
+    fi
+
+    # Go
+    if [ -f "go.mod" ]; then
+        if go test ./... 2>/dev/null; then
+            return 0
+        else
+            return 1
+        fi
+    fi
+
+    # No tests found, pass by default
+    return 0
+}
+
+# Run static analysis
+run_static_analysis() {
+    # PHP
+    if [ -f "vendor/bin/phpstan" ]; then
+        vendor/bin/phpstan analyse --no-progress 2>/dev/null || return 1
+    fi
+
+    # TypeScript
+    if [ -f "tsconfig.json" ] && command -v npx &> /dev/null; then
+        npx tsc --noEmit 2>/dev/null || return 1
+    fi
+
+    return 0
+}
+
+# Main execution
+if ! run_tests; then
+    echo '{"decision": "block", "reason": "Tests are failing. Please fix the failing tests before completing this task."}'
+    exit 0
+fi
+
+# Static analysis is optional - warn but don't block
+if ! run_static_analysis; then
+    echo '{"continue": true, "systemMessage": "Warning: Static analysis found issues. Consider reviewing."}'
+    exit 0
+fi
+
+# All passed
+echo '{"continue": true}'
+exit 0