all-for-claudecode 2.0.0

package/scripts/afc-task-completed-gate.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+set -euo pipefail
+# TaskCompleted Gate Hook: Block task completion while pipeline is active and CI has not passed
+# Physically prevents Claude from skipping CI and completing a task
+#
+# Gap fix: "Prompts are not enforcement" -> Physical enforcement via exit 2
+
+# trap: Preserve exit code on abnormal termination + stderr message
+# shellcheck disable=SC2329
+cleanup() {
+  local exit_code=$?
+  if [ "$exit_code" -ne 0 ] && [ "$exit_code" -ne 2 ]; then
+    echo "AFC TASK GATE: Abnormal exit (exit code: $exit_code)" >&2
+  fi
+  exit "$exit_code"
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PIPELINE_FLAG="${PROJECT_DIR}/.claude/.afc-active"
+CI_FLAG="${PROJECT_DIR}/.claude/.afc-ci-passed"
+PHASE_FLAG="${PROJECT_DIR}/.claude/.afc-phase"
+
+# Consume stdin (required -- pipe breaks if not consumed)
+cat > /dev/null
+
+# If pipeline is not active -> pass through
+if [ ! -f "$PIPELINE_FLAG" ]; then
+  exit 0
+fi
+
+FEATURE="$(head -1 "$PIPELINE_FLAG" | tr -d '\n\r')"
+
+# Check current Phase if phase file exists
+CURRENT_PHASE=""
+if [ -f "$PHASE_FLAG" ]; then
+  CURRENT_PHASE="$(head -1 "$PHASE_FLAG" | tr -d '\n\r')"
+fi
+CURRENT_PHASE="${CURRENT_PHASE:-}"
+
+# Spec/Plan/Tasks Phase (1-3) do not require CI -> pass through
+case "${CURRENT_PHASE:-}" in
+  spec|plan|tasks)
+    exit 0
+    ;;
+esac
+
+# Implement/Review/Clean Phase (4-6) require CI to pass
+if [ ! -f "$CI_FLAG" ]; then
+  echo "AFC TASK GATE: CI has not been run. Pipeline '${FEATURE:-unknown}' Phase '${CURRENT_PHASE:-unknown}' requires passing the CI gate. Run your CI command and record the timestamp in .claude/.afc-ci-passed." >&2
+  exit 2
+fi
+
+# Verify CI passed within the last 10 minutes (prevent stale results)
+CI_TIME="$(cat "$CI_FLAG" 2>/dev/null | head -1 | tr -dc '0-9' || true)"
+CI_TIME="${CI_TIME:-0}"
+NOW="$(date +%s)"
+if [ "$CI_TIME" -gt 0 ]; then
+  DIFF=$(( NOW - CI_TIME ))
+  if [ "$DIFF" -gt 600 ]; then
+    echo "AFC TASK GATE: CI results are stale (${DIFF} seconds ago). Please run your CI command again." >&2
+    exit 2
+  fi
+fi
+
+exit 0

package/scripts/afc-teammate-idle.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+set -euo pipefail
+# TeammateIdle Hook: Block idle during implement/review Phase while pipeline is active
+# Physically prevents Claude from stopping mid-task
+#
+# Gap fix: "Prompts are not enforcement" -> Physical enforcement via exit 2
+
+# trap: Preserve exit code on abnormal termination + stderr message
+# shellcheck disable=SC2329
+cleanup() {
+  local exit_code=$?
+  if [ "$exit_code" -ne 0 ] && [ "$exit_code" -ne 2 ]; then
+    echo "AFC TEAMMATE GATE: Abnormal exit (exit code: $exit_code)" >&2
+  fi
+  exit "$exit_code"
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PIPELINE_FLAG="${PROJECT_DIR}/.claude/.afc-active"
+PHASE_FLAG="${PROJECT_DIR}/.claude/.afc-phase"
+
+# Consume stdin (required -- pipe breaks if not consumed)
+cat > /dev/null
+
+# If pipeline is not active -> pass through
+if [ ! -f "$PIPELINE_FLAG" ]; then
+  exit 0
+fi
+
+FEATURE="$(head -1 "$PIPELINE_FLAG" | tr -d '\n\r')"
+
+# Check current Phase if phase file exists
+CURRENT_PHASE=""
+if [ -f "$PHASE_FLAG" ]; then
+  CURRENT_PHASE="$(head -1 "$PHASE_FLAG" | tr -d '\n\r')"
+fi
+CURRENT_PHASE="${CURRENT_PHASE:-}"
+
+# Block idle during implement/review Phase -> force work to continue
+case "${CURRENT_PHASE:-}" in
+  implement|review)
+    echo "AFC TEAMMATE GATE: Pipeline '${FEATURE:-unknown}' Phase '${CURRENT_PHASE:-unknown}' is active. Please complete the task." >&2
+    exit 2
+    ;;
+  *)
+    exit 0
+    ;;
+esac

package/scripts/afc-timeline-log.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+set -euo pipefail
+# JSONL Event Logger: Appends structured events to .claude/.afc-timeline.jsonl
+#
+# Usage:
+#   afc-timeline-log.sh <event_type> <message> [extra_json_fields]
+#
+# event_type: phase-start, phase-end, gate-pass, gate-fail, error,
+#             pipeline-start, pipeline-end
+# message:    human-readable description
+# extra_json_fields: optional JSON object string to merge (e.g. '{"tool":"bash"}')
+
+# shellcheck disable=SC2329
+cleanup() {
+  :
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+FLAG_DIR="$PROJECT_DIR/.claude"
+TIMELINE_FILE="$FLAG_DIR/.afc-timeline.jsonl"
+ROTATE_FILE="$FLAG_DIR/.afc-timeline.jsonl.1"
+MAX_BYTES=1048576  # 1 MB
+
+EVENT_TYPE="${1:-}"
+MESSAGE="${2:-}"
+EXTRA="${3:-}"
+
+# Validate required arguments
+if [ -z "$EVENT_TYPE" ] || [ -z "$MESSAGE" ]; then
+  printf 'Usage: %s <event_type> <message> [extra_json_fields]\n' "$0" >&2
+  exit 0
+fi
+
+# Sanitize inputs (strip newlines; limit length)
+EVENT_TYPE=$(printf '%s' "$EVENT_TYPE" | tr -d '\n\r' | cut -c1-64)
+MESSAGE=$(printf '%s' "$MESSAGE"     | tr -d '\n\r' | cut -c1-500)
+
+# Read pipeline state (gracefully handle missing files)
+FEATURE="none"
+PHASE="none"
+if [ -f "$FLAG_DIR/.afc-active" ]; then
+  FEATURE=$(head -1 "$FLAG_DIR/.afc-active" | tr -d '\n\r' | cut -c1-100)
+fi
+if [ -f "$FLAG_DIR/.afc-phase" ]; then
+  PHASE=$(head -1 "$FLAG_DIR/.afc-phase" | tr -d '\n\r' | cut -c1-64)
+fi
+
+# Timestamp (no jq dependency)
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+# Escape a string for JSON (handle backslash, double-quote, and control chars)
+json_escape() {
+  printf '%s' "$1" \
+    | sed 's/\\/\\\\/g' \
+    | sed 's/"/\\"/g' \
+    | tr -d '\001\002\003\004\005\006\007\010\011\012\013\014\015\016\017' \
+    | tr -d '\020\021\022\023\024\025\026\027\030\031\032\033\034\035\036\037'
+}
+
+TS_ESC=$(json_escape "$TS")
+EVENT_ESC=$(json_escape "$EVENT_TYPE")
+MSG_ESC=$(json_escape "$MESSAGE")
+FEATURE_ESC=$(json_escape "$FEATURE")
+PHASE_ESC=$(json_escape "$PHASE")
+
+# Build the base JSON line
+BASE="{\"ts\":\"${TS_ESC}\",\"event\":\"${EVENT_ESC}\",\"msg\":\"${MSG_ESC}\",\"feature\":\"${FEATURE_ESC}\",\"phase\":\"${PHASE_ESC}\"}"
+
+# Merge extra JSON fields if provided (append before closing brace)
+if [ -n "$EXTRA" ]; then
+  # Strip outer braces from EXTRA and append, only if it looks like a JSON object
+  INNER=$(printf '%s' "$EXTRA" | sed 's/^[[:space:]]*{//;s/}[[:space:]]*$//')
+  if [ -n "$INNER" ]; then
+    LINE="${BASE%\}},${INNER}}"
+  else
+    LINE="$BASE"
+  fi
+else
+  LINE="$BASE"
+fi
+
+# Ensure the flag directory exists
+mkdir -p "$FLAG_DIR"
+
+# Auto-rotate if the timeline file exceeds MAX_BYTES
+if [ -f "$TIMELINE_FILE" ]; then
+  FILE_SIZE=$(wc -c < "$TIMELINE_FILE" | tr -d ' ')
+  if [ "$FILE_SIZE" -ge "$MAX_BYTES" ]; then
+    mv "$TIMELINE_FILE" "$ROTATE_FILE"
+  fi
+fi
+
+# Append the JSONL line
+printf '%s\n' "$LINE" >> "$TIMELINE_FILE"
+
+exit 0

package/scripts/afc-user-prompt-submit.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -euo pipefail
+
+# UserPromptSubmit Hook: Inject pipeline Phase/Feature context on every prompt
+# Exit 0 immediately if pipeline is inactive (minimize overhead)
+
+# shellcheck disable=SC2329
+cleanup() {
+  :
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
+PHASE_FLAG="$PROJECT_DIR/.claude/.afc-phase"
+
+# Consume stdin (required -- pipe breaks if not consumed)
+cat > /dev/null
+
+# Exit silently if pipeline is inactive
+if [ ! -f "$PIPELINE_FLAG" ]; then
+  exit 0
+fi
+
+# Read Feature/Phase + JSON-safe processing (strip special characters)
+FEATURE="$(head -1 "$PIPELINE_FLAG" | tr -d '\n\r' | tr -d '"' | cut -c1-100)"
+PHASE="unknown"
+if [ -f "$PHASE_FLAG" ]; then
+  PHASE="$(head -1 "$PHASE_FLAG" | tr -d '\n\r' | tr -d '"' | cut -c1-100)"
+fi
+
+# Output additionalContext to stdout (injected into Claude context)
+printf '{"hookSpecificOutput":{"additionalContext":"[Pipeline: %s] [Phase: %s]"}}\n' "$FEATURE" "$PHASE"
+
+exit 0

package/scripts/pre-compact-checkpoint.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+set -euo pipefail
+# Pre-Compact Hook: Auto-checkpoint before context compaction
+# Prevents loss of progress state during session interruption/compaction
+#
+# Gap fix: Enforces OMC auto-state-save via physical script
+
+# shellcheck disable=SC2329
+cleanup() {
+  # Extend here if temporary file cleanup is needed
+  :
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+# Consume stdin (required -- pipe breaks if not consumed)
+cat > /dev/null
+
+# Dynamically derive auto-memory directory from project path
+PROJECT_PATH=$(cd "$PROJECT_DIR" 2>/dev/null && pwd || true)
+PROJECT_PATH="${PROJECT_PATH:-$PROJECT_DIR}"
+ENCODED_PATH="${PROJECT_PATH//\//-}"
+MEMORY_DIR="$HOME/.claude/projects/$ENCODED_PATH/memory"
+CHECKPOINT="$MEMORY_DIR/checkpoint.md"
+
+# Create memory directory if it doesn't exist
+mkdir -p "$MEMORY_DIR"
+
+# Collect current git status
+BRANCH=$(cd "$PROJECT_DIR" 2>/dev/null && git branch --show-current 2>/dev/null || echo "unknown")
+
+ALL_MODIFIED=$(cd "$PROJECT_DIR" 2>/dev/null && git diff --name-only 2>/dev/null || true)
+MODIFIED=$(printf '%s\n' "$ALL_MODIFIED" | head -10)
+
+ALL_STAGED=$(cd "$PROJECT_DIR" 2>/dev/null && git diff --cached --name-only 2>/dev/null || true)
+STAGED=$(printf '%s\n' "$ALL_STAGED" | head -10)
+
+# Count files (capture into variable instead of piping wc -l)
+MODIFIED_COUNT=0
+if [ -n "$ALL_MODIFIED" ]; then
+  MODIFIED_RAW=$(printf '%s\n' "$ALL_MODIFIED" | wc -l)
+  MODIFIED_COUNT=$(printf '%s' "$MODIFIED_RAW" | tr -d ' ')
+fi
+
+STAGED_COUNT=0
+if [ -n "$ALL_STAGED" ]; then
+  STAGED_RAW=$(printf '%s\n' "$ALL_STAGED" | wc -l)
+  STAGED_COUNT=$(printf '%s' "$STAGED_RAW" | tr -d ' ')
+fi
+
+# Check afc pipeline active status
+PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
+PIPELINE_FEATURE=""
+if [ -f "$PIPELINE_FLAG" ]; then
+  PIPELINE_FEATURE=$(head -1 "$PIPELINE_FLAG" 2>/dev/null | tr -d '\n\r' || true)
+fi
+
+# Check tasks.md progress status
+TASKS_DONE=0
+TASKS_TOTAL=0
+if [ -n "$PIPELINE_FEATURE" ] && [ -d "$PROJECT_DIR/.claude/afc/specs/$PIPELINE_FEATURE" ]; then
+  TASKS_FILE="$PROJECT_DIR/.claude/afc/specs/$PIPELINE_FEATURE/tasks.md"
+  if [ -f "$TASKS_FILE" ]; then
+    TASKS_DONE=$(grep -cE '\[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+    TASKS_TOTAL=$(grep -cE '\[(x| )\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+  fi
+fi
+
+# Guard against empty lists
+if [ -n "$MODIFIED" ]; then
+  # shellcheck disable=SC2001
+  MODIFIED_LIST=$(echo "$MODIFIED" | sed 's/^/  - /')
+else
+  MODIFIED_LIST="  (none)"
+fi
+
+if [ -n "$STAGED" ]; then
+  # shellcheck disable=SC2001
+  STAGED_LIST=$(echo "$STAGED" | sed 's/^/  - /')
+else
+  STAGED_LIST="  (none)"
+fi
+
+# Write checkpoint.md
+cat > "$CHECKPOINT" << EOF
+# Auto Checkpoint (Pre-Compact)
+> Auto-generated: $(date '+%Y-%m-%d %H:%M:%S')
+> Trigger: context compaction
+
+## Git Status
+- Branch: $BRANCH
+- Modified files: ${MODIFIED_COUNT}
+$MODIFIED_LIST
+
+## Staged Files (${STAGED_COUNT})
+$STAGED_LIST
+
+## Pipeline Status
+- Active: $([ -f "$PIPELINE_FLAG" ] && echo "Yes ($PIPELINE_FEATURE)" || echo "No")
+- Task progress: $TASKS_DONE/$TASKS_TOTAL
+
+## Restore Command
+\`\`\`
+/afc:resume
+\`\`\`
+EOF
+
+# Inject context via stdout (Claude can see this info after compaction)
+echo "Auto-checkpoint saved to .claude/afc/memory/checkpoint.md (branch: $BRANCH, pipeline: ${PIPELINE_FEATURE:-inactive})"
+
+exit 0

package/scripts/session-start-context.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+set -euo pipefail
+
+# Session Start Hook: Restore pipeline state on session start
+# Inject context so progress state is not lost after resume/compact
+#
+# Gap fix: Enforces OMC session continuity via physical script
+
+# shellcheck disable=SC2329
+cleanup() {
+  local exit_code=$?
+  if [ "$exit_code" -ne 0 ]; then
+    echo "[all-for-claudecode] session-start-context.sh exited abnormally" >&2
+  fi
+  exit "$exit_code"
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+# Consume stdin (required -- pipe breaks if not consumed)
+cat > /dev/null
+
+# Dynamically derive auto-memory directory from project path
+PROJECT_PATH=$(cd "$PROJECT_DIR" 2>/dev/null && pwd || echo "$PROJECT_DIR")
+ENCODED_PATH="${PROJECT_PATH//\//-}"
+MEMORY_DIR="$HOME/.claude/projects/$ENCODED_PATH/memory"
+CHECKPOINT="$MEMORY_DIR/checkpoint.md"
+PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
+
+OUTPUT=""
+
+# 1. Check for active pipeline
+if [ -f "$PIPELINE_FLAG" ]; then
+  FEATURE=$(head -1 "$PIPELINE_FLAG" 2>/dev/null | tr -d '\n\r' || true)
+  OUTPUT="[AFC PIPELINE ACTIVE] Feature: $FEATURE"
+
+  # tasks.md progress
+  TASKS_FILE="$PROJECT_DIR/.claude/afc/specs/$FEATURE/tasks.md"
+  if [ -f "$TASKS_FILE" ]; then
+    DONE=$(grep -cE '\[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+    TOTAL=$(grep -cE '\[(x| )\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+    OUTPUT="$OUTPUT | Tasks: $DONE/$TOTAL"
+  fi
+
+  # CI pass status
+  CI_FLAG="$PROJECT_DIR/.claude/.afc-ci-passed"
+  if [ -f "$CI_FLAG" ]; then
+    OUTPUT="$OUTPUT | Last CI: PASSED ($(cat "$CI_FLAG" 2>/dev/null || true))"
+  fi
+fi
+
+# 2. Check if checkpoint exists
+if [ -f "$CHECKPOINT" ]; then
+  RAW_LINE=$(grep 'Auto-generated:' "$CHECKPOINT" 2>/dev/null || echo "")
+  FIRST_LINE=$(echo "$RAW_LINE" | head -1)
+  CHECKPOINT_DATE="${FIRST_LINE##*Auto-generated: }"
+  if [ -n "$CHECKPOINT_DATE" ]; then
+    if [ -n "$OUTPUT" ]; then
+      OUTPUT="$OUTPUT | Checkpoint: $CHECKPOINT_DATE"
+    else
+      OUTPUT="[CHECKPOINT EXISTS] Date: $CHECKPOINT_DATE — Run /afc:resume to restore"
+    fi
+  fi
+fi
+
+# 3. Check for safety tag
+HAS_SAFETY_TAG=$(cd "$PROJECT_DIR" 2>/dev/null && git tag -l 'afc/pre-*' 2>/dev/null | head -1 || echo "")
+if [ -n "$HAS_SAFETY_TAG" ]; then
+  if [ -n "$OUTPUT" ]; then
+    OUTPUT="$OUTPUT | Safety tag: $HAS_SAFETY_TAG"
+  fi
+fi
+
+# Output (stdout -> injected into Claude context)
+if [ -n "$OUTPUT" ]; then
+  printf '%s\n' "$OUTPUT"
+fi
+
+exit 0

package/scripts/track-afc-changes.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+set -euo pipefail
+# PostToolUse Hook: Track file changes
+# Record changed files after Edit/Write tool usage
+# Track which files have changed for the CI gate
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
+CHANGES_LOG="$PROJECT_DIR/.claude/.afc-changes.log"
+CI_FLAG="$PROJECT_DIR/.claude/.afc-ci-passed"
+
+# shellcheck disable=SC2329
+cleanup() {
+  # Placeholder for temporary resource cleanup if needed
+  :
+}
+trap cleanup EXIT
+
+# If pipeline is inactive -> skip
+if [ ! -f "$PIPELINE_FLAG" ]; then
+  exit 0
+fi
+
+# Parse tool input from stdin
+INPUT=$(cat)
+
+# Skip if stdin is empty
+if [ -z "$INPUT" ]; then
+  exit 0
+fi
+
+# Extract file_path with jq if available, otherwise grep/sed fallback
+if command -v jq &> /dev/null; then
+  FILE_PATH=$(printf '%s\n' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null || true)
+else
+  FILE_PATH=$(printf '%s\n' "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*:[[:space:]]*"//;s/"$//' 2>/dev/null || true)
+fi
+
+if [ -n "$FILE_PATH" ]; then
+  # Append to change log (deduplicate)
+  printf '%s\n' "$FILE_PATH" >> "$CHANGES_LOG"
+  sort -u -o "$CHANGES_LOG" "$CHANGES_LOG"
+
+  # Invalidate CI results since a file was changed
+  rm -f "$CI_FLAG"
+fi
+
+exit 0

package/templates/afc.config.express-api.md

@@ -0,0 +1,99 @@
+# AFC Configuration
+
+> This file defines project-specific settings for the afc command system.
+> All afc commands reference this file to determine project-specific behavior.
+
+## CI Commands
+
+```yaml
+ci: "npm run build && npm run lint && npm run test"  # Full CI (build + lint + test)
+typecheck: "npx tsc --noEmit"                        # Typecheck only
+lint: "npx eslint src/"                              # Lint only
+lint_fix: "npx eslint src/ --fix"                    # Auto-fix lint
+gate: "npx tsc --noEmit && npx eslint src/"          # Phase gate (run repeatedly during implement)
+test: "npx jest --runInBand"                         # Tests
+```
+
+## Architecture
+
+```yaml
+style: "Layered"                        # Layered architecture
+layers:                                 # Top → bottom order
+  - src/routes
+  - src/controllers
+  - src/services
+  - src/repositories
+  - src/models
+  - src/middleware
+  - src/lib
+  - src/types
+  - src/config
+import_rule: "Upper layers (routes) depend only in order: controllers → services → repositories"
+segments: []
+path_alias: "@/* → ./src/*"
+```
+
+## Framework
+
+```yaml
+name: "Express.js"
+runtime: "Node.js (CommonJS or ESM)"
+client_directive: ""                    # Server-only — not applicable
+server_client_boundary: false           # Server-only application
+```
+
+## Code Style
+
+```yaml
+language: "TypeScript"
+strict_mode: true
+type_keyword: "type"                    # Use type instead of interface
+import_type: true                       # Use import type { ... }
+component_style: ""                     # No UI components
+props_position: ""                      # No UI components
+handler_naming: "camelCase"
+boolean_naming: "is/has/can[State]"
+constant_naming: "UPPER_SNAKE_CASE"
+any_policy: "banned (use unknown with strict mode)"
+```
+
+## State Management
+
+```yaml
+global_state: ""                        # Server — stateless
+server_state: ""
+local_state: ""
+store_location: ""
+query_location: ""
+```
+
+## Styling
+
+```yaml
+framework: ""                           # Not applicable
+```
+
+## Testing
+
+```yaml
+framework: "Jest + Supertest"
+```
+
+## Project-Specific Risks
+
+> Project-specific risk patterns that must be checked in the Plan's RISK Critic
+
+1. Prisma migration and schema mismatch
+2. Express middleware ordering errors (auth → validation → handler)
+3. Missing async/await error handling (try-catch or wrapper)
+4. Runtime errors when environment variables (.env) are not set
+5. SQL injection (caution with raw queries when using Prisma)
+
+## Mini-Review Checklist
+
+> Items to inspect for each file in the Mini-Review of the Implement Phase gate
+
+1. TypeScript strict mode violations
+2. Error handling (try-catch or asyncHandler on async routes)
+3. Input validation (type checking of req.body/params/query)
+4. Unused imports / dead code

package/templates/afc.config.monorepo.md

@@ -0,0 +1,98 @@
+# AFC Configuration
+
+> This file defines project-specific settings for the afc command system.
+> All afc commands reference this file to determine project-specific behavior.
+
+## CI Commands
+
+```yaml
+ci: "pnpm turbo build lint test"        # Full CI (lint + typecheck + build)
+typecheck: "pnpm turbo typecheck"       # Typecheck only
+lint: "pnpm turbo lint"                 # Lint only
+lint_fix: "pnpm turbo lint -- --fix"   # Auto-fix lint
+gate: "pnpm turbo typecheck lint"       # Phase gate (run repeatedly during implement)
+test: "pnpm turbo test"                 # Tests
+```
+
+## Architecture
+
+```yaml
+style: "Monorepo"
+layers:                                 # Root → package order
+  - apps/
+  - packages/
+import_rule: "apps/ may only import from packages/. packages/ must declare explicit dependencies (package.json)"
+segments:
+  - apps/web       # Web app
+  - apps/api       # API server
+  - packages/ui    # Shared UI components
+  - packages/config   # Shared configuration (ESLint, Prettier, etc.)
+  - packages/tsconfig # Shared TypeScript configuration
+  - packages/utils    # Shared utilities
+path_alias: "@repo/* → packages/*"
+```
+
+## Framework
+
+```yaml
+name: "Turborepo + pnpm workspace"
+runtime: "Multiple (varies per app)"
+client_directive: "Varies per app"
+server_client_boundary: "Varies per app"    # Determined by each app's framework
+```
+
+## Code Style
+
+```yaml
+language: "TypeScript"
+strict_mode: true
+type_keyword: "type"                    # Use type instead of interface
+import_type: true                       # Use import type { ... }
+component_style: "PascalCase"
+props_position: "above component"       # Define Props type above the component
+handler_naming: "handle[Event]"
+boolean_naming: "is/has/can[State]"
+constant_naming: "UPPER_SNAKE_CASE"
+any_policy: "minimize (especially strict for shared packages)"
+```
+
+## State Management
+
+```yaml
+global_state: "Varies per app"
+server_state: "Varies per app"
+local_state: "Varies per app"
+store_location: "Within each app"
+query_location: "Within each app"
+```
+
+## Styling
+
+```yaml
+framework: "Varies per app (shared UI package uses Tailwind CSS)"
+```
+
+## Testing
+
+```yaml
+framework: "Varies per app (Vitest or Jest)"
+```
+
+## Project-Specific Risks
+
+> Project-specific risk patterns that must be checked in the Plan's RISK Critic
+
+1. Circular dependencies between packages (turborepo detects, but runtime errors possible)
+2. Build failures in dependent apps when shared packages change
+3. npm publish errors when pnpm workspace protocol (workspace:*) is missing
+4. tsconfig inheritance chain mismatch (extends path errors)
+5. Stale builds due to incorrect pipeline cache settings in turbo.json
+
+## Mini-Review Checklist
+
+> Items to inspect for each file in the Mini-Review of the Implement Phase gate
+
+1. Dependency direction between packages (apps → packages only)
+2. Shared package export paths (package.json exports field)
+3. TypeScript strict mode + path alias consistency
+4. turbo.json pipeline configuration matches actual scripts