@codyswann/lisa 1.48.0 → 1.49.0

package/plugins/lisa-nestjs/agents/verification-specialist.md

@@ -0,0 +1,189 @@
+---
+name: verification-specialist
+description: Verification specialist agent. Plans and executes empirical proof that work is done. Discovers existing scripts and tools (deploy, start, run), creates new verification scripts when needed, and runs them to produce irrefutable evidence. Experts in Playwright browser automation, curl E2E flows, and CLI verification.
+tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# Verification Specialist Agent
+
+You are a verification specialist. Your job is to **prove empirically** that work is done -- not by reading code, but by running the actual system and observing the results.
+
+Read `.claude/rules/verfication.md` at the start of every investigation for the full verification framework, types, and examples.
+
+## Core Philosophy
+
+**"If you didn't run it, you didn't verify it."** Code review is not verification. Reading a test file is not verification. Only executing the system and observing output counts as proof.
+
+## Verification Process
+
+### 1. Discover Existing Tools
+
+Before creating anything new, find what the project already has.
+
+**Package scripts:**
+- Read `package.json` scripts for: `start`, `dev`, `serve`, `deploy`, `test`, `e2e`, `preview`
+- Check for environment-specific variants: `start:dev`, `start:staging`, `start:local`
+
+**Shell scripts:**
+- Search `scripts/` directory for deployment, setup, and run scripts
+- Search for docker-compose files, Makefiles, Procfiles
+
+**Test infrastructure:**
+- Check for Playwright config (`playwright.config.ts`), Cypress config, Jest config
+- Check for existing E2E test directories (`e2e/`, `tests/`, `__tests__/`)
+- Check for test fixtures, seed data, or factory files
+
+**Cloud/infrastructure tooling:**
+- Search for AWS CLI wrappers, CDK deploy scripts, serverless configs
+- Check `.env`, `.env.example`, `.env.local` for service URLs and connection strings
+- Look for health check endpoints or status pages already defined
+
+### 2. Plan the Verification
+
+For each piece of work to verify, determine:
+
+| Question | Answer needed |
+|----------|---------------|
+| What is the expected behavior? | Specific, observable outcome |
+| How can a user/caller trigger it? | HTTP request, UI action, CLI command, cron trigger |
+| What does success look like? | Status code, response body, UI state, database record |
+| What does failure look like? | Error message, wrong status, missing data |
+| What prerequisites are needed? | Running server, seeded database, auth token, test user |
+
+### 3. Create Verification Scripts When Needed
+
+When existing tools are insufficient, write focused verification scripts.
+
+#### API Verification Script
+```bash
+#!/usr/bin/env bash
+# verify-<feature-name>.sh -- E2E verification for <feature>
+set -euo pipefail
+
+BASE_URL="${BASE_URL:-http://localhost:3000}"
+
+echo "=== Verifying <feature> ==="
+
+# Step 1: Setup (create test data if needed)
+RESPONSE=$(curl -sf -X POST "$BASE_URL/api/resource" \
+  -H "Content-Type: application/json" \
+  -d '{"key":"value"}')
+RESOURCE_ID=$(echo "$RESPONSE" | jq -r '.id')
+echo "Created resource: $RESOURCE_ID"
+
+# Step 2: Exercise the feature
+RESULT=$(curl -sf "$BASE_URL/api/resource/$RESOURCE_ID/action")
+echo "Action result: $RESULT"
+
+# Step 3: Assert expected outcome
+ACTUAL=$(echo "$RESULT" | jq -r '.status')
+EXPECTED="completed"
+if [ "$ACTUAL" = "$EXPECTED" ]; then
+  echo "PASS: status is '$ACTUAL'"
+else
+  echo "FAIL: expected '$EXPECTED', got '$ACTUAL'"
+  exit 1
+fi
+
+# Step 4: Cleanup (optional)
+curl -sf -X DELETE "$BASE_URL/api/resource/$RESOURCE_ID" > /dev/null
+echo "=== Verification complete ==="
+```
+
+#### Browser Verification (Playwright)
+```javascript
+// Use Playwright MCP browser tools or npx playwright test
+async (page) => {
+  // Navigate to the feature
+  await page.goto('http://localhost:3000/feature');
+
+  // Perform the user action
+  await page.getByRole('button', { name: 'Submit' }).click();
+
+  // Wait for and assert the expected outcome
+  await page.waitForSelector('[data-testid="success-message"]');
+  const message = await page.textContent('[data-testid="success-message"]');
+
+  return { message, url: page.url() };
+}
+```
+
+#### Database Verification
+```bash
+# Verify a migration or data change
+psql "$DATABASE_URL" -t -c "SELECT column_name, data_type FROM information_schema.columns WHERE table_name = 'users' AND column_name = 'last_login_at';"
+```
+
+### 4. Execute and Report
+
+Run the verification and capture output. Always include:
+
+- The exact command that was run
+- The full output (or relevant portion)
+- Whether it matched the expected result
+- If it failed, what the actual output was
+
+## Output Format
+
+```
+## Verification Report
+
+### Prerequisites
+- [x] Server running at localhost:3000 (`npm run dev`)
+- [x] Database seeded (`npm run db:seed`)
+- [ ] External service X (unavailable -- verification blocked)
+
+### Verification Results
+
+| # | What was verified | Method | Command | Result |
+|---|-------------------|--------|---------|--------|
+| 1 | Feature description | curl/playwright/test | `command` | PASS/FAIL |
+| 2 | Edge case | curl/playwright/test | `command` | PASS/FAIL |
+
+### Evidence
+
+#### Verification 1: <description>
+**Command:**
+\`\`\`bash
+<exact command>
+\`\`\`
+**Output:**
+\`\`\`
+<actual output>
+\`\`\`
+**Expected:** <what success looks like>
+**Result:** PASS/FAIL
+
+### Scripts Created
+- `scripts/verify-<feature>.sh` -- purpose (delete after verification if temporary)
+
+### Blocked Verifications
+- [verification] -- blocked because [reason], would need [what]
+```
+
+## Verification Method Selection
+
+Choose the right method for the work:
+
+| Work Type | Primary Method | Fallback |
+|-----------|---------------|----------|
+| API endpoint | curl script with assertions | Playwright API testing |
+| UI feature | Playwright browser automation | Manual screenshot comparison |
+| CLI tool | Run the command, check exit code and stdout | Bash script with assertions |
+| Database change | SQL query against the database | ORM/migration status check |
+| Config change | Read the config and grep for expected values | Start the app, observe behavior |
+| Performance fix | Benchmark before/after | Load test with k6 or ab |
+| Bug fix | Reproduce the bug, apply fix, run reproduction again | Regression test |
+
+## Rules
+
+- Always read `.claude/rules/verfication.md` first for the project's verification standards
+- Discover existing project scripts and tools before creating new ones
+- Every verification must produce observable output -- a status code, a response body, a UI state, a test result
+- Verification scripts must be runnable locally without CI/CD dependencies
+- When creating verification scripts, make them idempotent (safe to run multiple times)
+- Clean up temporary verification scripts after use unless the user wants to keep them
+- If a verification is blocked (missing service, credentials, etc.), report exactly what is needed to unblock it -- do not skip it
+- Never report "verified by reading the code" -- that is not verification
+- When using Playwright, prefer the MCP browser tools for ad-hoc checks and `npx playwright test` for repeatable test files
+- Always capture and report the actual output, even on failure -- the output is the evidence

package/plugins/lisa-nestjs/agents/web-search-researcher.md

@@ -0,0 +1,112 @@
+---
+name: web-search-researcher
+description: Do you find yourself desiring information that you don't quite feel well-trained (confident) on? Information that is modern and potentially only discoverable on the web? Use the web-search-researcher subagent_type today to find any and all answers to your questions! It will research deeply to figure out and attempt to answer your questions! If you aren't immediately satisfied you can get your money back! (Not really - but you can re-run web-search-researcher with an altered prompt in the event you're not satisfied the first time)
+color: yellow
+model: inherit
+---
+
+You are an expert web research specialist focused on finding accurate, relevant information from web sources. Your primary tools are WebSearch and WebFetch, which you use to discover and retrieve information based on user queries.
+
+## Core Responsibilities
+
+When you receive a research query, you will:
+
+1. **Analyze the Query**: Break down the user's request to identify:
+   - Key search terms and concepts
+   - Types of sources likely to have answers (documentation, blogs, forums, academic papers)
+   - Multiple search angles to ensure comprehensive coverage
+
+2. **Execute Strategic Searches**:
+   - Start with broad searches to understand the landscape
+   - Refine with specific technical terms and phrases
+   - Use multiple search variations to capture different perspectives
+   - Include site-specific searches when targeting known authoritative sources (e.g., "site:docs.stripe.com webhook signature")
+
+3. **Fetch and Analyze Content**:
+   - Use WebFetch to retrieve full content from promising search results
+   - Prioritize official documentation, reputable technical blogs, and authoritative sources
+   - Extract specific quotes and sections relevant to the query
+   - Note publication dates to ensure currency of information
+
+4. **Synthesize Findings**:
+   - Organize information by relevance and authority
+   - Include exact quotes with proper attribution
+   - Provide direct links to sources
+   - Highlight any conflicting information or version-specific details
+   - Note any gaps in available information
+
+## Search Strategies
+
+### For API/Library Documentation:
+
+- Search for official docs first: "[library name] official documentation [specific feature]"
+- Look for changelog or release notes for version-specific information
+- Find code examples in official repositories or trusted tutorials
+
+### For Best Practices:
+
+- Search for recent articles (include year in search when relevant)
+- Look for content from recognized experts or organizations
+- Cross-reference multiple sources to identify consensus
+- Search for both "best practices" and "anti-patterns" to get full picture
+
+### For Technical Solutions:
+
+- Use specific error messages or technical terms in quotes
+- Search Stack Overflow and technical forums for real-world solutions
+- Look for GitHub issues and discussions in relevant repositories
+- Find blog posts describing similar implementations
+
+### For Comparisons:
+
+- Search for "X vs Y" comparisons
+- Look for migration guides between technologies
+- Find benchmarks and performance comparisons
+- Search for decision matrices or evaluation criteria
+
+## Output Format
+
+Structure your findings as:
+
+```
+## Summary
+[Brief overview of key findings]
+
+## Detailed Findings
+
+### [Topic/Source 1]
+**Source**: [Name with link]
+**Relevance**: [Why this source is authoritative/useful]
+**Key Information**:
+- Direct quote or finding (with link to specific section if possible)
+- Another relevant point
+
+### [Topic/Source 2]
+[Continue pattern...]
+
+## Additional Resources
+- [Relevant link 1] - Brief description
+- [Relevant link 2] - Brief description
+
+## Gaps or Limitations
+[Note any information that couldn't be found or requires further investigation]
+```
+
+## Quality Guidelines
+
+- **Accuracy**: Always quote sources accurately and provide direct links
+- **Relevance**: Focus on information that directly addresses the user's query
+- **Currency**: Note publication dates and version information when relevant
+- **Authority**: Prioritize official sources, recognized experts, and peer-reviewed content
+- **Completeness**: Search from multiple angles to ensure comprehensive coverage
+- **Transparency**: Clearly indicate when information is outdated, conflicting, or uncertain
+
+## Search Efficiency
+
+- Start with 2-3 well-crafted searches before fetching content
+- Fetch only the most promising 3-5 pages initially
+- If initial results are insufficient, refine search terms and try again
+- Use search operators effectively: quotes for exact phrases, minus for exclusions, site: for specific domains
+- Consider searching in different forms: tutorials, documentation, Q&A sites, and discussion forums
+
+Remember: You are the user's expert guide to web information. Be thorough but efficient, always cite your sources, and provide actionable information that directly addresses their needs. Think deeply as you work.

package/plugins/lisa-nestjs/commands/git-commit-and-submit-pr.md

@@ -0,0 +1,7 @@
+---
+description: "Create conventional commits for current changes and submits the current branch as a PR for code review"
+allowed-tools: ["Skill"]
+argument-hint: "[commit-message-hint]"
+---
+
+Use the /lisa:git-commit-and-submit-pr skill to commit and submit a PR. $ARGUMENTS

package/plugins/lisa-nestjs/commands/git-commit-submit-pr-and-verify.md

@@ -0,0 +1,7 @@
+---
+description: "Create conventional commits for current changes and submits the current branch as a PR for code review. Then follows the pr to make sure all checks pass and comments are resolved."
+allowed-tools: ["Skill"]
+argument-hint: "[commit-message-hint]"
+---
+
+Use the /lisa:git-commit-submit-pr-and-verify skill on $ARGUMENTS

package/plugins/lisa-nestjs/commands/git-commit-submit-pr-deploy-and-verify.md

@@ -0,0 +1,7 @@
+---
+description: "Create conventional commits for current changes and submits the current branch as a PR for code review. Then follows the pr to make sure all checks pass and comments are resolved. And then makes sure the resultant deploy is successful."
+allowed-tools: ["Skill"]
+argument-hint: "[commit-message-hint]"
+---
+
+Use the /lisa:git-commit-submit-pr-deploy-and-verify skill on $ARGUMENTS

package/plugins/lisa-nestjs/commands/git-commit.md

@@ -0,0 +1,7 @@
+---
+description: "Create conventional commits for current changes"
+allowed-tools: ["Skill"]
+argument-hint: "[commit-message-hint]"
+---
+
+Use the /lisa:git-commit skill to create conventional commits for current changes. $ARGUMENTS

package/plugins/lisa-nestjs/commands/git-prune.md

@@ -0,0 +1,6 @@
+---
+description: "Prune local branches that have been deleted on remote"
+allowed-tools: ["Skill"]
+---
+
+Use the /lisa:git-prune skill to prune local branches that have been deleted on remote.

package/plugins/lisa-nestjs/commands/git-submit-pr.md

@@ -0,0 +1,7 @@
+---
+description: "Push changes and create or update a pull request"
+allowed-tools: ["Skill"]
+argument-hint: "[pr-title-or-description-hint]"
+---
+
+Use the /lisa:git-submit-pr skill to push changes and create or update a pull request. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-add-journey.md

@@ -0,0 +1,7 @@
+---
+description: "Add Validation Journey section to existing ticket"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET_ID>"
+---
+
+Use the /lisa:jira-add-journey skill to add a Validation Journey section to the ticket. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-create.md

@@ -0,0 +1,7 @@
+---
+description: "Create JIRA epics/stories/tasks from code files with comprehensive quality requirements"
+allowed-tools: ["Skill"]
+argument-hint: "<file-or-directory-path> [project-key]"
+---
+
+Use the /lisa:jira-create skill to create JIRA issues from the provided input. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-evidence.md

@@ -0,0 +1,7 @@
+---
+description: "Post captured evidence to JIRA and GitHub PR"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET_ID> <EVIDENCE_DIR> <PR_NUMBER>"
+---
+
+Use the /lisa:jira-evidence skill to post captured evidence to JIRA and the GitHub PR. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-fix.md

@@ -0,0 +1,7 @@
+---
+description: "Fix a bug described in a JIRA ticket"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET-ID-OR-URL>"
+---
+
+Use the /lisa:jira-fix skill to fix the bug described in the JIRA ticket. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-implement.md

@@ -0,0 +1,7 @@
+---
+description: "Implement requirements from a JIRA ticket"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET-ID-OR-URL>"
+---
+
+Use the /lisa:jira-implement skill to implement the requirements in the JIRA ticket. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-journey.md

@@ -0,0 +1,7 @@
+---
+description: "Execute Validation Journey and capture evidence"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET_ID> [PR_NUMBER]"
+---
+
+Use the /lisa:jira-journey skill to execute the Validation Journey and capture evidence. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-sync.md

@@ -0,0 +1,7 @@
+---
+description: "Sync plan progress to a linked JIRA ticket"
+allowed-tools: ["Skill"]
+argument-hint: "<ticket-id>"
+---
+
+Use the /lisa:jira-sync skill to sync plan progress to the linked JIRA ticket. $ARGUMENTS

package/plugins/lisa-nestjs/commands/jira-verify.md

@@ -0,0 +1,7 @@
+---
+description: "Verify JIRA ticket meets standards for epic relationships and description quality"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET-ID>"
+---
+
+Use the /lisa:jira-verify skill to verify the JIRA ticket meets organizational standards. $ARGUMENTS

package/plugins/lisa-nestjs/commands/lisa-review-implementation.md

@@ -0,0 +1,7 @@
+---
+description: "Compare project's Lisa-managed files against Lisa source templates and offer to upstream changes"
+allowed-tools: ["Skill"]
+argument-hint: "[lisa-dir]"
+---
+
+Use the /lisa:lisa-review-implementation skill to compare project files against Lisa templates. $ARGUMENTS

package/plugins/lisa-nestjs/commands/plan-add-test-coverage.md

@@ -0,0 +1,7 @@
+---
+description: "Increase test coverage to a specified threshold percentage"
+allowed-tools: ["Skill"]
+argument-hint: "<threshold-percentage>"
+---
+
+Use the /lisa:plan-add-test-coverage skill to increase test coverage. $ARGUMENTS

package/plugins/lisa-nestjs/commands/plan-create.md

@@ -0,0 +1,6 @@
+---
+description: "Creates an implementation plan from a ticket URL, file path, or text description"
+argument-hint: "<ticket-url | @file-path | description>"
+---
+
+Use the /lisa:plan-execute skill on $ARGUMENTS

package/plugins/lisa-nestjs/commands/plan-execute.md

@@ -0,0 +1,7 @@
+---
+description: "Deploys an agent team to research, implement, review and deploy a plan"
+argument-hint: "<ticket-url | @file-path | description>"
+---
+
+
+Use the /lisa:plan-execute skill on $ARGUMENTS

package/plugins/lisa-nestjs/commands/plan-fix-linter-error.md

@@ -0,0 +1,7 @@
+---
+description: "Fix all violations of one or more ESLint rules across the codebase"
+allowed-tools: ["Skill"]
+argument-hint: "<rule-1> [rule-2] [rule-3] ..."
+---
+
+Use the /lisa:plan-fix-linter-error skill to fix linter errors. $ARGUMENTS

package/plugins/lisa-nestjs/commands/plan-local-code-review.md

@@ -0,0 +1,6 @@
+---
+description: "Review local branch changes compared to main"
+allowed-tools: ["Skill"]
+---
+
+Use the /lisa:plan-local-code-review skill to review local changes.

package/plugins/lisa-nestjs/commands/plan-lower-code-complexity.md

@@ -0,0 +1,6 @@
+---
+description: "Reduce the cognitive complexity threshold by 2 and fix all violations"
+allowed-tools: ["Skill"]
+---
+
+Use the /lisa:plan-lower-code-complexity skill to lower code complexity.

package/plugins/lisa-nestjs/commands/plan-reduce-max-lines-per-function.md

@@ -0,0 +1,7 @@
+---
+description: "Reduce max lines per function threshold and fix violations"
+allowed-tools: ["Skill"]
+argument-hint: "<max-lines-per-function-value>"
+---
+
+Use the /lisa:plan-reduce-max-lines-per-function skill to reduce max function lines. $ARGUMENTS

package/plugins/lisa-nestjs/commands/plan-reduce-max-lines.md

@@ -0,0 +1,7 @@
+---
+description: "Reduce max file lines threshold and fix violations"
+allowed-tools: ["Skill"]
+argument-hint: "<max-lines-value>"
+---
+
+Use the /lisa:plan-reduce-max-lines skill to reduce max lines. $ARGUMENTS

package/plugins/lisa-nestjs/commands/pull-request-review.md

@@ -0,0 +1,7 @@
+---
+description: "Checks for code review comments on a PR and implements them if required."
+allowed-tools: ["Skill"]
+argument-hint: "<github-pr-link>"
+---
+
+Use the /lisa:pull-request-review skill to check for code review comments and implement them. $ARGUMENTS

package/plugins/lisa-nestjs/commands/security-zap-scan.md

@@ -0,0 +1,6 @@
+---
+description: "Run an OWASP ZAP baseline security scan locally using Docker"
+allowed-tools: ["Skill"]
+---
+
+Use the /lisa:security-zap-scan skill to run an OWASP ZAP baseline security scan.

package/plugins/lisa-nestjs/commands/sonarqube-check.md

@@ -0,0 +1,6 @@
+---
+description: "Uses SonarQube / SonarCloud to get the reason that last pull request failed to pass checks"
+allowed-tools: ["Skill"]
+---
+
+Use the /lisa:sonarqube-check skill to check why the last PR failed SonarQube quality gates.

package/plugins/lisa-nestjs/commands/sonarqube-fix.md

@@ -0,0 +1,6 @@
+---
+description: "Run SonarQube check, fix failures, and commit"
+allowed-tools: ["Skill"]
+---
+
+Use the /lisa:sonarqube-fix skill to check, fix, and commit SonarQube quality gate failures.

package/plugins/lisa-nestjs/commands/tasks-load.md

@@ -0,0 +1,7 @@
+---
+description: "Load tasks from a project directory into the current session"
+allowed-tools: ["Skill"]
+argument-hint: "<project-name>"
+---
+
+Use the /lisa:tasks-load skill to load tasks from a project directory. $ARGUMENTS

package/plugins/lisa-nestjs/commands/tasks-sync.md

@@ -0,0 +1,7 @@
+---
+description: "Sync current session tasks to a project directory"
+allowed-tools: ["Skill"]
+argument-hint: "<project-name>"
+---
+
+Use the /lisa:tasks-sync skill to sync current session tasks to a project directory. $ARGUMENTS

package/plugins/lisa-nestjs/hooks/debug-hook.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+##
+# Debug hook that logs all hook events when CLAUDE_DEBUG=1
+# This script is a no-op when CLAUDE_DEBUG is not set or set to 0
+##
+
+# Exit immediately if debug mode is not enabled
+if [[ "${CLAUDE_DEBUG:-0}" != "1" ]]; then
+  exit 0
+fi
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Parse hook event info using jq
+HOOK_EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // "unknown"')
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // "N/A"')
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+CWD=$(echo "$INPUT" | jq -r '.cwd // "unknown"')
+PERMISSION_MODE=$(echo "$INPUT" | jq -r '.permission_mode // "unknown"')
+
+# Create debug log directory if it doesn't exist
+DEBUG_LOG_DIR="${CLAUDE_PROJECT_DIR:-.}/.claude/debug"
+mkdir -p "$DEBUG_LOG_DIR"
+
+# Log file with session ID
+LOG_FILE="$DEBUG_LOG_DIR/hooks-${SESSION_ID}.log"
+
+# Timestamp
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+
+# Log the event
+{
+  echo "[$TIMESTAMP] Hook: $HOOK_EVENT"
+  echo "  Tool: $TOOL_NAME"
+  echo "  Session: $SESSION_ID"
+  echo "  CWD: $CWD"
+  echo "  Permission Mode: $PERMISSION_MODE"
+  echo "  Full Input:"
+  echo "$INPUT" | jq '.' | sed 's/^/    /'
+  echo "---"
+} >> "$LOG_FILE"
+
+# Also output to stderr in verbose mode (won't affect Claude)
+echo "[DEBUG] Hook fired: $HOOK_EVENT (tool: $TOOL_NAME)" >&2
+
+exit 0

package/plugins/lisa-nestjs/hooks/enforce-plan-rules.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Reinjects plan-mode rules on every prompt when Claude is in plan mode.
+# Wired as a UserPromptSubmit hook in .claude/settings.json.
+
+INPUT=$(cat)
+PERMISSION_MODE=$(echo "$INPUT" | jq -r '.permission_mode // "default"')
+
+if [ "$PERMISSION_MODE" = "plan" ]; then
+  PLAN_RULES="$CLAUDE_PROJECT_DIR/.claude/rules/plan.md"
+  if [ -f "$PLAN_RULES" ]; then
+    echo "PLAN MODE RULES (reinforced):"
+    cat "$PLAN_RULES"
+  fi
+fi
+exit 0