recipe-maintainers/project-orchestrator
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
170a3e35cd85ad3a23cdcedf236057418723eded
project-orchestrator/AGENTS.md
mfowler 170a3e35cd chore(po): track memory in-repo + add AGENTS.md conventions 
- memory/ now lives in the repo and is git-tracked; the harness memory path
  (~/.claude/.../memory) is a symlink to it so writes still land here
- AGENTS.md: document memory-in-repo, always-commit-and-push, operator-driven
  (no sweep), and the one-directional rule

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 15:08:08 +00:00

1.6 KiB
Raw Blame History

AGENTS.md — conventions for agents working in this repo

This is the project-orchestrator (PO) repo. See README.md for what the PO is and prompts/orchestrator.md for the agent's role.

Memory

  • The PO's memory lives in this repo under memory/, and is tracked via git — not left under ~/.claude. Memory is versioned and reviewable alongside the code.
  • The harness's expected memory path (~/.claude/projects/-home-loops-project-orchestrator/memory) is a symlink to memory/ here, so the normal "write to the harness memory path" flow still lands files in the repo.
  • memory/MEMORY.md is the index (one line per memory); each fact is its own file with frontmatter.

Git

  • Always commit and push every change to this repo (git add -A && git commit && git push origin main) — including memory updates. Don't wait to be asked.
  • Git identity is set locally on this repo (mfowler.email@protonmail.com / mfowler); it was not configured globally in this environment.
  • Push credentials for git.autonomic.zone come from the active cc-ci project (/srv/cc-ci/.testenv, per fleet.toml).

Operating model

  • The PO is operator-driven: it acts on request (create / start / stop / update / list / status a project). There is no periodic fleet sweep — this repo manages projects, it does not watch them live. The agent uses watch = "heal" (recover-if-dead) with no wake.
  • Knowledge is one-directional (PO → projects). Never write PO/fleet metadata into a project repo. The fleet's only record is this repo's fleet.toml.