Runtime Layout, Bootstrap Automation & Deterministic Drift

Agents Remember 0.9.0

This release reorganizes Agents Remember into a coordinator-native runtime package, expands external-memory onboarding/bootstrap support, and makes onboarding drift detection more deterministic.

Highlights

• Reworked the installable runtime layout under runtime/, including packaged skills, runtime AGENTS.md templates, runtime scripts, and system default examples.
• Added installer/install-runtime.py and moved install-skills.sh into runtime/scripts/ so runtime installation no longer depends on the old root-level source layout.
• Renamed and clarified the alpha memory model around external-memory, replacing older shared-memory wording in the active implementation and docs.
• Added a full C-03 repo bootstrap skill with templates for repo overviews, route-local overviews, evidence packs, onboarding waves, curator review, and bootstrap handoff.
• Added deterministic onboarding drift checks for repo overviews, route-local overviews, and repo entity catalogs.
• Added deterministic git-blob-set-v1 entity fingerprints, including checks for missing entity fingerprint rows, orphaned fingerprint rows, missing evidence paths, and stale fingerprint data.
• Fixed C-08 task-root resolution so task folders resolve under the repo-specific task namespace.
• Expanded public documentation into a structured docs set with getting started, concepts, architecture, workflows, install guides, and reference pages.

Runtime And Installation

• Runtime-owned files now live under runtime/:
  • runtime/skills/
  • runtime/agents-md-files/
  • runtime/scripts/
  • runtime/system/defaults/
• Root-level historical skills/ and system/ source files were removed or migrated into the runtime package.
• Runtime AGENTS.md templates are now packaged separately from repo-root instructions.
• System defaults are split by coordinator and memory-repo examples.

Onboarding And Memory

• Added C-00-initialize-memory-repo for memory-root initialization and repair.
• Hardened bootstrap defaults, including common exclusions such as dependency folders, build output, generated files, env files, and Zone.Identifier artifacts.
• C-05 now owns entity catalog maintenance and routes package/module/source-slice create, refresh, move, or delete cases to C-03 when structural onboarding work is needed.
• C-10 adoption and C-11 memory carryover flows were kept aligned with external-memory ledger behavior.

Drift Detection

• C-02 now checks:
  • file-level onboarding metadata
  • inline onboarding digests
  • repo and route-local overview sourceRoute drift
  • repo entity catalog fingerprints
• Entity catalog drift now verifies that every ## Entity Inventory entry has a matching fingerprint row.
• Missing evidence paths and orphaned fingerprint rows now explicitly route agents to check whether an entity was removed, renamed, or moved before deleting catalog content.

Documentation

• README and FAQ were rewritten for a more public-facing project shape.
• Added docs for:
  • getting started
  • concepts
  • architecture
  • workflows
  • external memory
  • onboarding existing repos
  • refreshing stale onboarding
  • adopting existing memory
  • harness-specific installation
  • C-02, C-08, C-09, path rules, settings, runtime layout, and skills reference

Validation

• Worktree/support test suite passes with 49 tests.
• C-02 drift detection passes cleanly against the current agents-remember-md memory after closeout.