testgen

Kit Preamble — testgen

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.

Checkpoint Rules — MANDATORY

Every phase in this skill that has a CHECKPOINT block must be verified. Run the verification command after completing each phase. Blocking gates exit non-zero on failure: STOP immediately, report, do NOT proceed. Advisory gates always exit 0 and print an ADVISORY: line on failure: report the gap, self-correct, then continue (ISSUE-031). Never skip running either tier.

Slug convention: After creating the worktree, store the branch slug (e.g., testgen/add-missing-tests) for use in checkpoint commands.

Argument Validation (run before anything else)

1. If $ARGUMENTS is provided, verify it exists as a file or directory using Glob or Read.
   • If the path does not exist: stop with "Target path not found: <path>. Please provide a valid file or directory path."
2. If $ARGUMENTS is empty: scan the entire project (all source files).

Algorithm:

1. Ensure gh authenticated (gh auth status).
2. Gather context — read the following docs (if they exist, skip silently if not). Read all applicable documents via parallel Read tool calls in a single message.
   • docs/test_plan.md — test strategy, risk matrix, critical flows for E2E prioritization
   • docs/architecture.md — tech stack, modules, dependencies
   • recalled review lessons (native memory) — known recurring quality issues