Guides
Step-by-step instructions for doing something. These documents answer “how do I do X?”
If you need conceptual background, see concepts/. If you need a normative spec, see contracts/.
Reading order for new adopters
- getting-started.md — first operational slice
- core-operating-path.md — minimum loop
- apply-to-existing-project.md — adoption without rebuild
- slice-finalization-and-restart.md — clean close and resume
- user-facing-closeout.md — clear completion, continuity and archive feedback
Contents
| Document | What it guides |
|---|---|
| getting-started.md | Low-risk first Work Slice with confirmed explanation depth, validation, troubleshooting and escalation |
| core-operating-path.md | Minimum operational loop |
| apply-to-existing-project.md | Adopting AletheIA on an existing project |
| slice-finalization-and-restart.md | Closing a slice and resuming cleanly |
| user-facing-closeout.md | Explaining completion, next action, continuity and archive readiness in plain language |
| agent-role-adoption-guide.md | How to adopt the portable role system |
| agent-runtime-decision-guide.md | Choosing between agents or runtimes |
| adoption-mode-guidance.md | Lite vs Standard vs Fuller adoption modes |
| project-handoff-conventions.md | How a project customizes handoff conventions |
| constrained-adoption-pilot.md | Running a bounded pilot in a regulated environment |
| resource-aware-bounded-pilot.md | Running a resource-aware bounded pilot |
| pilot-conversion.md | How pilot learnings become framework improvements |
| github-project-operations.md | Using GitHub Projects for repo coordination |
| setting-up-harnesses.md | Wiring a consumer project to Claude Code via the shim pack |
| install-via-apm.md | Installing AletheIA through APM and materializing the overlay scaffold |
| pilot-crisis-monitor-overlay-handoff.md | Brief for the Crisis Monitor team — Epic 7 overlay-adoption pilot |
| validating-knowledge-manifests.md | How to load and schema-validate knowledge manifests via the engine loaders |
| github-pr-visual-operations-projector.md | Projecting supplied GitHub PR evidence into Visual Operations snapshots |
| visual-operations-usage-evidence.md | Recording real snapshot use without backfilling or expanding scope |
| visual-operations-aletheia-dogfood-protocol.md | Measuring Visual Operations snapshot utility in AletheIA maintenance |
| visual-operations-cockpit-visual-model.md | Translating Visual Operations contracts and dogfood evidence into minimum cockpit card, lane, and alert semantics |