Historical archive¶
These field notes, architecture decisions, and design specs explain how MAC reached its current contracts. They are evidence, not current instructions, and must not be read as current product behaviour. Follow the numbered book and current runbooks for operational work. Old field-note URLs redirect here to their retained sources.
Archived records¶
- ADR 0001 — Unify the Hermes runtime into the
macmonorepo —adr/0001-unify-hermes-runtime-into-mac.md - ADR 0002 — Memory store / vector tier at fleet scale (50–200 agents per hub) —
adr/0002-memory-store-at-scale.md - ADR 0003 — Optional in-mac model router + vault (revisiting TokenHub's boundary) —
adr/0003-tokenhub-core-into-mac.md - ADR 0004 — One task database: revert the Hermes kanban adoption, keep our own board —
adr/0004-task-ledger-vs-hermes-kanban.md - ADR 0005 — Elastic executor tier vs. the static fleet (and "every agent is a GitHub runner") —
adr/0005-elastic-executor-tier-vs-static-fleet.md - ADR 0006 — Agent Client Protocol (ACP) support —
adr/0006-acp-support.md - ADR 0007 — Per-module ownership: mood_policy, nap_consolidator, soul_snapshot, memory_vetting —
adr/0007-hermes-boundary-mood-nap-soul-memory.md - ADR 0008 - OpenShell uses Docker Engine/Moby as its only container runtime —
adr/0008-openshell-docker-engine-runtime.md - ADR 0009 - Minimal sandbox base + on-demand, layered, cached provisioning —
adr/0009-minimal-base-on-demand-layered-provisioning.md - ADR 0010 — Fleet IDE Cut-over and Parity Matrix —
adr/0010-fleet-ide-cutover-parity-matrix.md - ADR 0011 - Hub review verification uses affected tests —
adr/0011-hub-review-verification-scope.md - ADR 0012 - Native node steward with containerized task execution —
adr/0012-hybrid-native-steward-containerized-execution.md - ADR 0013 - One authoritative hub allocator —
adr/0013-authoritative-hub-allocator.md - ADR 0014: Agent visibility is a communication boundary, not a dispatch gate —
adr/0014-visibility-is-not-a-dispatch-gate.md - ADR 0015: macOS nodes are host installs, not containers —
adr/0015-macos-nodes-are-host-installs.md - ADR 0016 - Agents decide what a task needs; review is agent-initiated —
adr/0016-agent-initiated-review.md - ADR 0017 - Token spend is metered at the router, not reported by the client —
adr/0017-token-spend-is-metered-at-the-router.md - ADR 0018 - The task view is a graph under progressive disclosure, not a board —
adr/0018-task-graph-progressive-disclosure.md - ADR 0019 - Privilege is an ACL on a resource tree, not a bag of scopes —
adr/0019-privilege-is-an-acl-on-a-resource-tree.md - ADR 0020 - A running task is not editable; stop it first —
adr/0020-a-running-task-is-not-editable.md - ADR 0021 - Schema changes need versioned migrations, not an append-only helper list —
adr/0021-schema-changes-need-versioned-migrations.md - ADR 0022 - A gate returns a named decision, not a boolean —
adr/0022-a-gate-returns-a-named-decision-not-a-boolean.md - ADR 0023 - One skill source, thin plugins per coding harness —
adr/0023-one-skill-source-many-harness-plugins.md - ADR 0024 - The dashboard streams the bus, not just its counts —
adr/0024-the-dashboard-streams-the-bus-not-just-its-counts.md - ADR 0025 - The hub UI is the observability console;
ide/is an unshipped prototype —adr/0025-the-hub-ui-is-the-observability-console.md - ADR 0026: Every operation on a first-class object emits a bus event —
adr/0026-first-class-operations-emit-bus-events.md - ADR 0027: Upgrades are versioned, ordered, and fail closed —
adr/0027-upgrades-are-versioned-and-fail-closed.md - ADR 0028: Installation is a verified package plus enrollment, not a push —
adr/0028-installation-is-a-package-not-a-push.md - ADR 0029: The coding-route search path is a fleet contract, not per-worker environment —
adr/0029-the-route-search-path-is-a-fleet-contract.md - ADR 0030: LangChain extracts meaning on the agent; hub Qdrant only stores the extract —
adr/0030-langchain-extracts-before-qdrant.md - ADR 0032: CLI sessions use each harness's hooks, not tmux, for recording and AgentBus injection —
adr/0032-cli-session-hooks-not-tmux.md - ADR 0033: Agents continue locally under independent hub supervision —
adr/0033-local-continuation-hub-supervision.md - ADR 0034 - Project Mission Control is an additional observe view, not the IDE —
adr/0034-project-mission-control.md - ADR 0035: The all-fleet deployment transaction is replaced, not extended —
adr/0035-replace-the-all-fleet-deployment-transaction.md - Autonomous Project Routing and Review/Fix Loop Implementation Plan —
superpowers/plans/2026-05-31-autonomous-project-routing-review-fix-loop.md - Autonomous Project Routing and Review/Fix Loop Design —
superpowers/specs/2026-05-31-autonomous-review-fix-loop-design.md - Can MAC do work? — fleet assessment, 2026-08-02 —
archive/field-notes/assessment-2026-08-02.md - Assessment: task_1b67831356c347c3a91d782982f47d1c —
archive/field-notes/assessment-task-1b6783.md - Assessment: task_21e77194d5fe4fd3963b8b1a61ece9d8 —
archive/field-notes/assessment-task-21e771-worker3-tailscale-blocker.md - Assessment: task_7023d6a7ef6e4bbf8f6c2da523a4320f —
archive/field-notes/assessment-task-7023d6.md - Assessment: task_83f38e9754f64908a316cccba0952329 —
archive/field-notes/assessment-task-83f38e.md - Assessment: task_8bf37845abf445149d99fb4a1e3a41d5 —
archive/field-notes/assessment-task-8bf378.md - Resolution: task_97627e43b1034100831e726f8981e5e2 —
archive/field-notes/assessment-task-97627e.md - Assessment: task_a608f4405b0446a3b28ed7a8beb4fd65 —
archive/field-notes/assessment-task-a608f4.md - Assessment: task_b07fbff6994e41a39ce24157f1832ad5 —
archive/field-notes/assessment-task-b07fbf.md - Assessment: task_de35029099d34c94be186c8992ee706a —
archive/field-notes/assessment-task-de3502.md - Assessment: task_f6a813fede7841d28b154af3a544864a —
archive/field-notes/assessment-task-f6a813.md - Assessment: task_f9cd72342aef4e7b8701b131b12d29ff —
archive/field-notes/assessment-task-f9cd72.md - v1.3.1 fleet canary —
archive/field-notes/canary-v1.3.1.md - Close-Out: dream finding
dreamrepair:5404b15fffa355d739c21e138c5cc122(skill subsystem) —archive/field-notes/closeout-dreamrepair-5404b15-skill.md - Close-Out: dream-finding review finalize/verify prerequisite —
archive/field-notes/closeout-review-finalize-verify-prerequisite.md - Close-Out: low-confidence dream finding
skill(parenttask_9c83aa5b) — CLOSE, NOT ACTIONABLE —archive/field-notes/closeout-task-9c83aa5b-skill.md - Contract-verify environment failure investigation finding —
archive/field-notes/contract-verify-environment-failure-finding.md - Crash incident investigation finding —
archive/field-notes/crash-incident-finding.md - Disposition: dream finding
dreamrepair:c8dd80378a16692ba4e0cd5ef57f2bf1(skill subsystem) —archive/field-notes/disposition-dreamrepair-c8dd8037-skill.md - Disposition: low-confidence dream finding
skill(dreamrepair:ecd3548120e07c38d04e46f0c62e16dd) — CLOSE, NOT ACTIONABLE —archive/field-notes/disposition-dreamrepair-ecd3548-skill.md - Disposition: HGX session
c0b2f9fd4e0b— workspace/PVC inventory, preservation, and convert-in-place feasibility —archive/field-notes/disposition-hgx-session-c0b2f9fd4e0b.md - Disposition: HGX session
c902fab4d55f— workspace/PVC inventory, preservation, and convert-in-place feasibility —archive/field-notes/disposition-hgx-session-c902fab4d55f.md - Disposition: low-confidence dream finding
slack(dreamrepair:394db89d377ef58abf97ace7d54d728c) — not actionable —archive/field-notes/disposition-task-394db89d-slack.md - Disposition: skill environment-prerequisite finding — smallest repair applied —
archive/field-notes/disposition-task-46eb6c-skill-env-prereqs.md - Disposition: low-confidence dream finding
skill(parenttask_9c83aa5b) — not actionable —archive/field-notes/disposition-task-9c83aa5b-skill.md - Disposition: low-confidence dream finding
skill(dreamrepair:828e1ef4a530935a9a7db4b1807202e1) — not actionable —archive/field-notes/disposition-task-c3a30819-skill.md - Dream-Finding Assessment: dreamrepair:6d1b5bbe0a13515fef0bd061ef001119 —
archive/field-notes/dream-finding-6d1b5b.md - Dream-repair review finding: stalled-finalizer recovery —
archive/field-notes/dream-stalled-finalizer-recovery-finding.md - Triage: Dream Finding
dreamrepair:828e1ef4a530935a9a7db4b1807202e1—archive/field-notes/dream-triage-828e1ef4.md - Findings: startup self-test attestation-gap crash (crash_1fc349e109ed4ff9885acf1c8ba99948) —
archive/field-notes/findings-crash-1fc349e1-startup-selftest-attestation-gap.md - Findings: startup self-test transient-timeout crash (crash_591645a352fc4d54bf5e3f99384da7dc) —
archive/field-notes/findings-crash-591645a3-startup-selftest-timeout.md - Findings: mac-agent-service startup self-test crash (62021be0) —
archive/field-notes/findings-crash-mac-agent-service-62021be0.md - Findings: crash_service "unknown" crash path (ground truth for parent P0 crash-repair) —
archive/field-notes/findings-crash-service-unknown-crash-path.md - Fleet Workbench — Clean-Slate IDE Plan —
archive/field-notes/fleet-ide-workbench-plan.md - Forensics: Diagnose 90s Dispatch Delay for CLI-Created Probe Task —
archive/field-notes/forensics-task-643b33ee1c7b4a4ab7a81bf8d5af34a4.md - Root-Cause Report: Silent Executor Insta-Block for task_a32a35e90ab0434e8c7766057b268bc6 —
archive/field-notes/forensics-task-a32a35e90ab0434e8c7766057b268bc6.md - A Notional Haskell Migration Plan for MAC —
archive/field-notes/haskell_migration.md - Contract gate environment repair resolution —
archive/field-notes/investigation-contract-gate-env-8454149d-resolution.md - Investigation: dream finding with a generic
skillaffected label — placeholder area bucket, not a defect location —archive/field-notes/investigation-dream-skill-generic-area-bucket.md - Investigation: dream
tool_or_skill_name(skill) finding — actionability & root signal —archive/field-notes/investigation-dream-skill-tool_or_skill_name-actionability.md - Investigation: dream finding
dreamrepair:173ce952with a generictestsaffected label — placeholder area bucket, not a defect location —archive/field-notes/investigation-dream-tests-generic-area-bucket.md - Ground Truth: dream finding
dreamrepair:394db89d377ef58abf97ace7d54d728c(slack failure_pattern) —archive/field-notes/investigation-dreamrepair-394db89d-slack.md - Investigation: dream finding
dreamrepair:5404b15fffa355d739c21e138c5cc122(skill subsystem) —archive/field-notes/investigation-dreamrepair-5404b15-skill.md - Ground Truth: dream finding
dreamrepair:71b00e8122761c2caeacd04c7ed3f49c(slack display-label trace) —archive/field-notes/investigation-dreamrepair-71b00e8-slack.md - Investigation: dream finding
dreamrepair:c8dd80378a16692ba4e0cd5ef57f2bf1(skill subsystem) —archive/field-notes/investigation-dreamrepair-c8dd8037-skill.md - Investigation: dream finding
dreamrepair:d94ad78027c32d4825923f0ba91e9497(skill) —archive/field-notes/investigation-dreamrepair-d94ad78-skill.md - Ground Truth: dream finding
dreamrepair:da0ac0f3cab187290c91e5b26a6c5b9f(slack failure_pattern) —archive/field-notes/investigation-dreamrepair-da0ac0f3-slack.md - Investigation: dream finding
dreamrepair:ffbc63f8695e9316b064bb1f6d3566cb(skill) —archive/field-notes/investigation-dreamrepair-ffbc63f8-skill.md - Investigation:
predispatch_conflict.pyfailure-pattern (dream finding) —archive/field-notes/investigation-predispatch-conflict-5a43ad.md - Investigation: dream-finding review finalize/verify prerequisite ground truth —
archive/field-notes/investigation-review-finalize-verify-prerequisite.md - Investigation: mac environment-prerequisite finding is a classifier false positive —
archive/field-notes/investigation-task-2284f3-env-prerequisite-false-positive.md - Investigation: skills environment-prerequisite behavior vs. the finding —
archive/field-notes/investigation-task-b6ddd8-skill-env-prereqs.md - Investigation: new-file staging finalizer ground truth (task_ed7b0b) —
archive/field-notes/investigation-task-ed7b0b-new-file-staging-finalizer.md - Investigation: new-file staging finalizer ground truth (task_f869c0) —
archive/field-notes/investigation-task-f869c0-new-file-staging-finalizer.md - Review: docs/job-per-task-roles-spec.md —
archive/field-notes/job-per-task-roles-spec-review.md - Job-per-task Role Specialisation — Design Spec —
archive/field-notes/job-per-task-roles-spec.md - Kubernetes-native rewrite plan —
archive/field-notes/k8s-native-rewrite-plan.md - Linear Bridge Spec — Review Notes —
archive/field-notes/linear-bridge-spec-review.md - Linear Bridge — Design Spec —
archive/field-notes/linear-bridge-spec.md mac task↔bd(beads) functional-parity audit —archive/field-notes/mac-task-bd-parity-audit.md- Metadata sync assessment (post-bd-bridge) —
archive/field-notes/metadata-sync-assessment.md - Preflight: HGX auth path, fleet baseline, and standard-dind fungible reference —
archive/field-notes/prereq-task-029665.md - Prerequisite Investigation: task_e94f546cf9dc41409d4a9fe6b8b39dcd —
archive/field-notes/prereq-task-e94f546c.md - Prerequisite Investigation: task_fd2f34b64823410c84a14fc0345610ff —
archive/field-notes/prereq-task-fd2f34.md - Provenance: low-confidence dream finding
slack(dreamrepair:77fc3e59014ba0d7950d22387f0204a0) — self-referential evidence chain, no concrete defect —archive/field-notes/provenance-dreamrepair-77fc3e59-slack.md - Quickstart Gap Analysis —
archive/field-notes/quickstart-gap-analysis.md - Field note: HGX session
c902fab4d55f— realize capacity via preserve-nothing + REPLACE —archive/field-notes/replace-hgx-session-c902fab4d55f.md - Scaling Plan —
archive/field-notes/scaling-plan.md