Skip to content

docs: add the self-review prompt for running the pipeline on this repo - #222

Merged
TheAmericanMaker merged 1 commit into
mainfrom
docs/self-review-prompt
Sep 12, 2026
Merged

docs: add the self-review prompt for running the pipeline on this repo#222
TheAmericanMaker merged 1 commit into
mainfrom
docs/self-review-prompt

Conversation

@TheAmericanMaker

Copy link
Copy Markdown
Member

A reusable prompt for running CodeCartographer's full deep-audit pipeline on CodeCartographer itself, driven by a host LLM over MCP, at docs/self-review-prompt.md.

It produces an engineering review of the codebase and a first-hand account of driving the product — which is where the framework's own bugs tend to come from (#211, #212 and #216 all began as a model doing exactly this).

The file carries the prompt in a copyable block plus:

  • when to run it — periodically, not per release; it's a spend of several million tokens
  • how — fresh session (an existing session's MCP server may be stale), current codecarto-mcp, resumable across sessions via status.yaml
  • what it doesn't cover.codecarto/ is both the template and the run's workspace, so prompt content is out of scope
  • why each choice — all seven phases because porting's Defect Synthesis is the reconciled deliverable and defect-scan-semantic needs contracts/protocols; no Broad-Side; PASS WITH GAPS allowed so a host LLM neither stalls nor silently downgrades its own validation
  • a note to keep it current with the pipeline YAML, since a stale prompt fails the way fix: frame the guide for the Pi surface instead of injecting it bare #212's stale guide did

CONTRIBUTING gets a short "Self-review" subsection pointing at it, positioned as distinct from release surface verification.

Docs only; 696/696 tests pass.

🤖 Generated with Claude Code

A reusable prompt for driving the full deep-audit pipeline on CodeCartographer
itself over MCP, plus the reasoning behind each choice (all seven phases, no
Broad-Side, PASS WITH GAPS allowed, report from the Defect Synthesis) and the
cost to expect. CONTRIBUTING points at it as a periodic self-review distinct
from per-release surface verification.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@TheAmericanMaker
TheAmericanMaker merged commit f6f8484 into main Sep 12, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant