oh-my-customcode 0.7.0 → 0.9.0

package/templates/.codex/contexts/review.md

@@ -0,0 +1,23 @@
+# Code Review Context
+
+Mode: PR review and code analysis
+Focus: Quality, security, maintainability
+
+## Behavior
+- Read thoroughly before commenting
+- Organize findings by severity
+- Suggest fixes, not just problems
+- Check for security vulnerabilities
+
+## Review Checklist
+1. Logic correctness and edge cases
+2. Error handling and exceptions
+3. Security concerns (injection, credentials)
+4. Performance implications
+5. Code readability
+6. Test coverage
+
+## Output Format
+- Group by file
+- Sort by severity (critical > high > medium > low)
+- Provide actionable suggestions

package/templates/.codex/hooks/hooks.json

@@ -0,0 +1,151 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm run dev|pnpm( run)? dev|yarn dev|bun run dev)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\ncmd=$(echo \"$input\" | jq -r '.tool_input.command // \"\"')\n\n# Block dev servers that aren't run in tmux\necho '[Hook] BLOCKED: Dev server must run in tmux for log access' >&2\necho '[Hook] Use this command instead:' >&2\necho \"[Hook] tmux new-session -d -s dev 'npm run dev'\" >&2\necho '[Hook] Then: tmux attach -t dev' >&2\nexit 1"
+          }
+        ],
+        "description": "Block dev servers outside tmux - ensures you can access logs"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm (install|test)|pnpm (install|test)|yarn (install|test)|bun (install|test)|cargo build|make|docker|pytest|vitest|playwright)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nif [ -z \"$TMUX\" ]; then\n  echo '[Hook] Consider running in tmux for session persistence' >&2\n  echo '[Hook] tmux new -s dev  |  tmux attach -t dev' >&2\nfi\necho \"$input\""
+          }
+        ],
+        "description": "Reminder to use tmux for long-running commands"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\necho '[Hook] Review changes before push...' >&2\necho '[Hook] Press Enter to continue with push or Ctrl+C to abort...' >&2\nread -r"
+          }
+        ],
+        "description": "Pause before git push to review changes"
+      },
+      {
+        "matcher": "tool == \"Write\" && tool_input.file_path matches \"\\\\.(md|txt)$\" && !(tool_input.file_path matches \"README\\\\.md|CLAUDE\\\\.md|AGENT\\\\.md|SKILL\\\\.md\")",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [[ \"$file_path\" =~ \\.(md|txt)$ ]] && [[ ! \"$file_path\" =~ (README|CLAUDE|AGENT|SKILL)\\.md$ ]]; then\n  echo \"[Hook] BLOCKED: Unnecessary documentation file creation\" >&2\n  echo \"[Hook] File: $file_path\" >&2\n  echo \"[Hook] Use README.md or AGENT.md for documentation instead\" >&2\n  exit 1\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Block creation of random .md files - keeps docs consolidated"
+      },
+      {
+        "matcher": "tool == \"Edit\" || tool == \"Write\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\nCOUNTER_FILE=\"/tmp/claude-tool-count-$$\"\nTHRESHOLD=${COMPACT_THRESHOLD:-50}\nif [ -f \"$COUNTER_FILE\" ]; then COUNT=$(cat \"$COUNTER_FILE\"); COUNT=$((COUNT + 1)); else COUNT=1; fi\necho \"$COUNT\" > \"$COUNTER_FILE\"\nif [ \"$COUNT\" -eq \"$THRESHOLD\" ]; then echo '[StrategicCompact] Reached '$THRESHOLD' tool calls' >&2; echo '[StrategicCompact] Consider /compact if at a logical breakpoint' >&2; fi\nif [ \"$COUNT\" -gt \"$THRESHOLD\" ] && [ $(((COUNT - THRESHOLD) % 25)) -eq 0 ]; then echo \"[StrategicCompact] $COUNT tool calls - /compact reminder\" >&2; fi\ncat"
+          }
+        ],
+        "description": "Suggest manual compaction at logical intervals"
+      },
+      {
+        "matcher": "tool == \"Task\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nagent_type=$(echo \"$input\" | jq -r '.tool_input.subagent_type // \"unknown\"')\nmodel=$(echo \"$input\" | jq -r '.tool_input.model // \"inherit\"')\ndesc=$(echo \"$input\" | jq -r '.tool_input.description // \"\"' | head -c 40)\nresume=$(echo \"$input\" | jq -r '.tool_input.resume // empty')\nif [ -n \"$resume\" ]; then\n  echo \"─── [Resume] ${agent_type}:${model} | ${desc} ───\" >&2\nelse\n  echo \"─── [Spawn] ${agent_type}:${model} | ${desc} ───\" >&2\nfi\necho \"$input\""
+          }
+        ],
+        "description": "HUD statusline - show subagent_type, model, and description on Task spawn"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "tool == \"Bash\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\ncmd=$(echo \"$input\" | jq -r '.tool_input.command')\n\nif echo \"$cmd\" | grep -qE 'gh pr create'; then\n  output=$(echo \"$input\" | jq -r '.tool_output.output // \"\"')\n  pr_url=$(echo \"$output\" | grep -oE 'https://github.com/[^/]+/[^/]+/pull/[0-9]+')\n  \n  if [ -n \"$pr_url\" ]; then\n    echo \"[Hook] PR created: $pr_url\" >&2\n    echo \"[Hook] Checking GitHub Actions status...\" >&2\n    repo=$(echo \"$pr_url\" | sed -E 's|https://github.com/([^/]+/[^/]+)/pull/[0-9]+|\\1|')\n    pr_num=$(echo \"$pr_url\" | sed -E 's|.*/pull/([0-9]+)|\\1|')\n    echo \"[Hook] To review PR: gh pr review $pr_num --repo $repo\" >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Log PR URL and provide review command after PR creation"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  if command -v prettier >/dev/null 2>&1; then\n    prettier --write \"$file_path\" 2>&1 | head -5 >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Auto-format JS/TS files with Prettier after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  dir=$(dirname \"$file_path\")\n  project_root=\"$dir\"\n  while [ \"$project_root\" != \"/\" ] && [ ! -f \"$project_root/package.json\" ]; do\n    project_root=$(dirname \"$project_root\")\n  done\n  \n  if [ -f \"$project_root/tsconfig.json\" ]; then\n    cd \"$project_root\" && npx tsc --noEmit --pretty false 2>&1 | grep \"$file_path\" | head -10 >&2 || true\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "TypeScript check after editing .ts/.tsx files"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  console_logs=$(grep -n \"console\\\\.log\" \"$file_path\" 2>/dev/null || true)\n  \n  if [ -n \"$console_logs\" ]; then\n    echo \"[Hook] WARNING: console.log found in $file_path\" >&2\n    echo \"$console_logs\" | head -5 >&2\n    echo \"[Hook] Remove console.log before committing\" >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Warn about console.log statements after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(go)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  if command -v gofmt >/dev/null 2>&1; then\n    gofmt -w \"$file_path\" 2>&1 >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Auto-format Go files with gofmt after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(py)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  # Format with ruff\n  if command -v ruff >/dev/null 2>&1; then\n    ruff format --quiet \"$file_path\" 2>&1 >&2\n    ruff check --fix --quiet \"$file_path\" 2>&1 >&2 || true\n    echo \"[Hook] Python formatted with ruff\" >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Auto-format and lint Python files with ruff after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(py)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  # Type check with ty\n  if command -v ty >/dev/null 2>&1; then\n    dir=$(dirname \"$file_path\")\n    project_root=\"$dir\"\n    while [ \"$project_root\" != \"/\" ] && [ ! -f \"$project_root/pyproject.toml\" ]; do\n      project_root=$(dirname \"$project_root\")\n    done\n    \n    if [ -f \"$project_root/pyproject.toml\" ]; then\n      cd \"$project_root\" && ty check \"$file_path\" 2>&1 | head -10 >&2 || true\n    else\n      ty check \"$file_path\" 2>&1 | head -10 >&2 || true\n    fi\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Type check Python files with ty after edits"
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\n\nif git rev-parse --git-dir > /dev/null 2>&1; then\n  modified_files=$(git diff --name-only HEAD 2>/dev/null | grep -E '\\.(ts|tsx|js|jsx)$' || true)\n  \n  if [ -n \"$modified_files\" ]; then\n    has_console=false\n    while IFS= read -r file; do\n      if [ -f \"$file\" ]; then\n        if grep -q \"console\\.log\" \"$file\" 2>/dev/null; then\n          echo \"[Hook] WARNING: console.log found in $file\" >&2\n          has_console=true\n        fi\n      fi\n    done <<< \"$modified_files\"\n    \n    if [ \"$has_console\" = true ]; then\n      echo \"[Hook] Remove console.log statements before committing\" >&2\n    fi\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Final audit for console.log in modified files before session ends"
+      }
+    ]
+  }
+}

package/templates/.codex/install-hooks.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# Claude Code Hooks & Contexts Installer
+# Source: https://github.com/affaan-m/everything-claude-code
+# Hook installation script
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_HOME="${HOME}/.codex"
+SETTINGS_FILE="${CLAUDE_HOME}/settings.json"
+
+echo "┌─────────────────────────────────────────────┐"
+echo "│  Claude Code Hooks & Contexts Installer     │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+
+# Create directories
+echo "[1/5] Creating directories..."
+mkdir -p "${CLAUDE_HOME}/hooks/memory-persistence"
+mkdir -p "${CLAUDE_HOME}/hooks/strategic-compact"
+mkdir -p "${CLAUDE_HOME}/sessions"
+mkdir -p "${CLAUDE_HOME}/skills/learned"
+mkdir -p "${CLAUDE_HOME}/contexts"
+echo "      ✓ Directories created"
+
+# Copy scripts
+echo "[2/5] Copying hook scripts..."
+cp "${SCRIPT_DIR}/hooks/memory-persistence/"*.sh "${CLAUDE_HOME}/hooks/memory-persistence/"
+cp "${SCRIPT_DIR}/hooks/strategic-compact/"*.sh "${CLAUDE_HOME}/hooks/strategic-compact/"
+echo "      ✓ Scripts copied"
+
+# Copy contexts
+echo "[3/5] Copying context files..."
+cp "${SCRIPT_DIR}/contexts/"*.md "${CLAUDE_HOME}/contexts/"
+echo "      ✓ Contexts copied"
+
+# Set permissions
+echo "[4/5] Setting execute permissions..."
+chmod +x "${CLAUDE_HOME}/hooks/memory-persistence/"*.sh
+chmod +x "${CLAUDE_HOME}/hooks/strategic-compact/"*.sh
+echo "      ✓ Permissions set"
+
+# Handle settings.json
+echo "[5/5] Configuring settings.json..."
+
+if [ -f "$SETTINGS_FILE" ]; then
+  # Backup existing settings
+  BACKUP_FILE="${SETTINGS_FILE}.backup.$(date +%Y%m%d_%H%M%S)"
+  cp "$SETTINGS_FILE" "$BACKUP_FILE"
+  echo "      ✓ Backed up existing settings to: $BACKUP_FILE"
+
+  # Check if jq is available for merging
+  if command -v jq &> /dev/null; then
+    # Merge hooks into existing settings
+    HOOKS_JSON="${SCRIPT_DIR}/hooks/hooks.json"
+    TEMP_FILE=$(mktemp)
+
+    # Extract hooks from hooks.json and merge with existing settings
+    jq -s '.[0] * .[1]' "$SETTINGS_FILE" "$HOOKS_JSON" > "$TEMP_FILE"
+    mv "$TEMP_FILE" "$SETTINGS_FILE"
+    echo "      ✓ Merged hooks into settings.json"
+  else
+    echo "      ⚠ jq not found. Please manually merge hooks."
+    echo "      Copy content from: ${SCRIPT_DIR}/hooks/hooks.json"
+    echo "      Into: ${SETTINGS_FILE}"
+  fi
+else
+  # Create new settings.json from hooks.json
+  cp "${SCRIPT_DIR}/hooks/hooks.json" "$SETTINGS_FILE"
+  echo "      ✓ Created new settings.json"
+fi
+
+echo ""
+echo "┌─────────────────────────────────────────────┐"
+echo "│  Installation Complete!                     │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+echo "Installed to: ${CLAUDE_HOME}/"
+echo ""
+echo "Structure:"
+echo "  ~/.codex/"
+echo "  ├── settings.json          (hooks config)"
+echo "  ├── hooks/"
+echo "  │   ├── memory-persistence/"
+echo "  │   │   ├── pre-compact.sh"
+echo "  │   │   ├── session-start.sh"
+echo "  │   │   └── session-end.sh"
+echo "  │   └── strategic-compact/"
+echo "  │       └── suggest-compact.sh"
+echo "  ├── contexts/"
+echo "  │   ├── dev.md"
+echo "  │   ├── review.md"
+echo "  │   └── research.md"
+echo "  ├── sessions/              (auto-created logs)"
+echo "  └── skills/learned/        (for future use)"
+echo ""
+echo "Next steps:"
+echo "  1. Restart Claude Code to activate hooks"
+echo "  2. Use contexts by referencing them in prompts"
+echo ""

package/templates/.codex/rules/MAY-optimization.md

@@ -0,0 +1,93 @@
+# [MAY] Optimization Guide
+
+> **Priority**: MAY - Optional
+> **Apply when**: Basic functionality is stable
+
+## Efficiency Optimization
+
+### Parallel Processing
+```
+Apply when:
+- 3+ independent tasks
+- Each task is I/O bound
+
+Example:
+- Read multiple files simultaneously
+- Run independent searches in parallel
+```
+
+### Caching
+```
+Apply when:
+- Same data accessed repeatedly
+- Data changes infrequently
+
+Example:
+- Cache file contents
+- Reuse search results
+```
+
+### Lazy Loading
+```
+Apply when:
+- Large datasets
+- Only portion actually used
+
+Example:
+- Read only needed files
+- Stream results
+```
+
+## Token Optimization
+
+### Context Management
+```
+✓ Include only necessary info
+✓ Remove duplicates
+✓ Use summaries
+```
+
+### Response Optimization
+```
+✓ Concise expressions
+✓ Minimize code blocks
+✓ Remove unnecessary repetition
+```
+
+## Task Optimization
+
+### Batch Processing
+```
+Group similar tasks together
+Example: Edit 10 files → Process at once
+```
+
+### Incremental Processing
+```
+Process only changed parts
+Example: Full build → Incremental build
+```
+
+## Apply Criteria
+
+### Do Optimize
+```
+✓ Repetitive tasks
+✓ Clear performance bottleneck
+✓ Measurable improvement
+```
+
+### Don't Optimize
+```
+✗ One-time tasks
+✗ Already fast enough
+✗ Complexity increase outweighs benefit
+```
+
+## Caution
+
+```
+⚠ Premature optimization is root of evil
+⚠ Readability > Optimization
+⚠ No optimization without measurement
+```

package/templates/.codex/rules/MUST-agent-design.md

@@ -0,0 +1,162 @@
+# [MUST] Agent Design Rules
+
+> **Priority**: MUST - Never violate
+> **ID**: R006
+
+## Agent Structure
+
+### Single File Format
+```
+.codex/agents/{name}.md
+
+Format:
+---
+name: agent-name
+description: Brief agent description
+model: sonnet | opus | haiku
+memory: project            # Optional
+tools:
+  - Read
+  - Write
+  - Bash
+skills:
+  - skill-name-1
+  - skill-name-2
+---
+
+# Agent Content
+
+Agent purpose and role description...
+```
+
+### Frontmatter Fields (REQUIRED)
+```yaml
+name: agent-name           # Unique identifier (kebab-case)
+description: Brief desc    # One-line summary
+model: sonnet             # Default model (sonnet | opus | haiku)
+memory: project           # Persistent memory scope (user | project | local)
+effort: high              # Effort level (low | medium | high)
+tools: [Read, Write, ...]  # Allowed tools
+skills: [skill-1, ...]     # Required skill names
+```
+
+### Memory Scope Reference
+| Scope | Location | Use Case |
+|-------|----------|----------|
+| `user` | `~/.codex/agent-memory/<name>/` | Cross-project learnings (infra, db) |
+| `project` | `.codex/agent-memory/<name>/` | Project-specific, versioned |
+| `local` | `.codex/agent-memory-local/<name>/` | Project-specific, not versioned |
+
+### Effort Level Reference
+| Level | Use Case | Agents |
+|-------|----------|--------|
+| `high` | Complex reasoning, design decisions | lang-*, be-*, arch-*, qa-planner |
+| `medium` | Routine operations, structured work | fe-*, tool-*, mgr-gitnerd |
+| `low` | Simple validation, file scanning | mgr-supplier, mgr-sync-checker, sys-naggy |
+
+### Agent Content Must NOT Contain
+```
+✗ Detailed skill instructions (use .codex/skills/ instead)
+✗ Reference documentation (use guides/ instead)
+✗ Implementation scripts (use .codex/skills/{name}/scripts/ instead)
+```
+
+### Agent Content Should Contain
+```
+✓ Agent purpose and role
+✓ Capabilities overview (not details)
+✓ Required skills (by name reference)
+✓ Workflow description
+✓ Source info (if external)
+```
+
+## Memory Scope (OPTIONAL)
+
+Agents can have persistent memory that survives across conversations.
+
+| Scope | Location | Use Case | Git Tracked |
+|-------|----------|----------|-------------|
+| `user` | `~/.codex/agent-memory/<name>/` | Cross-project learnings (infra, DB patterns) | No |
+| `project` | `.codex/agent-memory/<name>/` | Project-specific patterns | Yes |
+| `local` | `.codex/agent-memory-local/<name>/` | Local-only knowledge | No |
+
+When enabled:
+- First 200 lines of MEMORY.md loaded into agent's system prompt
+- Read/Write/Edit tools automatically enabled for memory directory
+- Agent builds knowledge across conversations
+
+Agents that should NOT have memory (stateless by design):
+- Manager agents for one-time operations (mgr-creator, mgr-updater, mgr-supplier)
+- Validation agents (mgr-sync-checker, mgr-claude-code-bible)
+- Meta-agents (sys-memory-keeper, sys-naggy)
+
+## External Agent Requirements
+
+External agents (from GitHub, npm, etc.) MUST include source information in frontmatter:
+
+### Frontmatter Source Fields
+```yaml
+source:
+  type: external
+  origin: github | npm | other
+  url: https://github.com/org/repo
+  version: 1.0.0
+  last_updated: 2025-01-22
+  update_command: "npx add-skill org/repo"
+```
+
+### Update Tracking
+```
+- version: Current version installed
+- last_updated: Date of last sync
+- update_command: Command to update
+- changelog_url: Where to check updates
+```
+
+## Separation of Concerns
+
+### .codex/agents/
+```
+Purpose: Define WHAT the agent does
+Content: Role, capabilities, workflow
+Format: Single .md file with YAML frontmatter
+NOT: How to do it (that's skills/)
+```
+
+### .codex/skills/
+```
+Purpose: Define HOW to do tasks
+Content: Instructions, scripts, rules
+Location: .codex/skills/{name}/SKILL.md
+```
+
+### guides/
+```
+Purpose: Reference documentation
+Content: Best practices, tutorials
+Location: guides/{topic}/
+```
+
+## Agent → Skill References
+
+### In Frontmatter
+```yaml
+---
+name: agent-name
+skills:
+  - react-best-practices
+  - web-design-guidelines
+---
+```
+
+Skills are referenced by name only. The system automatically discovers skills in `.codex/skills/` by scanning for `SKILL.md` files.
+
+## Naming Conventions
+
+| Type | Pattern | Example |
+|------|---------|---------|
+| Agent file | `kebab-case.md` | `.codex/agents/fe-vercel-agent.md` |
+| Skill directory | `kebab-case/` | `.codex/skills/react-best-practices/` |
+| Guide directory | `kebab-case/` | `guides/web-design/` |
+| Agent filename | lowercase | `{name}.md` |
+| Skill file | UPPERCASE | `SKILL.md` |

package/templates/.codex/rules/MUST-agent-identification.md

@@ -0,0 +1,108 @@
+# [MUST] Agent Identification Rules
+
+> **Priority**: MUST - ENFORCED, NO EXCEPTIONS
+> **ID**: R007
+> **Violation**: Immediate correction required
+
+## CRITICAL
+
+**EVERY response MUST start with agent identification. This is NON-NEGOTIABLE.**
+
+Failure to include agent identification = Rule violation = Must be corrected immediately.
+
+## Purpose
+
+Display which agent is responding and which skills are being used for transparency and traceability.
+
+## Response Header Format
+
+Every response MUST start with an agent identification block:
+
+```
+┌─ Agent: {agent-name} ({agent-type})
+├─ Skill: {skill-name} (if applicable)
+└─ Task: {brief-task-description}
+```
+
+## Examples
+
+### Single Agent Response
+```
+┌─ Agent: mgr-creator (manager)
+└─ Task: Creating new agent
+
+[Response content...]
+```
+
+### With Skill Usage
+```
+┌─ Agent: fe-vercel-agent (worker)
+├─ Skill: react-best-practices
+└─ Task: Optimizing React component
+
+[Response content...]
+```
+
+### Multiple Skills
+```
+┌─ Agent: fe-vercel-agent (worker)
+├─ Skills: react-best-practices, web-design-guidelines
+└─ Task: Full code review
+
+[Response content...]
+```
+
+### No Specific Agent (Default)
+```
+┌─ Agent: claude (default)
+└─ Task: General assistance
+
+[Response content...]
+```
+
+## When to Display
+
+| Situation | Display |
+|-----------|---------|
+| Agent-specific task | Full header with agent |
+| Using skill | Include skill name |
+| General conversation | "claude (default)" |
+| Multiple agents | Show primary agent |
+
+## Agent Types
+
+| Type | Symbol | Example |
+|------|--------|---------|
+| manager | 🔧 | mgr-creator, mgr-updater |
+| worker | ⚙️ | fe-vercel-agent |
+| orchestrator | 🎯 | (future) |
+| default | 💬 | claude |
+
+## Simplified Format (Optional)
+
+For brief responses, use inline format:
+
+```
+[mgr-creator] Creating agent structure...
+```
+
+Or with skill:
+
+```
+[fe-vercel-agent → react-best-practices] Analyzing performance...
+```
+
+## Status Updates
+
+During long tasks, show progress with agent context:
+
+```
+┌─ Agent: mgr-updater (manager)
+└─ Task: Checking external updates
+
+[Progress] Scanning .codex/agents/ (1/3)
+[Progress] Scanning .codex/skills/ (2/3)
+[Progress] Scanning .codex/guides/ (3/3)
+
+[Done] Found 2 updates available
+```