| 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
- Read
autopsy-planner.md fully.
- Read
Main-Planing.md.
- Inspect the repo with safe read-only commands.
- Skip for empty or nearly empty repos.
- Write
Autopsy.md with required headings.
- Write
Project-Ontology.md and Project-Comprehension.md only when enough evidence exists.
- 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.
