From 7a95cd8a5790178736c55326ac9fe62d34062f59 Mon Sep 17 00:00:00 2001 From: rafia-10 Date: Sat, 21 Feb 2026 11:40:55 +0300 Subject: [PATCH] feat(orchestration): add CLAUDE.md shared brain for parallel agent coordination --- .orchestration/CLAUDE.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 .orchestration/CLAUDE.md diff --git a/.orchestration/CLAUDE.md b/.orchestration/CLAUDE.md new file mode 100644 index 0000000000..4cabb57423 --- /dev/null +++ b/.orchestration/CLAUDE.md @@ -0,0 +1,20 @@ +# CLAUDE.md + +# Shared Brain for Roo Code Agent Sessions + +## Project: AI-Native IDE – Week 1 + +### Lessons Learned + +- PreHook enforces scope and intent validation. +- PostHook logs AST diffs, content hashes, and mutation class. +- Session IDs and contributor model must be tied dynamically to each agent instance. +- Active intents are required for agent execution; context injection is mandatory. +- Parallel agents must respect content hashes to prevent stale file overwrites. + +### Architectural Notes + +- Hooks isolated and composable. +- agent_trace.jsonl stores intent → file → hash → mutation_class. +- Future: integrate real Git SHA for vcs.revision_id. +- Future: append lessons automatically when linter/test fails.