aletheia-bootstrap

Aletheia Bootstrap

Use the plugin scaffold to initialize .aletheia/ as the target repository's project truth layer.

Primitive Capabilities

Use these primitives. Do not add orchestration to runtime scripts for bootstrap judgment:

• scripts/init_aletheia.py to copy the scaffold into the target repository.
• model_gate.py --record to record bootstrap attribution.
• source_inventory.py to classify existing source material.
• guided_bootstrap.py --inspect --json to inspect bootstrap report readiness without writing files.
• guided_bootstrap.py to prepare the first truth inventory report.
• bootstrap_finalize.py --inspect --json to inspect finalize readiness before hooks, session notes, bootstrap removal, or checkpointing.
• truth_record.py create/update or direct truth-file edits to write confirmed project truth.
• orient.py, status.py --json, validate.py, checkpoint.py --dry-run, and checkpoint.py to verify and checkpoint the initialized truth layer.

Prompt Recipe

The skill is a prompt recipe for first-run truth synthesis, not a single bootstrap tool.

Rules:

• Do not invent a project mission for an empty repository.
• Do not overwrite existing project files unless the user explicitly requests replacement.
• Keep project truth in .aletheia/.
• Ensure mandatory Claude Code hooks are present in .claude/settings.json and point to .aletheia/bin/.
• Keep source code, tests, public docs, build files, and CI files in their conventional locations.
• After initialization, orient from .aletheia/START_HERE.md before local implementation.