Diagnosis And Adoption
- Inspect repository instructions and classify the target before proposing writes.
- Run
amber audit --target <repo>first. Separate observed facts, unknowns, conflicts, and suggested additions. - Run
amber governance reportandamber doctorwhen Amber state exists. Errors outrank warnings; corrupt state fails closed. - For a new installation, preview with
amber init --dry-run. Applyinitonly with approval; it skips existing files and must not merge or overwrite user-authored documents. - Create or validate the wiki only after scaffold ownership is clear. Treat generated pages and user pages differently.
- Re-run audit, doctor, manifest validation, and wiki validation. Hand remediation work to
amber-deliverywhen it becomes a code change.
Evidence order: target classification, read-only audit, readiness findings, proposed file set, approval, created/skipped files, post-change doctor and validation.
On failure, leave existing files untouched, report the exact conflict and recovery command, and retain any dry-run report. Deprecated adoption commands remain available through amber --all, but prefer audit/governance for new work.
Preserve the same approval, isolation, and ledger boundaries when diagnosis becomes a delivery change. This journey never treats a diagnostic result as write authority.