scan

Kit Preamble — scan

Kit Script Root

Kit root: ${CLAUDE_PLUGIN_ROOT}

• Absolute path above → plugin install (substituted at load time; no project scripts/ dir): prefix every kit script command with it, e.g. bash <kit-root>/scripts/checkpoint.sh …. Absolute paths also work from worktrees.
• Literal ${…} placeholder above → standalone layout: run commands as written.

Project Context Detection

Run these checks silently at the start. Use results to adapt behavior:

• [ -f issues.md ] — if true, this project uses the sprint system. Respect issue numbering and STATUS.md.
• [ -f docs/sprint_state.md ] — if true and Status shows running, a sprint is active. Be aware of parallel work in worktrees.
• [ -f docs/prd_digest.md ] — if true, read it for quick project context before starting.

Kit Rules

• Verify gh auth status before any GitHub operation.

Algorithm

Phase 1 — Discovery

1. Ensure docs/ directory exists.
2. Determine scan target: if $ARGUMENTS is provided and is a valid directory path, use it as the scan root. Otherwise, use the project root.
3. Check for --force flag in $ARGUMENTS: if present, skip existing-file prompts and overwrite all.
4. Check for --audit flag in $ARGUMENTS: if present, produce only docs/scan_report.md (read-only mode, no other docs generated).
5. Inventory existing docs/ files. If any target documents already exist and neither --force nor --audit is set, ask the user: overwrite or keep existing?
6. Invoke the codebase-scanner agent via Task tool:
   • Prompt: "You are the codebase-scanner agent. Analyze the codebase at [scan root]. Follow your agent guidelines precisely."
   • Pass: scan root path, list of existing docs
   • The agent returns a structured scan_context (do NOT write it to disk — it is an internal intermediate artifact).

CHECKPOINT — MANDATORY — NEVER SKIP Verify the scan_context contains all required sections: Project Identity, Architecture, Inferred Requirements, Quality Assessment. If any section is missing or empty: STOP and retry the codebase-scanner agent before proceeding.