forgedev 1.0.0 → 1.0.2

package/templates/claude-code/commands/generate-uat.md

@@ -1,35 +1,35 @@
-Generate UAT (User Acceptance Test) scenarios for this project.
-
-## Instructions
-
-1. Read the codebase to identify all user-facing features:
-   - API endpoints and their purposes
-   - UI pages and forms
-   - Authentication flows
-   - Business logic and workflows
-
-2. For each feature, create test scenarios covering:
-   - Happy path (expected usage)
-   - Edge cases (empty inputs, max values, special characters)
-   - Error cases (invalid data, unauthorized access, network failures)
-   - Integration points (features that depend on each other)
-
-3. Prioritize scenarios:
-   - P0: Critical path — app is broken if these fail (login, core CRUD, data integrity)
-   - P1: Important — significant user impact (permissions, validation, error handling)
-   - P2: Nice to have — minor features, cosmetic issues
-
-## Output
-
-Generate two files:
-
-### docs/uat/UAT_TEMPLATE.md
-Markdown table with columns:
-| ID | Feature | Scenario | Steps | Expected Result | Priority |
-
-### docs/uat/UAT_CHECKLIST.csv
-CSV with columns:
-ID,Feature,Scenario,Priority,Status,Tester,Date,Notes
-
-Include at least 5 P0 scenarios, 10 P1 scenarios, and 5 P2 scenarios.
-Do NOT modify any code — this is a documentation-only task.
+Generate UAT (User Acceptance Test) scenarios for this project.
+
+## Instructions
+
+1. Read the codebase to identify all user-facing features:
+   - API endpoints and their purposes
+   - UI pages and forms
+   - Authentication flows
+   - Business logic and workflows
+
+2. For each feature, create test scenarios covering:
+   - Happy path (expected usage)
+   - Edge cases (empty inputs, max values, special characters)
+   - Error cases (invalid data, unauthorized access, network failures)
+   - Integration points (features that depend on each other)
+
+3. Prioritize scenarios:
+   - P0: Critical path — app is broken if these fail (login, core CRUD, data integrity)
+   - P1: Important — significant user impact (permissions, validation, error handling)
+   - P2: Nice to have — minor features, cosmetic issues
+
+## Output
+
+Generate two files:
+
+### docs/uat/UAT_TEMPLATE.md
+Markdown table with columns:
+| ID | Feature | Scenario | Steps | Expected Result | Priority |
+
+### docs/uat/UAT_CHECKLIST.csv
+CSV with columns:
+ID,Feature,Scenario,Priority,Status,Tester,Date,Notes
+
+Include at least 5 P0 scenarios, 10 P1 scenarios, and 5 P2 scenarios.
+Do NOT modify any code — this is a documentation-only task.

package/templates/claude-code/commands/next.md

@@ -1,20 +1,20 @@
-Figure out what the developer should work on next.
-
-## Steps
-
-1. Check git log for recent commits to understand current progress
-2. Look for TODO/FIXME/HACK comments in the codebase
-3. Check if there are failing tests: `{{TEST_COMMAND}}`
-4. Check if there are lint errors: `{{LINT_COMMAND}}`
-5. Check if docs/uat/UAT_CHECKLIST.csv exists and has unchecked items
-6. Look for open issues or PRs if this is a GitHub repo
-
-## Priority Order
-1. Failing tests or build errors (fix first)
-2. Security issues (from recent audit or TODO comments)
-3. Unchecked UAT scenarios
-4. TODO/FIXME items in code
-5. New feature work
-
-## Output
-Recommend the single most important thing to work on next, with a clear action.
+Figure out what the developer should work on next.
+
+## Steps
+
+1. Check git log for recent commits to understand current progress
+2. Look for TODO/FIXME/HACK comments in the codebase
+3. Check if there are failing tests: `{{TEST_COMMAND}}`
+4. Check if there are lint errors: `{{LINT_COMMAND}}`
+5. Check if docs/uat/UAT_CHECKLIST.csv exists and has unchecked items
+6. Look for open issues or PRs if this is a GitHub repo
+
+## Priority Order
+1. Failing tests or build errors (fix first)
+2. Security issues (from recent audit or TODO comments)
+3. Unchecked UAT scenarios
+4. TODO/FIXME items in code
+5. New feature work
+
+## Output
+Recommend the single most important thing to work on next, with a clear action.

package/templates/claude-code/commands/optimize-claude-md.md

@@ -1,31 +1,31 @@
-Analyze and optimize CLAUDE.md for this project.
-
-## Instructions
-
-1. Read the current CLAUDE.md and measure its size (line count).
-
-2. The target is **under 150 lines**. CLAUDE.md should contain ONLY:
-   - WHAT: One-line project description
-   - HOW: Key commands (lint, test, build, dev)
-   - RULES: Universal rules that apply everywhere (max 10-15 rules)
-   - PITFALLS: Known gotchas specific to this project (max 5)
-
-3. Identify content that should be **moved out**:
-   - Detailed schemas, specs, or data models → `.claude/skills/<topic>/SKILL.md`
-   - Backend-specific rules → `backend/CLAUDE.md`
-   - Frontend-specific rules → `src/CLAUDE.md` or `frontend/CLAUDE.md`
-   - Detailed API documentation → `docs/`
-   - Step-by-step procedures → `.claude/commands/`
-   - Lists of more than 5 items → `.claude/skills/`
-
-4. Present a proposal as a table:
-
-| Content | Current Location | Move To | Lines Saved |
-|---------|-----------------|---------|-------------|
-| ...     | CLAUDE.md:45-80 | .claude/skills/schema/SKILL.md | 35 |
-
-## Rules
-- Do NOT modify any files until I explicitly approve the proposal
-- Show the current line count and target line count
-- Preserve all information — nothing gets deleted, only relocated
-- Each skill file needs frontmatter: name, description, and relevant file patterns
+Analyze and optimize CLAUDE.md for this project.
+
+## Instructions
+
+1. Read the current CLAUDE.md and measure its size (line count).
+
+2. The target is **under 150 lines**. CLAUDE.md should contain ONLY:
+   - WHAT: One-line project description
+   - HOW: Key commands (lint, test, build, dev)
+   - RULES: Universal rules that apply everywhere (max 10-15 rules)
+   - PITFALLS: Known gotchas specific to this project (max 5)
+
+3. Identify content that should be **moved out**:
+   - Detailed schemas, specs, or data models → `.claude/skills/<topic>/SKILL.md`
+   - Backend-specific rules → `backend/CLAUDE.md`
+   - Frontend-specific rules → `src/CLAUDE.md` or `frontend/CLAUDE.md`
+   - Detailed API documentation → `docs/`
+   - Step-by-step procedures → `.claude/commands/`
+   - Lists of more than 5 items → `.claude/skills/`
+
+4. Present a proposal as a table:
+
+| Content | Current Location | Move To | Lines Saved |
+|---------|-----------------|---------|-------------|
+| ...     | CLAUDE.md:45-80 | .claude/skills/schema/SKILL.md | 35 |
+
+## Rules
+- Do NOT modify any files until I explicitly approve the proposal
+- Show the current line count and target line count
+- Preserve all information — nothing gets deleted, only relocated
+- Each skill file needs frontmatter: name, description, and relevant file patterns

package/templates/claude-code/commands/status.md

@@ -1,24 +1,24 @@
-Run all validation checks and show a project dashboard.
-
-## Steps
-
-1. Run lint: `{{LINT_COMMAND}}`
-2. Run type check: `{{TYPE_CHECK_COMMAND}}`
-3. Run tests: `{{TEST_COMMAND}}`
-4. Check git status for uncommitted changes
-5. Check for any `.env` files accidentally tracked
-
-## Output Format
-
-```
-{{PROJECT_NAME_PASCAL}} Status
-──────────────────────────
-Lint:       PASS / FAIL (N issues)
-Types:      PASS / FAIL (N errors)
-Tests:      PASS / FAIL (N passed, M failed)
-Git:        clean / N uncommitted changes
-Secrets:    clean / WARNING
-──────────────────────────
-```
-
-If anything fails, suggest the next step to fix it.
+Run all validation checks and show a project dashboard.
+
+## Steps
+
+1. Run lint: `{{LINT_COMMAND}}`
+2. Run type check: `{{TYPE_CHECK_COMMAND}}`
+3. Run tests: `{{TEST_COMMAND}}`
+4. Check git status for uncommitted changes
+5. Check for any `.env` files accidentally tracked
+
+## Output Format
+
+```
+{{PROJECT_NAME_PASCAL}} Status
+──────────────────────────
+Lint:       PASS / FAIL (N issues)
+Types:      PASS / FAIL (N errors)
+Tests:      PASS / FAIL (N passed, M failed)
+Git:        clean / N uncommitted changes
+Secrets:    clean / WARNING
+──────────────────────────
+```
+
+If anything fails, suggest the next step to fix it.

package/templates/claude-code/commands/workflows.md

@@ -0,0 +1,26 @@
+Show the developer what workflows are available.
+
+## Available Workflows
+
+### Daily Development
+- `/status` — Run all checks and show a project dashboard
+- `/next` — Figure out what to work on next
+- `/done` — Verify the current task is complete before moving on
+
+### Verification
+- `/verify-all` — Run lint, type check, tests, then launch all reviewers
+- `/audit-spec` — Validate implementation against a spec/PRD
+- `/audit-wiring` — Find dead or unwired features
+- `/audit-security` — Run a security audit
+
+### Release
+- `/pre-pr` — Run the complete pre-PR checklist
+- `/run-uat` — Execute UAT scenarios
+
+### Generation
+- `/generate-prd` — Generate a PRD from the current codebase
+- `/generate-uat` — Generate UAT scenarios and checklists
+- `/optimize-claude-md` — Slim down an oversized CLAUDE.md
+
+## Quick Start
+Run `/status` to see where things stand, then `/next` to pick up work.

package/templates/claude-code/hooks/polyglot.json

@@ -1,36 +1,36 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/guard-protected-files.sh"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/autofix-polyglot.sh"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd frontend && npx tsc --noEmit 2>&1 && npx eslint . 2>&1 && cd ../backend && ruff check . 2>&1"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/guard-protected-files.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/autofix-polyglot.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd frontend && npx tsc --noEmit 2>&1 && npx eslint . 2>&1 && cd ../backend && ruff check . 2>&1"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/claude-code/hooks/python.json

@@ -1,36 +1,36 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/guard-protected-files.sh"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/autofix-python.sh"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd backend && ruff check . 2>&1 && pyright 2>&1"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/guard-protected-files.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/autofix-python.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd backend && ruff check . 2>&1 && pyright 2>&1"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/claude-code/hooks/scripts/autofix-polyglot.sh

@@ -1,16 +1,16 @@
-#!/usr/bin/env bash
-# Auto-fix lint issues on saved TypeScript or Python files (polyglot)
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
-
-if [ -z "$FILE_PATH" ]; then
-  exit 0
-fi
-
-if [[ "$FILE_PATH" == *.ts || "$FILE_PATH" == *.tsx ]]; then
-  cd frontend && npx eslint --fix "$FILE_PATH" 2>&1 || true
-elif [[ "$FILE_PATH" == *.py ]]; then
-  cd backend && ruff check --fix "$FILE_PATH" 2>&1 || true
-fi
-
-exit 0
+#!/usr/bin/env bash
+# Auto-fix lint issues on saved TypeScript or Python files (polyglot)
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+if [[ "$FILE_PATH" == *.ts || "$FILE_PATH" == *.tsx ]]; then
+  cd frontend && npx eslint --fix "$FILE_PATH" 2>&1 || true
+elif [[ "$FILE_PATH" == *.py ]]; then
+  cd backend && ruff check --fix "$FILE_PATH" 2>&1 || true
+fi
+
+exit 0

package/templates/claude-code/hooks/scripts/autofix-python.sh

@@ -1,14 +1,14 @@
-#!/usr/bin/env bash
-# Auto-fix lint issues on saved Python files
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
-
-if [ -z "$FILE_PATH" ]; then
-  exit 0
-fi
-
-if [[ "$FILE_PATH" == *.py ]]; then
-  cd backend && ruff check --fix "$FILE_PATH" 2>&1 || true
-fi
-
-exit 0
+#!/usr/bin/env bash
+# Auto-fix lint issues on saved Python files
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+if [[ "$FILE_PATH" == *.py ]]; then
+  cd backend && ruff check --fix "$FILE_PATH" 2>&1 || true
+fi
+
+exit 0

package/templates/claude-code/hooks/scripts/autofix-typescript.sh

@@ -1,14 +1,14 @@
-#!/usr/bin/env bash
-# Auto-fix lint issues on saved TypeScript files
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
-
-if [ -z "$FILE_PATH" ]; then
-  exit 0
-fi
-
-if [[ "$FILE_PATH" == *.ts || "$FILE_PATH" == *.tsx ]]; then
-  npx eslint --fix "$FILE_PATH" 2>&1 || true
-fi
-
-exit 0
+#!/usr/bin/env bash
+# Auto-fix lint issues on saved TypeScript files
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+if [[ "$FILE_PATH" == *.ts || "$FILE_PATH" == *.tsx ]]; then
+  npx eslint --fix "$FILE_PATH" 2>&1 || true
+fi
+
+exit 0

package/templates/claude-code/hooks/scripts/guard-protected-files.sh

@@ -1,21 +1,21 @@
-#!/usr/bin/env bash
-# Block modifications to .env files and migration files
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
-
-if [ -z "$FILE_PATH" ]; then
-  exit 0
-fi
-
-case "$FILE_PATH" in
-  *.env|*.env.*)
-    echo "BLOCKED: Do not modify .env files directly" >&2
-    exit 2
-    ;;
-  */prisma/migrations/*|*/alembic/versions/*)
-    echo "BLOCKED: Do not modify migration files directly" >&2
-    exit 2
-    ;;
-esac
-
-exit 0
+#!/usr/bin/env bash
+# Block modifications to .env files and migration files
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // empty")
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+case "$FILE_PATH" in
+  *.env|*.env.*)
+    echo "BLOCKED: Do not modify .env files directly" >&2
+    exit 2
+    ;;
+  */prisma/migrations/*|*/alembic/versions/*)
+    echo "BLOCKED: Do not modify migration files directly" >&2
+    exit 2
+    ;;
+esac
+
+exit 0

package/templates/claude-code/hooks/typescript.json

@@ -1,36 +1,36 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/guard-protected-files.sh"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/autofix-typescript.sh"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx tsc --noEmit 2>&1 && npx eslint . 2>&1"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/guard-protected-files.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/autofix-typescript.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsc --noEmit 2>&1 && npx eslint . 2>&1"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/claude-code/commands/help.md

@@ -1,26 +0,0 @@
-Show the developer what workflows are available.
-
-## Available Workflows
-
-### Daily Development
-- `/project:status` — Run all checks and show a project dashboard
-- `/project:next` — Figure out what to work on next
-- `/project:done` — Verify the current task is complete before moving on
-
-### Verification
-- `/project:verify-all` — Run lint, type check, tests, then launch all reviewers
-- `/project:audit-spec` — Validate implementation against a spec/PRD
-- `/project:audit-wiring` — Find dead or unwired features
-- `/project:audit-security` — Run a security audit
-
-### Release
-- `/project:pre-pr` — Run the complete pre-PR checklist
-- `/project:run-uat` — Execute UAT scenarios
-
-### Generation
-- `/project:generate-prd` — Generate a PRD from the current codebase
-- `/project:generate-uat` — Generate UAT scenarios and checklists
-- `/project:optimize-claude-md` — Slim down an oversized CLAUDE.md
-
-## Quick Start
-Run `/project:status` to see where things stand, then `/project:next` to pick up work.