Where each fact belongs
Use this map to update one source and its generated views instead of making disconnected copies.
| Subject | Authoritative source in this repository | Live authority or dependency |
|---|---|---|
| Entity IDs, host/service/resource metadata | inventory/ | Narrow read-only discovery with dated evidence |
| Architecture edges and views | architecture/*.c4 | Verified workflows; not automatically discovered topology |
| Naming and entity meanings | standards/vocabulary.json | Contribution decision record for changes |
| Daily procedures | src/content/docs/workflows/ | Active script behavior and application lifecycle |
| Recovery | src/content/docs/runbooks/ | Targeted diagnostics and verified repair evidence |
| Shipyard runtime sources | tooling/shipyard/ plus manifest | ~/dev-environment active installation |
| Orca hooks | profiles/shipyard/orca.json | Orca supported CLI/UI; IDs are installation-specific |
| Credentials | Paths and owners only | Native private credential stores; never Git |
| IAM and Kubernetes grants | Access explanation and ownership references | Existing application Terraform/RBAC owner |
| Application worktree implementation | Links and compatibility requirements | API upstream scripts; appliance draft branch |
| Historical test results | evidence/ sanitized summaries | Original private setup outputs; not copied wholesale |
| Website build and publication | .github/workflows/validate.yml and publishing guide | Cloudflare deployment records; GitHub Actions secret/variables |
| Dynamic ports, health and ownership | Not checked in | Status commands and read-only doctor |
| Home test bed runs, changelog of machine edits, agent and camera tables | Host pages, workflows and the runbook here | claude-notes/2026-10-05-test-bed/ in the appliance repository checkout (HANDOFF.md, README.md, changelog.md, scripts, measurements/); untracked, on the Mac |
The original append-only CHECKPOINTS and TXT runbooks contain superseded statements. They were reconciled into current pages; they are not imported as competing operational instructions. Withdrawn IAM proposal/provisioner files, customer screenshots, dumps, raw logs and temporary validation programs are excluded.
Old worktree-linux.py and fixed-port search-engine.sh belong to earlier setup stages. Active Orca workflows supersede them. The root bootstrap/verify scaffolding was not deployed and did not establish full reconstruction or matching tools and access; it is intentionally not presented as a working universal installer.
Generated copies
Section titled “Generated copies”Marked inventory-table blocks in host pages come from inventory JSON. Run npm run generate after changing those facts; the check command rejects stale tables. Explanations and repair instructions stay in Markdown.
Architecture node links come from each inventory record’s page. The build produces the explorer and per-view text/JSON exports from the same LikeC4 model. Generated files under public/architecture are ignored; never edit them directly. The architecture guide links all formats.