agent-compose: source discovery via AGENTS.COMPOSE.md #136

New issue

Closed

opened 2026-06-03 22:18:34 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-06-03 22:18:34 +00:00

Owner

🤖 Filed by Claude Code on Kai's behalf.

Parent

#134

What to build

Replace the explicit source-file list with discovery. Config declares source roots (locally checked-out org repos); the composer walks each root for AGENTS.COMPOSE.md files and feeds them to the existing concatenation step. This establishes the disjoint-file convention: AGENTS.COMPOSE.md holds always-global doctrine and is never auto-loaded by a harness cascade (only AGENTS.md is), so composing it in does not double-load.

Acceptance criteria

Config declares source roots instead of (or in addition to) explicit files
Composer discovers AGENTS.COMPOSE.md files under each root
Discovered sources flow through the slice-1 concatenation unchanged
AGENTS.COMPOSE.md is documented as the disjoint, never-cascade-loaded source convention
Tests for discovery (found / none-found / multiple-roots)

Blocked by

Blocked by #135

🤖 Filed by Claude Code on Kai's behalf.

> 🤖 Filed by Claude Code on Kai's behalf. ## Parent #134 ## What to build Replace the explicit source-file list with discovery. Config declares source *roots* (locally checked-out org repos); the composer walks each root for `AGENTS.COMPOSE.md` files and feeds them to the existing concatenation step. This establishes the disjoint-file convention: `AGENTS.COMPOSE.md` holds always-global doctrine and is never auto-loaded by a harness cascade (only `AGENTS.md` is), so composing it in does not double-load. ## Acceptance criteria - [ ] Config declares source roots instead of (or in addition to) explicit files - [ ] Composer discovers `AGENTS.COMPOSE.md` files under each root - [ ] Discovered sources flow through the slice-1 concatenation unchanged - [ ] `AGENTS.COMPOSE.md` is documented as the disjoint, never-cascade-loaded source convention - [ ] Tests for discovery (found / none-found / multiple-roots) ## Blocked by - Blocked by #135 > 🤖 Filed by Claude Code on Kai's behalf.

coilysiren referenced this issue

2026-06-03 22:18:35 +00:00

agent-compose: scope-based inclusion (machine x source scope intersection) #137

coilysiren referenced this issue

2026-06-03 22:18:35 +00:00

agent-compose: size-budget validator #138

coilysiren referenced this issue

2026-06-03 22:18:36 +00:00

agent-compose: dedup validator #139

coilysiren changed title from ~~agent-meld: source discovery via AGENTS.MELDED.md~~ to agent-compose: source discovery via AGENTS.COMPOSE.md

2026-06-03 22:31:36 +00:00

coilysiren commented

2026-06-03 23:02:06 +00:00

Author

Owner

🤖 Filed by Claude Code on Kai's behalf.

Discovery landed in 514a6c6 (pushed to GitHub origin; closing here manually across the GitHub->Forgejo boundary). roots config key walks for AGENTS.COMPOSE.md, sorted + deduped + dot-dir-skipped, appended after explicit sources. Non-directory root and zero-resolved-sources are hard errors. AGENTS.COMPOSE.md documented as the disjoint never-cascade-loaded convention. 20 composer tests green (110 total).

🤖 Filed by Claude Code on Kai's behalf.

> 🤖 Filed by Claude Code on Kai's behalf. Discovery landed in `514a6c6` (pushed to GitHub origin; closing here manually across the GitHub->Forgejo boundary). `roots` config key walks for AGENTS.COMPOSE.md, sorted + deduped + dot-dir-skipped, appended after explicit `sources`. Non-directory root and zero-resolved-sources are hard errors. AGENTS.COMPOSE.md documented as the disjoint never-cascade-loaded convention. 20 composer tests green (110 total). > 🤖 Filed by Claude Code on Kai's behalf.

coilysiren closed this issue

2026-06-03 23:02:07 +00:00

coilysiren referenced this issue from a commit

2026-06-03 23:47:27 +00:00

feat(agent-compose): discover AGENTS.COMPOSE.md sources under declared roots

coilysiren referenced this issue

2026-06-04 00:06:45 +00:00

Design: agent-compose - composed, cross-harness global agent context #134