cursorqb-autopsy

name	cursorqb-autopsy
description	Use for CursorQB Step 1.5 when an existing project needs a read-only autopsy and optional Project-Ontology.md before Step 2.
disable-model-invocation	true

CursorQB Autopsy

Inspect an existing or partially built repository and write Planner-docs/Autopsy.md. When enough evidence exists, also create/update Planner-docs/Project-Ontology.md and Planner-docs/Project-Comprehension.md.

Sources

• Primary: Planner-docs/Main-Planing.md
• Optional continuity: Planner-docs/Planing-Ledger.md
• Repo evidence: README, manifests, source/service/package dirs, tests, docs, configs, CI
• Full Step 1.5 spec: autopsy-planner.md
• Validator entrypoint: scripts/cursorqb_launcher.py --controller planner-validator

Language Contract

CursorQB asks intake questions in the user's language when practical. Generated Planner-docs artifacts are English by default unless the user explicitly requests another body language. Required document headings remain English for validator stability.

Plan-Run Contract

Use Cursor Plan Mode and bind this run through the bundled deterministic Plan-Run controller:

• Outcome: produce Planner-docs/Autopsy.md; optionally produce Planner-docs/Project-Ontology.md and Planner-docs/Project-Comprehension.md.
• Files allowed to modify: Planner-docs/Autopsy.md, Planner-docs/Project-Ontology.md, and Planner-docs/Project-Comprehension.md.
• Files forbidden to modify: source, config, tests, scripts, Planner-docs/Main-Planing.md, Step 2 files, and Step 3 files.
• Validation checkpoints: run python3 -I -S -B <plugin-root>/scripts/cursorqb_launcher.py --controller planner-validator -- --root . --mode autopsy --strict.
• Stop gates: missing main plan, empty/new repo skip, repository read errors, unrelated dirty worktree, or secret exposure risk.
• Subagent policy: use read-only subagents only for large repo exploration, ontology mapping, readiness review, or security review; parent CursorQB writes official artifacts.

Required Behavior

1. Read autopsy-planner.md fully.
2. Read Main-Planing.md.
3. Inspect the repo with safe read-only commands.
4. Skip for empty or nearly empty repos.
5. Write Autopsy.md with required headings.
6. Write Project-Ontology.md and Project-Comprehension.md only when enough evidence exists.
7. Redact secret-like values and report only paths/line numbers/pattern names.

Completion Report

Report whether Step 1.5 succeeded, skipped, or blocked; whether Autopsy/Ontology changed; top findings; validator result; and how Step 2 should use the evidence.