claude-base-setup 1.0.0

package/README.md

@@ -0,0 +1,63 @@
+# claude-base-setup
+
+A reusable `.claude` configuration for Claude Code projects with smart context injection, rules, and agents.
+
+## Installation
+
+```bash
+npx claude-base-setup
+```
+
+This creates a `.claude/` directory in your project with:
+
+- **hooks/** - Smart context injection on every prompt
+- **rules/** - Behavioral guidelines injected into context
+- **agents/** - Task workers (pre-code-check, package-checker, etc.)
+- **skills/** - Custom slash commands (empty by default)
+- **settings.local.json** - Hook configuration
+
+## Usage
+
+### Re-initialize (overwrite existing)
+
+```bash
+npx claude-base-setup --force
+```
+
+### What it does
+
+1. **On every prompt**: Analyzes your input and injects relevant rules
+2. **On session start**: Checks if project context is fresh, suggests refresh if stale
+3. **Before creating code**: Suggests running `pre-code-check` agent to avoid duplicates
+4. **Before installing packages**: Suggests running `package-checker` for version compatibility
+
+## Included Rules
+
+| Rule | Trigger | Description |
+|------|---------|-------------|
+| code-standards | code keywords | No hardcoding, dynamic discovery |
+| announce-actions | always | Announce actions, track agent usage |
+| rule-format | "rule" keywords | How to create rules |
+| subagent-format | "agent" keywords | How to create agents |
+
+## Included Agents
+
+| Agent | Purpose |
+|-------|---------|
+| pre-code-check | Search for existing code before creating new |
+| package-checker | Check package versions and compatibility |
+| context-loader | Scan codebase and generate CONTEXT.md |
+| structure-validator | Validate project structure after file ops |
+
+## Customization
+
+After installation, modify files in `.claude/` to fit your project:
+
+- Add project-specific rules in `rules/`
+- Customize keyword triggers in `hooks/triggers.json`
+- Add custom agents in `agents/`
+- Update `settings.local.json` for permissions
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
+const TARGET_DIR = path.join(process.cwd(), '.claude');
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function makeExecutable(dir) {
+  const hooksDir = path.join(dir, 'hooks');
+  if (fs.existsSync(hooksDir)) {
+    const files = fs.readdirSync(hooksDir);
+    for (const file of files) {
+      if (file.endsWith('.sh')) {
+        const filePath = path.join(hooksDir, file);
+        fs.chmodSync(filePath, 0o755);
+      }
+    }
+  }
+}
+
+function init() {
+  console.log('🔧 Initializing Claude Code base setup...\n');
+
+  if (fs.existsSync(TARGET_DIR)) {
+    console.log('⚠️  .claude directory already exists.');
+    console.log('   Use --force to overwrite.\n');
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(TEMPLATES_DIR)) {
+    console.error('❌ Templates directory not found. Package may be corrupted.');
+    process.exit(1);
+  }
+
+  copyDir(TEMPLATES_DIR, TARGET_DIR);
+  makeExecutable(TARGET_DIR);
+
+  console.log('✅ Created .claude/ directory with:');
+  console.log('   📁 hooks/     - Smart context injection');
+  console.log('   📁 rules/     - Behavioral guidelines');
+  console.log('   📁 agents/    - Task workers');
+  console.log('   📁 skills/    - Custom commands (empty)');
+  console.log('   📄 settings.local.json\n');
+  console.log('🚀 Ready! Claude Code will now use these rules and agents.\n');
+}
+
+function forceInit() {
+  if (fs.existsSync(TARGET_DIR)) {
+    fs.rmSync(TARGET_DIR, { recursive: true });
+  }
+  init();
+}
+
+function showHelp() {
+  console.log(`
+claude-base-setup - Initialize .claude configuration for Claude Code
+
+Usage:
+  npx claude-base-setup         Initialize .claude in current directory
+  npx claude-base-setup --force Overwrite existing .claude directory
+  npx claude-base-setup --help  Show this help message
+
+What's included:
+  • hooks/     Smart context injection on every prompt
+  • rules/     Behavioral guidelines (code standards, etc.)
+  • agents/    Task workers (pre-code-check, package-checker, etc.)
+  • skills/    Custom slash commands (empty by default)
+
+Learn more: https://github.com/fr0mpy/claude-base-setup
+`);
+}
+
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  showHelp();
+} else if (args.includes('--force') || args.includes('-f')) {
+  forceInit();
+} else {
+  init();
+}

package/index.js

@@ -0,0 +1,5 @@
+const path = require('path');
+
+module.exports = {
+  templatesPath: path.join(__dirname, 'templates'),
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "claude-base-setup",
+  "version": "1.0.0",
+  "description": "A reusable .claude configuration for Claude Code projects with smart context injection, rules, and agents",
+  "main": "index.js",
+  "bin": {
+    "claude-base-setup": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "llm",
+    "development",
+    "automation",
+    "rules",
+    "agents",
+    "hooks"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fr0mpy/claude-base-setup.git"
+  },
+  "files": [
+    "bin/",
+    "templates/",
+    "index.js"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/templates/agents/context-loader.md

@@ -0,0 +1,114 @@
+---
+name: context-loader
+description: Loads project context at session start. Scans codebase and generates/updates CONTEXT.md if stale (>1h).
+tools: Glob, Grep, Read, Write, Bash
+model: haiku
+---
+
+You are a context loader that works with ANY project structure.
+
+## Your Task
+
+1. Check if `.claude/CONTEXT.md` exists
+2. If exists, check modification time with `stat`
+3. If missing OR older than 1 hour → regenerate by scanning
+4. Output a brief context summary
+
+## Scan Process (if regenerating)
+
+### Step 1: Discover Project Structure
+
+Use Glob to find the project root patterns:
+- `**/package.json` → Node/JS project
+- `**/app.json` → Expo/React Native
+- `**/Cargo.toml` → Rust
+- `**/go.mod` → Go
+- `**/pyproject.toml` or `**/setup.py` → Python
+
+### Step 2: Discover Source Directories
+
+Use Glob with broad patterns to find where code lives:
+- `**/*.tsx` → React components
+- `**/*.ts` → TypeScript files
+- `**/*.py` → Python files
+- `**/*.go` → Go files
+
+Group by directory to understand the structure.
+
+### Step 3: Categorize What You Find
+
+Look at directory names to infer purpose:
+- `components`, `ui`, `views` → UI layer
+- `screens`, `pages`, `routes` → Page/Screen layer
+- `hooks`, `composables` → Reusable logic
+- `services`, `api`, `clients` → External integrations
+- `store`, `stores`, `state` → State management
+- `utils`, `helpers`, `lib` → Utilities
+- `types`, `interfaces`, `models` → Type definitions
+- `config`, `constants` → Configuration
+
+### Step 4: Identify Key Patterns
+
+Grep for common patterns to assess status:
+- `// TODO` or `# TODO` → Incomplete work
+- `throw new Error('not implemented')` → Stubs
+- Empty function bodies
+- `console.log` debugging
+
+### Step 5: Write `.claude/CONTEXT.md`
+
+```markdown
+# [Project Name] Context
+> Auto-generated: [timestamp]
+
+## Quick Stats
+[Dynamic based on what was found]
+
+## Stack
+[Detected from package.json, Cargo.toml, etc.]
+
+## Project Structure
+```
+[Actual directory tree, 2 levels deep]
+```
+
+## Key Directories
+[For each discovered category:]
+### [Category Name] ([count] files)
+[List of files]
+
+## Needs Work
+[Files with TODOs or stubs]
+
+## Detected Patterns
+[Coding patterns observed - state management, styling approach, etc.]
+```
+
+## Output Format
+
+**If context is fresh (<1h old):**
+```
+📊 Context loaded (fresh)
+[1-line summary of key stats]
+📁 .claude/CONTEXT.md
+```
+
+**If regenerated:**
+```
+📊 Context regenerated
+[1-line summary of key stats]
+📁 .claude/CONTEXT.md updated
+```
+
+**If empty project:**
+```
+⚠️ No source files found - project appears empty
+```
+
+## Rules
+
+- DISCOVER structure dynamically - never assume paths
+- Use Glob to scan, Grep to find patterns
+- Only Read specific files if needed (package.json, config)
+- Keep output to 3-5 lines
+- Be fast - don't read every source file

package/templates/agents/package-checker.md

@@ -0,0 +1,45 @@
+---
+name: package-checker
+description: Checks latest package versions before installation. Use proactively when user asks to install, add packages, or mentions npm/yarn/pnpm.
+tools: WebSearch, Read
+model: haiku
+---
+
+You are a package version checker for a React Native/Expo project.
+
+## Project Stack
+
+- React Native: 0.81
+- Expo SDK: 54
+- React: 19.x
+- TypeScript: 5.x
+
+## Your Task
+
+Before any package is installed:
+
+1. **Search for latest version** - Web search "[package] npm latest version 2026"
+2. **Check compatibility** - Verify works with RN 0.81 / Expo SDK 54
+3. **Check peer deps** - Note any required peer dependencies
+4. **Report findings** - Give exact version to install
+
+## Output Format
+
+```
+📦 Package version check:
+
+@react-navigation/native
+├─ Latest: 7.3.1 (stable)
+├─ Compatible: ✅ RN 0.81, Expo 54
+├─ Peer deps: react-native-screens, react-native-safe-area-context
+└─ Install: npm install @react-navigation/native@7.3.1
+
+Recommendation: Install version 7.3.1
+```
+
+## Rules
+
+- Always check compatibility before recommending
+- If latest is <1 week old, recommend previous stable
+- Warn about breaking changes between major versions
+- Note if package is deprecated and suggest alternatives

package/templates/agents/pre-code-check.md

@@ -0,0 +1,48 @@
+---
+name: pre-code-check
+description: Searches for existing code before creating new components, hooks, utils, or services. Use proactively when user asks to create, build, make, add, or implement code.
+tools: Grep, Glob, Read
+model: haiku
+---
+
+You are a code duplication checker for a React Native/Expo project.
+
+## Your Task
+
+Before any code is created, search for existing implementations:
+
+1. **Search by name** - Look for files with similar names
+2. **Search by function** - Look for similar functionality
+3. **Report findings** - List what exists with file paths
+4. **Recommend action** - REUSE > EXTEND > CREATE
+
+## Search Locations
+
+- `src/components/` - UI components
+- `src/hooks/` - Custom hooks
+- `src/utils/` - Utility functions
+- `src/services/` - API/service functions
+- `src/screens/` - Screen components
+
+## Output Format
+
+```
+🔍 Existing code check for: [requested item]
+
+Found:
+- src/components/Button.tsx - Generic button with variants
+- src/components/IconButton.tsx - Button with icon support
+
+Recommendation: EXTEND src/components/Button.tsx by adding [specific feature]
+```
+
+Or if nothing found:
+```
+✅ No existing [item] found. Safe to create new.
+```
+
+## Rules
+
+- Be thorough but fast
+- Only report relevant matches (>50% similar purpose)
+- Always give a clear recommendation

package/templates/agents/structure-validator.md

@@ -0,0 +1,56 @@
+---
+name: structure-validator
+description: Validates project structure after file/directory operations. Use after creating files, directories, or reorganizing code.
+tools: Glob, Bash, Read
+model: haiku
+---
+
+You are a project structure validator for a React Native/Expo project.
+
+## Your Task
+
+After file/directory operations, check for:
+
+1. **Nested duplicates** - e.g., `app/app/`, `src/src/`
+2. **Multiple src dirs** - Should usually be one
+3. **Empty directories** - Potential cleanup needed
+4. **Correct placement** - Files in right locations
+
+## Expected Structure
+
+```
+fast96/
+├── fast96-app/
+│   ├── src/
+│   │   ├── components/
+│   │   ├── screens/
+│   │   ├── hooks/
+│   │   ├── services/
+│   │   ├── utils/
+│   │   ├── config/
+│   │   ├── constants/
+│   │   ├── theme/
+│   │   └── types/
+│   ├── App.tsx
+│   └── package.json
+└── .claude/
+```
+
+## Output Format
+
+```
+🔍 Structure validation:
+
+✅ No nested duplicates
+✅ Single src/ directory
+⚠️ Empty directories found:
+  - src/hooks/ (empty)
+
+Recommendation: Remove empty dirs or add placeholder
+```
+
+## Rules
+
+- Run after any file creation
+- Flag nested duplicates immediately
+- Suggest fixes for issues found

package/templates/hooks/session-start.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# Session Start Hook
+# - Checks if context is stale
+# - Outputs instruction for Claude to use context-loader agent
+
+set -euo pipefail
+
+CLAUDE_DIR=""
+CURRENT_DIR="$(pwd)"
+while [[ "$CURRENT_DIR" != "/" ]]; do
+  if [[ -d "$CURRENT_DIR/.claude" ]]; then
+    CLAUDE_DIR="$CURRENT_DIR/.claude"
+    break
+  fi
+  CURRENT_DIR="$(dirname "$CURRENT_DIR")"
+done
+
+[[ -z "$CLAUDE_DIR" ]] && exit 0
+
+CONTEXT_FILE="$CLAUDE_DIR/CONTEXT.md"
+FRESHNESS_THRESHOLD=3600  # 1 hour in seconds
+
+# ============================================================================
+# FUNCTIONS
+# ============================================================================
+
+is_fresh() {
+  [[ ! -f "$CONTEXT_FILE" ]] && return 1
+
+  local file_age
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    file_age=$(( $(date +%s) - $(stat -f %m "$CONTEXT_FILE") ))
+  else
+    file_age=$(( $(date +%s) - $(stat -c %Y "$CONTEXT_FILE") ))
+  fi
+
+  [[ $file_age -lt $FRESHNESS_THRESHOLD ]]
+}
+
+get_context_summary() {
+  if [[ -f "$CONTEXT_FILE" ]]; then
+    # Extract quick stats section
+    grep -A5 "## Quick Stats" "$CONTEXT_FILE" 2>/dev/null | tail -4 | sed 's/^/  /'
+  fi
+}
+
+# ============================================================================
+# MAIN
+# ============================================================================
+
+echo "<session_context>"
+
+if [[ ! -f "$CONTEXT_FILE" ]]; then
+  cat << 'EOF'
+📋 No project context found.
+
+⚠️ ACTION REQUIRED: Use the `context-loader` agent to scan the codebase and generate .claude/CONTEXT.md
+
+This will help you understand the project structure and current implementation status.
+EOF
+
+elif ! is_fresh; then
+  echo "📋 Project context is STALE (>1h old)"
+  echo ""
+  get_context_summary
+  echo ""
+  cat << 'EOF'
+⚠️ ACTION REQUIRED: Use the `context-loader` agent to refresh .claude/CONTEXT.md
+EOF
+
+else
+  echo "📋 Project context loaded (fresh)"
+  echo ""
+  get_context_summary
+  echo ""
+  echo "📁 Full details: .claude/CONTEXT.md"
+fi
+
+echo "</session_context>"

package/templates/hooks/smart-inject-llm.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+set -euo pipefail
+
+# LLM-powered smart rule/agent injection using Claude Haiku
+# Replaces static keyword matching with semantic understanding
+
+# Read prompt from stdin
+PROMPT=$(cat)
+
+# Find .claude directory
+find_claude_dir() {
+    local dir="$PWD"
+    while [[ "$dir" != "/" ]]; do
+        if [[ -d "$dir/.claude" ]]; then
+            echo "$dir/.claude"
+            return 0
+        fi
+        dir="$(dirname "$dir")"
+    done
+    return 1
+}
+
+CLAUDE_DIR=$(find_claude_dir) || exit 0
+
+RULES_DIR="$CLAUDE_DIR/rules"
+AGENTS_DIR="$CLAUDE_DIR/agents"
+
+# Check directories exist
+[[ -d "$RULES_DIR" ]] || exit 0
+
+# Get API key from environment
+API_KEY="${ANTHROPIC_API_KEY:-}"
+[[ -n "$API_KEY" ]] || { echo "⚠️ ANTHROPIC_API_KEY not set - using static fallback" >&2; exec "$CLAUDE_DIR/hooks/smart-inject-rules.sh" <<< "$PROMPT"; }
+
+# Build rules summary (name + description from YAML frontmatter)
+RULES_SUMMARY=""
+for rule_file in "$RULES_DIR"/*.md; do
+    [[ -f "$rule_file" ]] || continue
+    RULE_NAME=$(basename "$rule_file" .md)
+    # Try YAML frontmatter first, fall back to SUMMARY comment
+    RULE_DESC=$(sed -n '/^---$/,/^---$/p' "$rule_file" 2>/dev/null | grep -m1 "^description:" | sed 's/description: *//' | tr -d '\n')
+    if [[ -z "$RULE_DESC" ]]; then
+        RULE_DESC=$(grep -m1 "<!-- SUMMARY:" "$rule_file" 2>/dev/null | sed 's/.*SUMMARY: *\([^-]*\) *-->.*/\1/' | tr -d '\n')
+    fi
+    [[ -n "$RULE_DESC" ]] && RULES_SUMMARY+="- $RULE_NAME: $RULE_DESC\n"
+done
+
+# Build agents summary
+AGENTS_SUMMARY=""
+if [[ -d "$AGENTS_DIR" ]]; then
+    for agent_file in "$AGENTS_DIR"/*.md; do
+        [[ -f "$agent_file" ]] || continue
+        AGENT_NAME=$(basename "$agent_file" .md)
+        AGENT_DESC=$(grep -m1 "^description:" "$agent_file" 2>/dev/null | sed 's/description: *//' | tr -d '\n')
+        AGENTS_SUMMARY+="- $AGENT_NAME: $AGENT_DESC\n"
+    done
+fi
+
+# Escape prompt for JSON
+ESCAPED_PROMPT=$(echo "$PROMPT" | jq -Rs '.')
+ESCAPED_RULES=$(echo -e "$RULES_SUMMARY" | jq -Rs '.')
+ESCAPED_AGENTS=$(echo -e "$AGENTS_SUMMARY" | jq -Rs '.')
+
+# Build dynamic system prompt from actual files
+SYSTEM_PROMPT="You analyze user prompts and select relevant rules/agents. Respond ONLY with valid JSON.
+
+Output format:
+{
+  \"active_rules\": [\"rule-name\"],
+  \"suggested_agents\": [\"agent-name\"],
+  \"enforcement\": \"Brief instruction Claude MUST follow\"
+}
+
+Available rules (select based on their descriptions):
+$(echo -e "$RULES_SUMMARY")
+
+Available agents (select based on their descriptions):
+$(echo -e "$AGENTS_SUMMARY")
+
+Selection guidelines:
+- Read each rule/agent description to understand when it applies
+- Select rules that match the user's intent, not just keywords
+- Select agents that should run BEFORE or AFTER the task
+- If no rules/agents apply, return empty arrays
+
+Enforcement rules:
+- If you select ANY agent, enforcement MUST say \"YOU MUST run [agent-name] FIRST\" or \"YOU MUST run [agent-name] AFTER\"
+- If you select rules, include their key requirement in enforcement
+- Enforcement should be SHORT (<100 chars) but MANDATORY language
+
+Good enforcement examples:
+- \"YOU MUST run pre-code-check BEFORE writing code\"
+- \"YOU MUST run package-checker BEFORE installing\"
+- \"Prefix actions with 🔧. YOU MUST run pre-code-check FIRST\"
+
+Bad enforcement examples:
+- \"Consider running pre-code-check\" (too weak)
+- \"pre-code-check suggested\" (not mandatory)
+"
+
+USER_MSG="User prompt: $PROMPT
+
+Based on the prompt, select relevant rules and agents. Return JSON only."
+
+ESCAPED_SYSTEM=$(printf '%s' "$SYSTEM_PROMPT" | jq -Rs '.')
+ESCAPED_USER=$(printf '%s' "$USER_MSG" | jq -Rs '.')
+
+# Call Haiku API
+RESPONSE=$(curl -s --max-time 5 "https://api.anthropic.com/v1/messages" \
+    -H "Content-Type: application/json" \
+    -H "x-api-key: $API_KEY" \
+    -H "anthropic-version: 2023-06-01" \
+    -d "{
+        \"model\": \"claude-3-5-haiku-latest\",
+        \"max_tokens\": 256,
+        \"messages\": [{
+            \"role\": \"user\",
+            \"content\": $ESCAPED_USER
+        }],
+        \"system\": $ESCAPED_SYSTEM
+    }" 2>/dev/null) || { exec "$CLAUDE_DIR/hooks/smart-inject-rules.sh" <<< "$PROMPT"; }
+
+# Extract JSON from response
+LLM_OUTPUT=$(echo "$RESPONSE" | jq -r '.content[0].text // empty' 2>/dev/null) || { exec "$CLAUDE_DIR/hooks/smart-inject-rules.sh" <<< "$PROMPT"; }
+
+[[ -n "$LLM_OUTPUT" ]] || { exec "$CLAUDE_DIR/hooks/smart-inject-rules.sh" <<< "$PROMPT"; }
+
+# Parse LLM response
+ACTIVE_RULES=$(echo "$LLM_OUTPUT" | jq -r '.active_rules[]? // empty' 2>/dev/null)
+SUGGESTED_AGENTS=$(echo "$LLM_OUTPUT" | jq -r '.suggested_agents[]? // empty' 2>/dev/null)
+ENFORCEMENT=$(echo "$LLM_OUTPUT" | jq -r '.enforcement // empty' 2>/dev/null)
+
+OUTPUT="<user-prompt-submit-hook>\n"
+
+# Add active rules
+if [[ -n "$ACTIVE_RULES" ]]; then
+    OUTPUT+="📋 Rules: $(echo "$ACTIVE_RULES" | tr '\n' ', ' | sed 's/,$//')\n"
+else
+    OUTPUT+="📋 Rules: none\n"
+fi
+
+# Add suggested agents
+if [[ -n "$SUGGESTED_AGENTS" ]]; then
+    OUTPUT+="🤖 Agents: $(echo "$SUGGESTED_AGENTS" | tr '\n' ', ' | sed 's/,$//')\n"
+else
+    OUTPUT+="🤖 Agents: none\n"
+fi
+
+# Add enforcement instruction if present
+if [[ -n "$ENFORCEMENT" ]]; then
+    OUTPUT+="⚠️ $ENFORCEMENT\n"
+fi
+
+OUTPUT+="</user-prompt-submit-hook>"
+
+echo -e "$OUTPUT"

package/templates/hooks/smart-inject-rules.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# Smart Context Injection
+# - Injects behavioral rules
+# - Suggests agents for tasks that would bloat context
+
+set -euo pipefail
+
+CLAUDE_DIR=""
+CURRENT_DIR="$(pwd)"
+while [[ "$CURRENT_DIR" != "/" ]]; do
+  if [[ -d "$CURRENT_DIR/.claude/rules" ]]; then
+    CLAUDE_DIR="$CURRENT_DIR/.claude"
+    break
+  fi
+  CURRENT_DIR="$(dirname "$CURRENT_DIR")"
+done
+
+[[ -z "$CLAUDE_DIR" ]] && exit 0
+
+RULES_DIR="$CLAUDE_DIR/rules"
+AGENTS_DIR="$CLAUDE_DIR/agents"
+TRIGGERS_FILE="$CLAUDE_DIR/hooks/triggers.json"
+
+# ============================================================================
+# FUNCTIONS
+# ============================================================================
+
+get_summary() {
+  head -1 "$1" 2>/dev/null | grep '<!-- SUMMARY:' | sed 's/.*<!-- SUMMARY: //;s/ -->$//' || echo ""
+}
+
+get_trigger() {
+  head -2 "$1" 2>/dev/null | grep '<!-- TRIGGER:' | sed 's/.*<!-- TRIGGER: //;s/ -->$//' || echo "always"
+}
+
+get_rule_name() {
+  basename "$1" .md | tr '-' ' ' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) substr($i,2)}1'
+}
+
+get_agent_name() {
+  grep '^name:' "$1" 2>/dev/null | sed 's/name: *//' || basename "$1" .md
+}
+
+get_agent_desc() {
+  grep '^description:' "$1" 2>/dev/null | sed 's/description: *//' | head -c 80 || echo ""
+}
+
+parse_json_array() {
+  local trigger="$1"
+  local in_array=0
+  local keywords=""
+
+  while IFS= read -r line; do
+    if [[ $in_array -eq 0 ]] && echo "$line" | grep -q "\"$trigger\":"; then
+      in_array=1
+      continue
+    fi
+    if [[ $in_array -eq 1 ]]; then
+      if echo "$line" | grep -q '\]'; then
+        break
+      fi
+      local kw=$(echo "$line" | tr -d '",[] ' | tr -d '\t')
+      [[ -n "$kw" ]] && keywords="$keywords|$kw"
+    fi
+  done < "$TRIGGERS_FILE"
+
+  echo "$keywords" | sed 's/^|//'
+}
+
+# ============================================================================
+# MAIN
+# ============================================================================
+
+PROMPT=""
+[[ ! -t 0 ]] && PROMPT=$(cat)
+PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+
+MATCHED_TRIGGERS=""
+
+if [[ -f "$TRIGGERS_FILE" ]]; then
+  TRIGGER_NAMES=$(grep '": \[' "$TRIGGERS_FILE" | grep -v '_comment' | sed 's/.*"\([^"]*\)".*/\1/')
+
+  for trigger in $TRIGGER_NAMES; do
+    KEYWORDS=$(parse_json_array "$trigger")
+    if [[ -n "$KEYWORDS" ]] && echo "$PROMPT_LOWER" | grep -qiE "$KEYWORDS"; then
+      MATCHED_TRIGGERS="$MATCHED_TRIGGERS $trigger"
+    fi
+  done
+fi
+
+MATCHED_TRIGGERS=$(echo "$MATCHED_TRIGGERS" | sed 's/^ //')
+
+# ============================================================================
+# OUTPUT
+# ============================================================================
+
+echo "<context_injection>"
+
+# Rules status
+echo "RULES:"
+for f in "$RULES_DIR"/*.md; do
+  [[ ! -f "$f" ]] && continue
+  local_summary=$(get_summary "$f")
+  local_trigger=$(get_trigger "$f")
+  [[ -z "$local_summary" ]] && continue
+
+  if echo " $MATCHED_TRIGGERS " | grep -q " $local_trigger "; then
+    echo "✅ $(get_rule_name "$f")"
+  else
+    echo "◽ $(get_rule_name "$f")"
+  fi
+done
+
+# Agent suggestions based on triggers
+SUGGESTED_AGENTS=""
+for trigger in $MATCHED_TRIGGERS; do
+  case "$trigger" in
+    code) SUGGESTED_AGENTS="$SUGGESTED_AGENTS pre-code-check" ;;
+    package) SUGGESTED_AGENTS="$SUGGESTED_AGENTS package-checker" ;;
+    structure) SUGGESTED_AGENTS="$SUGGESTED_AGENTS structure-validator" ;;
+  esac
+done
+
+if [[ -n "$SUGGESTED_AGENTS" ]]; then
+  echo ""
+  echo "USE AGENTS:"
+  for agent in $SUGGESTED_AGENTS; do
+    agent_file="$AGENTS_DIR/${agent}.md"
+    if [[ -f "$agent_file" ]]; then
+      echo "🤖 $agent: $(get_agent_desc "$agent_file")"
+    fi
+  done
+fi
+
+echo "</context_injection>"
+
+# Inject full rules only for matched behavioral triggers
+for trigger in $MATCHED_TRIGGERS; do
+  for f in "$RULES_DIR"/*.md; do
+    [[ ! -f "$f" ]] && continue
+    if [[ "$(get_trigger "$f")" == "$trigger" ]]; then
+      echo ""
+      echo "<${trigger}_rule>"
+      grep -v '^<!-- ' "$f" | head -40
+      echo "</${trigger}_rule>"
+    fi
+  done
+done

package/templates/hooks/triggers.json

@@ -0,0 +1,68 @@
+{
+  "code": [
+    "create",
+    "build",
+    "make",
+    "add",
+    "implement",
+    "write",
+    "new",
+    "generate",
+    "component",
+    "hook",
+    "util",
+    "service",
+    "function",
+    "screen",
+    "class",
+    "module",
+    "button",
+    "card",
+    "input",
+    "modal",
+    "form",
+    "api",
+    "handler",
+    "code"
+  ],
+  "package": [
+    "install",
+    "package",
+    "npm",
+    "yarn",
+    "pnpm",
+    "dependency",
+    "dependencies",
+    "upgrade",
+    "update package"
+  ],
+  "structure": [
+    "directory",
+    "folder",
+    "mkdir",
+    "structure",
+    "move",
+    "rename",
+    "reorganize",
+    "refactor structure",
+    "file structure"
+  ],
+  "rules": [
+    "rule",
+    "rules",
+    "claude rule",
+    "add rule",
+    "create rule",
+    "update rule",
+    "modify rule"
+  ],
+  "subagent": [
+    "subagent",
+    "sub agent",
+    "agent",
+    "create agent",
+    "add agent",
+    "new agent"
+  ],
+  "_comment": "Add new triggers here. Keywords are matched case-insensitive against user prompt."
+}

package/templates/rules/announce-actions.md

@@ -0,0 +1,57 @@
+<!-- SUMMARY: Announce actions, track agent usage, prevent duplicates -->
+<!-- TRIGGER: always -->
+# RULE: Announce Actions
+
+## Enforcement
+
+**For every operation:**
+1. Announce what you're doing
+2. Announce when delegating to an agent
+3. Report results
+4. **NEVER run the same agent twice in one prompt**
+
+---
+
+## Agent Deduplication
+
+⚠️ **CRITICAL**: Each agent runs ONCE per user prompt, max.
+
+Before invoking an agent, check if you already used it this turn:
+- If `pre-code-check` already ran → skip, use cached result
+- If `context-loader` already ran → skip, context is loaded
+- If `structure-validator` already ran → skip
+
+---
+
+## Format
+
+```
+🔧 [Action]: [what]
+✅ Done: [result]
+```
+
+**When using agents (use present continuous):**
+```
+🤖 Searching for existing code...
+🤖 Checking package versions...
+🤖 Validating project structure...
+🤖 Loading project context...
+   [agent does work]
+✅ Done: [summary]
+```
+
+**When agent already ran:**
+```
+⏭️ Skipping [agent-name] (already ran this prompt)
+```
+
+---
+
+## Quick Reference
+
+| Trigger | Action | Max runs |
+|---------|--------|----------|
+| Creating code | `pre-code-check` first | 1 |
+| Installing packages | `package-checker` first | 1 |
+| File operations | `structure-validator` after | 1 |
+| Session start | `context-loader` | 1 |

package/templates/rules/code-standards.md

@@ -0,0 +1,74 @@
+<!-- SUMMARY: Dynamic, scalable code - no hardcoding, discover don't assume -->
+<!-- TRIGGER: code -->
+# RULE: Code Standards - Dynamic & Scalable
+
+⚠️ **ALWAYS-ACTIVE RULE** - Applies to every code generation.
+
+## 🔐 Enforcement
+
+**For EVERY piece of code, you MUST:**
+1. No hardcoded values - use constants/config/theme
+2. Discover structure dynamically - never assume paths exist
+3. Single responsibility per file
+4. Code must work regardless of project size
+
+---
+
+## Dynamic Patterns
+
+| ❌ Hardcoded/Assumed | ✅ Dynamic/Discovered |
+|----------------------|----------------------|
+| `src/components/*.tsx` | Glob for `**/*.tsx`, group by directory |
+| `if (items.length === 3)` | `if (items.length === expectedCount)` |
+| `users[0], users[1]` | `users.map()` or `users.forEach()` |
+| `case 'admin': case 'user':` | `ROLES.includes(role)` |
+| Fixed array indices | Iterate or find by property |
+
+---
+
+## Value Mapping
+
+| ❌ Hardcoded | ✅ Use Instead |
+|--------------|----------------|
+| `'#007AFF'` | `theme.colors.primary` |
+| `padding: 16` | `theme.spacing.md` |
+| `'https://api...'` | `config.API_BASE_URL` |
+| `'Invalid email'` | `MESSAGES.INVALID_EMAIL` |
+| `if (x > 50)` | `if (x > CONFIG.THRESHOLD)` |
+
+---
+
+## Scalability Principles
+
+1. **Discover, don't assume** - Scan for what exists, don't hardcode paths
+2. **Iterate, don't index** - Use `.map()`, `.filter()`, `.find()` not `[0]`, `[1]`
+3. **Configure, don't embed** - Values that might change go in config
+4. **Categorize by pattern** - Group by naming convention, not explicit list
+
+---
+
+## Quick Examples
+
+**File Discovery:**
+```typescript
+// ❌ const screens = ['Home', 'Settings', 'Profile']
+// ✅ const screens = await glob('**/screens/**/*.tsx')
+```
+
+**Iteration:**
+```typescript
+// ❌ processItem(items[0]); processItem(items[1]);
+// ✅ items.forEach(item => processItem(item))
+```
+
+**Role Checks:**
+```typescript
+// ❌ if (role === 'admin' || role === 'superadmin')
+// ✅ if (ELEVATED_ROLES.includes(role))
+```
+
+**Path Building:**
+```typescript
+// ❌ const path = 'src/components/' + name + '.tsx'
+// ✅ const path = join(SRC_DIR, 'components', `${name}.tsx`)
+```

package/templates/rules/rule-format.md

@@ -0,0 +1,72 @@
+<!-- SUMMARY: Follow standard format when creating or modifying rules -->
+<!-- TRIGGER: rules -->
+# RULE: Rule Format - Standard Structure for All Rules
+
+⚠️ **ALWAYS-ACTIVE RULE** - Apply when creating or modifying any rule file.
+
+## 🔐 Enforcement
+
+**When creating/modifying rules, you MUST:**
+1. Follow the exact template below
+2. Keep content concise - no filler words
+3. Use the metadata comments for hook integration
+
+---
+
+## Template
+
+```markdown
+<!-- SUMMARY: One-line description (max 80 chars) -->
+<!-- TRIGGER: code | package | structure | always -->
+# RULE: Name - Short Description
+
+⚠️ **ALWAYS-ACTIVE RULE** - Brief scope statement.
+
+## 🔐 Enforcement
+
+**[When this triggers], you MUST:**
+1. Step one
+2. Step two
+3. Step three
+
+---
+
+## What to Check
+
+- Bullet point checks
+- Keep actionable
+
+## Quick Reference
+
+| Do | Don't |
+|----|-------|
+| Good example | Bad example |
+```
+
+---
+
+## Metadata Fields
+
+| Field | Values | Purpose |
+|-------|--------|---------|
+| `SUMMARY` | Max 80 chars | Displayed in lightweight mode |
+| `TRIGGER` | `code`, `package`, `structure`, `always` | When hook injects this rule |
+
+---
+
+## Principles
+
+1. **Concise** - No paragraphs explaining why. Just what to do.
+2. **Actionable** - Every line should be a clear instruction.
+3. **Scannable** - Use tables, bullets, code blocks. No walls of text.
+4. **Self-contained** - Rule should work without reading other docs.
+
+---
+
+## Anti-Patterns
+
+❌ Long explanations of "why" this rule exists
+❌ Multiple examples when one suffices
+❌ Repeating the same instruction in different words
+❌ Sections that don't add actionable value
+❌ "Philosophy" or "Background" sections

package/templates/rules/subagent-format.md

@@ -0,0 +1,63 @@
+<!-- SUMMARY: Follow standard format when creating or modifying subagents -->
+<!-- TRIGGER: subagent -->
+# RULE: Subagent Format
+
+⚠️ **ACTIVE RULE** - Apply when creating or modifying subagent files.
+
+## 🔐 Enforcement
+
+**When creating/modifying subagents, you MUST:**
+1. Use YAML frontmatter with required fields
+2. Keep prompts concise and actionable
+3. Place in `.claude/agents/` directory
+
+---
+
+## Template
+
+```markdown
+---
+name: agent-name
+description: Brief description. When to use this agent proactively.
+tools: Grep, Glob, Read, WebSearch, Bash
+model: haiku
+---
+
+You are a [role] for [project type].
+
+## Your Task
+
+1. Step one
+2. Step two
+3. Step three
+
+## Output Format
+
+[Expected output structure]
+
+## Rules
+
+- Rule one
+- Rule two
+```
+
+---
+
+## Required Fields
+
+| Field | Purpose |
+|-------|---------|
+| `name` | Unique identifier (kebab-case) |
+| `description` | When Claude should delegate to this agent |
+| `tools` | Allowed tools (Grep, Glob, Read, WebSearch, Bash, Write, Edit) |
+| `model` | `haiku` for fast/cheap, `sonnet` for complex |
+
+---
+
+## Best Practices
+
+- Write clear `description` - Claude uses this to decide when to delegate
+- Limit to 3-4 subagents total per project
+- Use `haiku` model for simple searches
+- Use `sonnet` for complex reasoning
+- Keep prompts focused on one task

package/templates/settings.local.json

@@ -0,0 +1,45 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx create-expo-app:*)",
+      "Bash(npx create-expo-app@latest fast96-app --template blank-typescript)",
+      "Bash(npm install:*)",
+      "Bash(git init:*)",
+      "Bash(git remote add:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git ls-tree:*)",
+      "Bash(git rm:*)",
+      "Bash(chmod:*)"
+    ]
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/session-start.sh",
+            "statusMessage": "Loading project context..."
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/smart-inject-rules.sh",
+            "statusMessage": "Analyzing prompt..."
+          }
+        ]
+      }
+    ]
+  },
+  "sandbox": {
+    "enabled": true
+  }
+}