@hivehub/rulebook 5.4.1 → 5.5.0

package/templates/hooks/terse-mode-tracker.sh

@@ -1,187 +1,187 @@
-#!/usr/bin/env bash
-# Claude Code UserPromptSubmit hook for rulebook-terse (v5.4.0).
-#
-# Parses slash commands + natural-language activation/deactivation
-# phrases in the user prompt, updates the project-local flag file,
-# and emits a short (~45 token) attention anchor as hookSpecificOutput
-# when a persistent mode is active — keeps the compression register in
-# the model's attention on every user message.
-#
-# Independent sub-skill modes (commit / review) do NOT get the anchor:
-# their own SKILL.md files drive behavior for the single turn they're
-# invoked.
-#
-# Silent-fails on every filesystem error.
-
-set -u
-
-input="$(cat || true)"
-prompt=""
-cwd=""
-if [ -n "$input" ]; then
-  # Parse JSON via node (always available in Claude Code hook env).
-  # Emits two lines: prompt on line 1, cwd on line 2.
-  parsed="$(printf '%s' "$input" | node -e "
-    try {
-      const data = JSON.parse(require('fs').readFileSync(0, 'utf8'));
-      process.stdout.write((data.prompt || '') + '\\n' + (data.cwd || ''));
-    } catch { process.stdout.write('\\n'); }
-  " 2>/dev/null || printf '\n')"
-  prompt="$(printf '%s' "$parsed" | head -n 1)"
-  cwd="$(printf '%s' "$parsed" | tail -n +2)"
-fi
-
-PROJECT_ROOT="${cwd:-${CLAUDE_PROJECT_DIR:-$(pwd)}}"
-FLAG_PATH="${PROJECT_ROOT}/.rulebook/.terse-mode"
-CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/rulebook"
-USER_CONFIG="${CONFIG_DIR}/config.json"
-PROJECT_CONFIG="${PROJECT_ROOT}/.rulebook/rulebook.json"
-
-VALID_MODES_RE='^(off|brief|terse|ultra|commit|review)$'
-MAX_FLAG_BYTES=32
-
-resolve_default_mode() {
-  if [ -n "${RULEBOOK_TERSE_MODE:-}" ]; then
-    local m="$(printf '%s' "$RULEBOOK_TERSE_MODE" | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
-    if [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
-  fi
-  if [ -f "$PROJECT_CONFIG" ]; then
-    local m
-    m="$(node -e "
-      try {
-        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
-        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
-      } catch { }
-    " "$PROJECT_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
-    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
-  fi
-  if [ -f "$USER_CONFIG" ]; then
-    local m
-    m="$(node -e "
-      try {
-        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
-        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
-      } catch { }
-    " "$USER_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
-    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
-  fi
-  printf 'terse'
-}
-
-safe_write_flag() {
-  local content="$1"
-  local dir
-  dir="$(dirname "$FLAG_PATH")"
-  mkdir -p "$dir" 2>/dev/null || return 0
-  [ -L "$dir" ] && return 0
-  [ -L "$FLAG_PATH" ] && return 0
-
-  local tmp
-  tmp="$(mktemp "$dir/.terse-mode.XXXXXX" 2>/dev/null)" || return 0
-  {
-    umask 077
-    printf '%s' "$content" > "$tmp" 2>/dev/null || { rm -f "$tmp"; return 0; }
-  }
-  chmod 600 "$tmp" 2>/dev/null || true
-  mv -f "$tmp" "$FLAG_PATH" 2>/dev/null || rm -f "$tmp"
-}
-
-read_flag() {
-  # Symlink-safe, size-capped, whitelist-validated read.
-  [ ! -f "$FLAG_PATH" ] && return 1
-  [ -L "$FLAG_PATH" ] && return 1
-  local size
-  size="$(wc -c < "$FLAG_PATH" 2>/dev/null || echo "$MAX_FLAG_BYTES")"
-  [ "$size" -gt "$MAX_FLAG_BYTES" ] && return 1
-
-  local raw
-  raw="$(head -c "$MAX_FLAG_BYTES" "$FLAG_PATH" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
-  if [[ "$raw" =~ $VALID_MODES_RE ]]; then
-    printf '%s' "$raw"
-    return 0
-  fi
-  return 1
-}
-
-default_mode="$(resolve_default_mode)"
-lower_prompt="$(printf '%s' "$prompt" | tr '[:upper:]' '[:lower:]')"
-
-# Parse intent. Order matters: deactivation wins over accidental
-# activation, slash commands win over natural-language patterns.
-new_mode=""
-deactivate=0
-
-# Slash commands
-if [[ "$lower_prompt" == /rulebook-terse-commit* ]]; then
-  new_mode="commit"
-elif [[ "$lower_prompt" == /rulebook-terse-review* ]]; then
-  new_mode="review"
-elif [[ "$lower_prompt" == /rulebook-terse ]]; then
-  new_mode="$default_mode"
-elif [[ "$lower_prompt" == /rulebook-terse\ * ]]; then
-  arg="$(printf '%s' "$lower_prompt" | awk '{print $2}')"
-  case "$arg" in
-    off) deactivate=1 ;;
-    brief|terse|ultra|commit|review) new_mode="$arg" ;;
-    *) : ;;  # unknown subcommand → leave state unchanged
-  esac
-fi
-
-# Natural-language deactivation — checked first so "stop terse" wins.
-if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
-  if echo "$prompt" | grep -qiE '\b(stop|disable|turn off|deactivate)\b.*\brulebook[- ]?terse\b' \
-     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(stop|disable|turn off|deactivate)\b' \
-     || echo "$prompt" | grep -qiE '\b(stop|disable) terse\b' \
-     || echo "$prompt" | grep -qiE '\bnormal mode\b'; then
-    deactivate=1
-  fi
-fi
-
-# Natural-language activation
-if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
-  if echo "$prompt" | grep -qiE '\b(activate|enable|turn on|start)\b.*\brulebook[- ]?terse\b' \
-     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(mode|activate|enable|turn on|start)\b' \
-     || echo "$prompt" | grep -qiE '\bbe terse\b' \
-     || echo "$prompt" | grep -qiE '\bterse mode\b' \
-     || echo "$prompt" | grep -qiE '\bless tokens?\b'; then
-    new_mode="$default_mode"
-  fi
-fi
-
-# Apply intent
-if [ "$deactivate" -eq 1 ]; then
-  rm -f "$FLAG_PATH" 2>/dev/null || true
-elif [ -n "$new_mode" ]; then
-  if [ "$new_mode" = "off" ]; then
-    rm -f "$FLAG_PATH" 2>/dev/null || true
-  else
-    safe_write_flag "$new_mode"
-  fi
-fi
-
-# Emit attention anchor for persistent modes only.
-active_mode="$(read_flag || true)"
-case "$active_mode" in
-  brief|terse|ultra)
-    if [ "$active_mode" = "brief" ]; then
-      keep_clause="Keep articles and full sentences."
-    else
-      keep_clause="Fragments OK."
-    fi
-    text="RULEBOOK-TERSE ACTIVE (${active_mode}). Drop filler/hedging/pleasantries. ${keep_clause} Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full."
-    # Emit hookSpecificOutput JSON via node — universal across platforms.
-    node -e "
-      const text = process.argv[1];
-      process.stdout.write(JSON.stringify({
-        hookSpecificOutput: {
-          hookEventName: 'UserPromptSubmit',
-          additionalContext: text
-        }
-      }));
-    " "$text" 2>/dev/null || true
-    ;;
-  *)
-    # No active persistent mode, or commit/review sub-skill — no anchor.
-    :
-    ;;
-esac
+#!/usr/bin/env bash
+# Claude Code UserPromptSubmit hook for rulebook-terse (v5.4.0).
+#
+# Parses slash commands + natural-language activation/deactivation
+# phrases in the user prompt, updates the project-local flag file,
+# and emits a short (~45 token) attention anchor as hookSpecificOutput
+# when a persistent mode is active — keeps the compression register in
+# the model's attention on every user message.
+#
+# Independent sub-skill modes (commit / review) do NOT get the anchor:
+# their own SKILL.md files drive behavior for the single turn they're
+# invoked.
+#
+# Silent-fails on every filesystem error.
+
+set -u
+
+input="$(cat || true)"
+prompt=""
+cwd=""
+if [ -n "$input" ]; then
+  # Parse JSON via node (always available in Claude Code hook env).
+  # Emits two lines: prompt on line 1, cwd on line 2.
+  parsed="$(printf '%s' "$input" | node -e "
+    try {
+      const data = JSON.parse(require('fs').readFileSync(0, 'utf8'));
+      process.stdout.write((data.prompt || '') + '\\n' + (data.cwd || ''));
+    } catch { process.stdout.write('\\n'); }
+  " 2>/dev/null || printf '\n')"
+  prompt="$(printf '%s' "$parsed" | head -n 1)"
+  cwd="$(printf '%s' "$parsed" | tail -n +2)"
+fi
+
+PROJECT_ROOT="${cwd:-${CLAUDE_PROJECT_DIR:-$(pwd)}}"
+FLAG_PATH="${PROJECT_ROOT}/.rulebook/.terse-mode"
+CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/rulebook"
+USER_CONFIG="${CONFIG_DIR}/config.json"
+PROJECT_CONFIG="${PROJECT_ROOT}/.rulebook/rulebook.json"
+
+VALID_MODES_RE='^(off|brief|terse|ultra|commit|review)$'
+MAX_FLAG_BYTES=32
+
+resolve_default_mode() {
+  if [ -n "${RULEBOOK_TERSE_MODE:-}" ]; then
+    local m="$(printf '%s' "$RULEBOOK_TERSE_MODE" | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
+    if [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
+  fi
+  if [ -f "$PROJECT_CONFIG" ]; then
+    local m
+    m="$(node -e "
+      try {
+        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
+        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
+      } catch { }
+    " "$PROJECT_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
+    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
+  fi
+  if [ -f "$USER_CONFIG" ]; then
+    local m
+    m="$(node -e "
+      try {
+        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
+        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
+      } catch { }
+    " "$USER_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
+    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
+  fi
+  printf 'terse'
+}
+
+safe_write_flag() {
+  local content="$1"
+  local dir
+  dir="$(dirname "$FLAG_PATH")"
+  mkdir -p "$dir" 2>/dev/null || return 0
+  [ -L "$dir" ] && return 0
+  [ -L "$FLAG_PATH" ] && return 0
+
+  local tmp
+  tmp="$(mktemp "$dir/.terse-mode.XXXXXX" 2>/dev/null)" || return 0
+  {
+    umask 077
+    printf '%s' "$content" > "$tmp" 2>/dev/null || { rm -f "$tmp"; return 0; }
+  }
+  chmod 600 "$tmp" 2>/dev/null || true
+  mv -f "$tmp" "$FLAG_PATH" 2>/dev/null || rm -f "$tmp"
+}
+
+read_flag() {
+  # Symlink-safe, size-capped, whitelist-validated read.
+  [ ! -f "$FLAG_PATH" ] && return 1
+  [ -L "$FLAG_PATH" ] && return 1
+  local size
+  size="$(wc -c < "$FLAG_PATH" 2>/dev/null || echo "$MAX_FLAG_BYTES")"
+  [ "$size" -gt "$MAX_FLAG_BYTES" ] && return 1
+
+  local raw
+  raw="$(head -c "$MAX_FLAG_BYTES" "$FLAG_PATH" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
+  if [[ "$raw" =~ $VALID_MODES_RE ]]; then
+    printf '%s' "$raw"
+    return 0
+  fi
+  return 1
+}
+
+default_mode="$(resolve_default_mode)"
+lower_prompt="$(printf '%s' "$prompt" | tr '[:upper:]' '[:lower:]')"
+
+# Parse intent. Order matters: deactivation wins over accidental
+# activation, slash commands win over natural-language patterns.
+new_mode=""
+deactivate=0
+
+# Slash commands
+if [[ "$lower_prompt" == /rulebook-terse-commit* ]]; then
+  new_mode="commit"
+elif [[ "$lower_prompt" == /rulebook-terse-review* ]]; then
+  new_mode="review"
+elif [[ "$lower_prompt" == /rulebook-terse ]]; then
+  new_mode="$default_mode"
+elif [[ "$lower_prompt" == /rulebook-terse\ * ]]; then
+  arg="$(printf '%s' "$lower_prompt" | awk '{print $2}')"
+  case "$arg" in
+    off) deactivate=1 ;;
+    brief|terse|ultra|commit|review) new_mode="$arg" ;;
+    *) : ;;  # unknown subcommand → leave state unchanged
+  esac
+fi
+
+# Natural-language deactivation — checked first so "stop terse" wins.
+if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
+  if echo "$prompt" | grep -qiE '\b(stop|disable|turn off|deactivate)\b.*\brulebook[- ]?terse\b' \
+     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(stop|disable|turn off|deactivate)\b' \
+     || echo "$prompt" | grep -qiE '\b(stop|disable) terse\b' \
+     || echo "$prompt" | grep -qiE '\bnormal mode\b'; then
+    deactivate=1
+  fi
+fi
+
+# Natural-language activation
+if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
+  if echo "$prompt" | grep -qiE '\b(activate|enable|turn on|start)\b.*\brulebook[- ]?terse\b' \
+     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(mode|activate|enable|turn on|start)\b' \
+     || echo "$prompt" | grep -qiE '\bbe terse\b' \
+     || echo "$prompt" | grep -qiE '\bterse mode\b' \
+     || echo "$prompt" | grep -qiE '\bless tokens?\b'; then
+    new_mode="$default_mode"
+  fi
+fi
+
+# Apply intent
+if [ "$deactivate" -eq 1 ]; then
+  rm -f "$FLAG_PATH" 2>/dev/null || true
+elif [ -n "$new_mode" ]; then
+  if [ "$new_mode" = "off" ]; then
+    rm -f "$FLAG_PATH" 2>/dev/null || true
+  else
+    safe_write_flag "$new_mode"
+  fi
+fi
+
+# Emit attention anchor for persistent modes only.
+active_mode="$(read_flag || true)"
+case "$active_mode" in
+  brief|terse|ultra)
+    if [ "$active_mode" = "brief" ]; then
+      keep_clause="Keep articles and full sentences."
+    else
+      keep_clause="Fragments OK."
+    fi
+    text="RULEBOOK-TERSE ACTIVE (${active_mode}). Drop filler/hedging/pleasantries. ${keep_clause} Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full."
+    # Emit hookSpecificOutput JSON via node — universal across platforms.
+    node -e "
+      const text = process.argv[1];
+      process.stdout.write(JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: 'UserPromptSubmit',
+          additionalContext: text
+        }
+      }));
+    " "$text" 2>/dev/null || true
+    ;;
+  *)
+    # No active persistent mode, or commit/review sub-skill — no anchor.
+    :
+    ;;
+esac

package/templates/ides/CONTINUE_RULES.md

@@ -1,16 +1,16 @@
-<!-- RULEBOOK:START -->
-# Continue.dev — Code Assistant Rules
-
-## Context Loading
-- Always read AGENTS.md before making changes
-- Check `.rulebook/specs/` for relevant spec files
-
-## Code Standards
-- Match existing code style and conventions
-- Prefer editing existing files over creating new ones
-- Add types for all new parameters and return values
-
-## Testing
-- Write tests for every new function
-- Run existing tests after changes to verify no regressions
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# Continue.dev — Code Assistant Rules
+
+## Context Loading
+- Always read AGENTS.md before making changes
+- Check `.rulebook/specs/` for relevant spec files
+
+## Code Standards
+- Match existing code style and conventions
+- Prefer editing existing files over creating new ones
+- Add types for all new parameters and return values
+
+## Testing
+- Write tests for every new function
+- Run existing tests after changes to verify no regressions
+<!-- RULEBOOK:END -->

package/templates/ides/COPILOT.md

@@ -1,37 +1,37 @@
-<!-- COPILOT:START -->
-# GitHub Copilot Rules
-
-**Tool**: GitHub's AI pair programmer (inline + chat)
-
-## Quick Start
-
-Copilot reads:
-- `.github/copilot-instructions.md` (generated by `rulebook init`)
-- Workspace context (open files)
-
-## Usage
-
-```bash
-# In Copilot Chat:
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-
-# Inline suggestions:
-Accept/reject based on AGENTS.md standards
-```
-
-## Modes
-
-**Inline Completions**: Context-aware suggestions while typing
-**Copilot Chat**: Ask questions, request implementations
-**Workspace Agent** (Labs): Multi-file autonomous mode
-
-## Workflow
-
-1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
-2. Keep AGENTS.md open for context
-3. Use `@workspace` to include project context
-4. Reference `@AGENTS.md` explicitly in chat
-
-**Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
-
-<!-- COPILOT:END -->
+<!-- COPILOT:START -->
+# GitHub Copilot Rules
+
+**Tool**: GitHub's AI pair programmer (inline + chat)
+
+## Quick Start
+
+Copilot reads:
+- `.github/copilot-instructions.md` (generated by `rulebook init`)
+- Workspace context (open files)
+
+## Usage
+
+```bash
+# In Copilot Chat:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Inline suggestions:
+Accept/reject based on AGENTS.md standards
+```
+
+## Modes
+
+**Inline Completions**: Context-aware suggestions while typing
+**Copilot Chat**: Ask questions, request implementations
+**Workspace Agent** (Labs): Multi-file autonomous mode
+
+## Workflow
+
+1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
+2. Keep AGENTS.md open for context
+3. Use `@workspace` to include project context
+4. Reference `@AGENTS.md` explicitly in chat
+
+**Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
+
+<!-- COPILOT:END -->

package/templates/ides/COPILOT_INSTRUCTIONS.md

@@ -1,23 +1,23 @@
-<!-- RULEBOOK:START -->
-# GitHub Copilot — Project Instructions
-
-## Code Style
-- Use TypeScript with strict mode
-- Follow existing naming conventions (camelCase functions, PascalCase classes)
-- Prefer `async/await` over callbacks or raw Promises
-
-## Architecture
-- Follow the module structure described in AGENTS.md
-- Keep functions small and focused (single responsibility)
-- Use dependency injection over direct imports where possible
-
-## Testing
-- Write Vitest tests for all new functions
-- Place tests in `tests/` directory, not alongside source files
-- Mock external dependencies in unit tests
-
-## Security
-- Never commit credentials or API keys
-- Validate all external input at system boundaries
-- Follow OWASP top 10 guidelines
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# GitHub Copilot — Project Instructions
+
+## Code Style
+- Use TypeScript with strict mode
+- Follow existing naming conventions (camelCase functions, PascalCase classes)
+- Prefer `async/await` over callbacks or raw Promises
+
+## Architecture
+- Follow the module structure described in AGENTS.md
+- Keep functions small and focused (single responsibility)
+- Use dependency injection over direct imports where possible
+
+## Testing
+- Write Vitest tests for all new functions
+- Place tests in `tests/` directory, not alongside source files
+- Mock external dependencies in unit tests
+
+## Security
+- Never commit credentials or API keys
+- Validate all external input at system boundaries
+- Follow OWASP top 10 guidelines
+<!-- RULEBOOK:END -->

package/templates/ides/CURSOR.md

@@ -1,43 +1,43 @@
-<!-- CURSOR:START -->
-# Cursor IDE Rules
-
-**IDE**: AI-first code editor with Agent mode and Composer
-
-## Quick Start
-
-Cursor automatically reads:
-- `.cursorrules` (generated by `rulebook init`)
-- `AGENTS.md` (via `@AGENTS.md` references)
-
-## Usage
-
-```bash
-# In Cursor chat/composer:
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-
-# Agent mode (Ctrl+Shift+K):
-Use for complex multi-file changes
-Reference @AGENTS.md for standards
-
-# Composer (Cmd+I):
-Use for quick edits
-Reference @AGENTS.md when needed
-```
-
-## Features
-
-- **Auto-context**: Reads .cursorrules automatically
-- **@ Mentions**: Use `@AGENTS.md` to include standards
-- **Agent Mode**: Autonomous multi-step implementations
-- **Composer**: Quick inline edits
-
-## Workflow
-
-1. Rulebook generates `.cursorrules` pointing to AGENTS.md
-2. Use `@AGENTS.md` in prompts for explicit reference
-3. Agent/Composer follows standards automatically
-4. Review changes and run quality checks
-
-**Critical**: `.cursorrules` ensures Cursor follows AGENTS.md by default.
-
-<!-- CURSOR:END -->
+<!-- CURSOR:START -->
+# Cursor IDE Rules
+
+**IDE**: AI-first code editor with Agent mode and Composer
+
+## Quick Start
+
+Cursor automatically reads:
+- `.cursorrules` (generated by `rulebook init`)
+- `AGENTS.md` (via `@AGENTS.md` references)
+
+## Usage
+
+```bash
+# In Cursor chat/composer:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Agent mode (Ctrl+Shift+K):
+Use for complex multi-file changes
+Reference @AGENTS.md for standards
+
+# Composer (Cmd+I):
+Use for quick edits
+Reference @AGENTS.md when needed
+```
+
+## Features
+
+- **Auto-context**: Reads .cursorrules automatically
+- **@ Mentions**: Use `@AGENTS.md` to include standards
+- **Agent Mode**: Autonomous multi-step implementations
+- **Composer**: Quick inline edits
+
+## Workflow
+
+1. Rulebook generates `.cursorrules` pointing to AGENTS.md
+2. Use `@AGENTS.md` in prompts for explicit reference
+3. Agent/Composer follows standards automatically
+4. Review changes and run quality checks
+
+**Critical**: `.cursorrules` ensures Cursor follows AGENTS.md by default.
+
+<!-- CURSOR:END -->

package/templates/ides/GEMINI_RULES.md

@@ -1,17 +1,17 @@
-<!-- RULEBOOK:START -->
-# Gemini CLI — Project Directives
-
-## Code Generation Rules
-- Generate TypeScript with strict mode enabled
-- Follow existing file and function naming conventions
-- Always add error handling for async operations
-- Generate tests alongside implementation code
-
-## Quality Standards
-- All code must pass TypeScript type-check
-- All code must pass ESLint without warnings
-- Test coverage must meet project thresholds
-
-## Project Context
-See AGENTS.md for full project architecture and team conventions.
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# Gemini CLI — Project Directives
+
+## Code Generation Rules
+- Generate TypeScript with strict mode enabled
+- Follow existing file and function naming conventions
+- Always add error handling for async operations
+- Generate tests alongside implementation code
+
+## Quality Standards
+- All code must pass TypeScript type-check
+- All code must pass ESLint without warnings
+- Test coverage must meet project thresholds
+
+## Project Context
+See AGENTS.md for full project architecture and team conventions.
+<!-- RULEBOOK:END -->