coilyco-flight-deck/agent-compose
coilyco-flight-deck/agent-compose
Watch
2
0
Code Issues 20 Pull requests Projects Releases 161 Packages Wiki Activity Actions

Epic: ship agent-compose v0.1 context bundles #1

New issue
Closed
opened 2026-07-16 07:59:12 +00:00 by coilyco-ops · 5 comments
coilyco-ops commented 2026-07-16 07:59:12 +00:00
Member
Copy link

Program context

This is the agent-compose implementation epic from coilysiren/inbox#216, the agent knowledge-base reset. Agent-compose becomes Kai's public personal assembly and delivery system between reusable AOS knowledge, embedded person policy, and Ward or native-harness consumers.

Outcome

Ship a public, personal-first v0.1 that accepts explicit agent, role, personality, model-class, privacy-scope, and target-repo facts, resolves Kai's embedded public-safe person policy plus scoped overlays, and emits an immutable context bundle with a versioned manifest.

Ownership boundary

Agent-compose owns schema, resolution, compilation, materialization, caching, harness projection, diagnostics, and Kai's public-safe company and personality configuration. It does not own reusable AOS knowledge, private overlays, Ward authority policy, credentials, or infrastructure rollout.

Acceptance criteria

  • Versioned input and bundle contracts are documented and tested.
  • The default product embeds Kai's ten-seat company, sixteen personalities, and curated compatibility from #10.
  • Personal defaults are first-class product source, not a sample forced through a premature generic extension framework.
  • One command composes a deterministic bundle from public fixture sources.
  • Native harness and Ward consumers both use the same bundle contract.
  • Repo language and product capabilities select skills without Ward parsing AOS policy.
  • Every bundle retains a deterministic decision trace that explains inclusions, exclusions, fallbacks, and delivery choices.
  • Humans can inspect and diff that trace ergonomically without turning unattended startup into a wall of logs.
  • Concurrent launches cannot mutate or observe a partially written shared bundle.
  • Claude, Codex, Goose, and local Qwen/OpenCode compatibility is exercised.
  • The existing AOS composer migrates without leaving a second implementation.
  • Generated bundles and rendered references remain uncommitted.
  • A versioned v0.1 artifact and upgrade path are published.

Blocked by

None - child slices establish their own dependency order.

Execution type

HITL at contract review points. Implementation slices should otherwise be AFK.

## Program context This is the agent-compose implementation epic from `coilysiren/inbox#216`, the agent knowledge-base reset. Agent-compose becomes Kai's public personal assembly and delivery system between reusable AOS knowledge, embedded person policy, and Ward or native-harness consumers. ## Outcome Ship a public, personal-first v0.1 that accepts explicit agent, role, personality, model-class, privacy-scope, and target-repo facts, resolves Kai's embedded public-safe person policy plus scoped overlays, and emits an immutable context bundle with a versioned manifest. ## Ownership boundary Agent-compose owns schema, resolution, compilation, materialization, caching, harness projection, diagnostics, and Kai's public-safe company and personality configuration. It does not own reusable AOS knowledge, private overlays, Ward authority policy, credentials, or infrastructure rollout. ## Acceptance criteria - [ ] Versioned input and bundle contracts are documented and tested. - [ ] The default product embeds Kai's ten-seat company, sixteen personalities, and curated compatibility from #10. - [ ] Personal defaults are first-class product source, not a sample forced through a premature generic extension framework. - [ ] One command composes a deterministic bundle from public fixture sources. - [ ] Native harness and Ward consumers both use the same bundle contract. - [ ] Repo language and product capabilities select skills without Ward parsing AOS policy. - [ ] Every bundle retains a deterministic decision trace that explains inclusions, exclusions, fallbacks, and delivery choices. - [ ] Humans can inspect and diff that trace ergonomically without turning unattended startup into a wall of logs. - [ ] Concurrent launches cannot mutate or observe a partially written shared bundle. - [ ] Claude, Codex, Goose, and local Qwen/OpenCode compatibility is exercised. - [ ] The existing AOS composer migrates without leaving a second implementation. - [ ] Generated bundles and rendered references remain uncommitted. - [ ] A versioned v0.1 artifact and upgrade path are published. ## Blocked by None - child slices establish their own dependency order. ## Execution type HITL at contract review points. Implementation slices should otherwise be AFK.
coilyco-ops commented 2026-07-16 08:02:58 +00:00
Author
Member
Copy link

Child issue index

The v0.1 epic is decomposed into eight independently verifiable slices:

  1. #2 Define the v0.1 input, policy, and bundle contracts - HITL contract review, starts now.
  2. #3 Compose one public profile into a deterministic bundle - first executable tracer, blocked by #2.
  3. #4 Resolve repo capabilities into selected skills - blocked by #3.
  4. #5 Deliver one bundle across native and compiled harness profiles - blocked by #3 and #4.
  5. #6 Freshen context at launch without races or recursion - blocked by #5.
  6. #7 Consume agent-compose bundles from Ward - blocked by #2 and #3, can proceed in parallel with later harness work.
  7. #8 Explain composition decisions and diagnose bundle health - blocked by #4 and #5.
  8. #9 Migrate AOS composition and publish agent-compose v0.1 - final cutover and release gate, blocked by #5 through #8.

Milestone: v0.1 - context bundle foundation.

The dependency spine is #2 -> #3 -> #4 -> #5 -> #6, with Ward integration branching after #3, diagnostics after #5, and #9 joining every delivery path.

### Child issue index The v0.1 epic is decomposed into eight independently verifiable slices: 1. [#2 Define the v0.1 input, policy, and bundle contracts](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/2) - HITL contract review, starts now. 2. [#3 Compose one public profile into a deterministic bundle](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/3) - first executable tracer, blocked by #2. 3. [#4 Resolve repo capabilities into selected skills](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/4) - blocked by #3. 4. [#5 Deliver one bundle across native and compiled harness profiles](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/5) - blocked by #3 and #4. 5. [#6 Freshen context at launch without races or recursion](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/6) - blocked by #5. 6. [#7 Consume agent-compose bundles from Ward](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/7) - blocked by #2 and #3, can proceed in parallel with later harness work. 7. [#8 Explain composition decisions and diagnose bundle health](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/8) - blocked by #4 and #5. 8. [#9 Migrate AOS composition and publish agent-compose v0.1](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/9) - final cutover and release gate, blocked by #5 through #8. Milestone: [v0.1 - context bundle foundation](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/milestone/10). The dependency spine is `#2 -> #3 -> #4 -> #5 -> #6`, with Ward integration branching after #3, diagnostics after #5, and #9 joining every delivery path.
coilyco-ops commented 2026-07-16 08:05:21 +00:00
Author
Member
Copy link

Repository baseline landed

The public trifecta and validation shell landed on canonical main in commit 35e0da3 (docs: establish repository shell).

The baseline includes README.md, AGENTS.md, docs/FEATURES.md, the CLAUDE.md bridge, MIT LICENSE, .ward/ward.yaml, the agentic-os pre-commit catalog, and its narrow managed-YAML comment exemption.

ward exec test and the installed commit hooks both pass. The local checkout is clean and tracks origin/main. Child issue #2 can begin from a validated, public-safe repository boundary.

### Repository baseline landed The public trifecta and validation shell landed on canonical `main` in commit `35e0da3` (`docs: establish repository shell`). The baseline includes `README.md`, `AGENTS.md`, `docs/FEATURES.md`, the `CLAUDE.md` bridge, MIT `LICENSE`, `.ward/ward.yaml`, the agentic-os pre-commit catalog, and its narrow managed-YAML comment exemption. `ward exec test` and the installed commit hooks both pass. The local checkout is clean and tracks `origin/main`. Child issue #2 can begin from a validated, public-safe repository boundary.
coilyco-ops commented 2026-07-16 08:07:35 +00:00
Author
Member
Copy link

Product decision: chatty composition

Agent-compose resolution is a messy decision tree, and humans need to inspect it as a product surface rather than reverse-engineer debug logs. The v0.1 plan now treats explainability as first-class data.

  • #2 defines a deterministic decision-trace contract alongside the bundle manifest.
  • #3 emits and stores the trace from the first executable composer slice.
  • #8 Make composition decisions chatty and inspectable renders progressive human output, item-level --why, semantic bundle diffing, and health diagnostics.

Chatty does not mean noisy. Interactive composition gets a bounded summary with drill-down. Unattended wrappers stay one-line on no-change, expand for changes or warnings, and show complete context on failure. Human explanation output never enters generated model instructions.

### Product decision: chatty composition Agent-compose resolution is a messy decision tree, and humans need to inspect it as a product surface rather than reverse-engineer debug logs. The v0.1 plan now treats explainability as first-class data. * #2 defines a deterministic decision-trace contract alongside the bundle manifest. * #3 emits and stores the trace from the first executable composer slice. * [#8 Make composition decisions chatty and inspectable](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/8) renders progressive human output, item-level `--why`, semantic bundle diffing, and health diagnostics. Chatty does not mean noisy. Interactive composition gets a bounded summary with drill-down. Unattended wrappers stay one-line on no-change, expand for changes or warnings, and show complete context on failure. Human explanation output never enters generated model instructions.
coilyco-ops commented 2026-07-16 08:18:23 +00:00
Author
Member
Copy link

Personal-first v0.1 update

The v0.1 tracker now has a ninth child slice: #10 Embed Kai ten-seat company and personality catalog. It carries the roles, sixteen personalities, curated compatibility, operating-mode expression, and personality safety invariant specified in agentic-os#602.

The product contract in #1, #2, #3, #5, #8, and #9 now treats the embedded public-safe person source as first-class. Agent-compose owns organizational and personality context. Ward still owns executable role authority and permissions. AOS retains reusable knowledge and general skills.

The final migration issue is now #9 Migrate AOS composition and publish personal v0.1 and is blocked by #10. The repository positioning landed on main in 7d7ba17.

### Personal-first v0.1 update The v0.1 tracker now has a ninth child slice: [#10 Embed Kai ten-seat company and personality catalog](https://forgejo.coilysiren.me/coilyco-flight-deck/agent-compose/issues/10). It carries the roles, sixteen personalities, curated compatibility, operating-mode expression, and personality safety invariant specified in agentic-os#602. The product contract in #1, #2, #3, #5, #8, and #9 now treats the embedded public-safe person source as first-class. Agent-compose owns organizational and personality context. Ward still owns executable role authority and permissions. AOS retains reusable knowledge and general skills. The final migration issue is now **#9 Migrate AOS composition and publish personal v0.1** and is blocked by #10. The repository positioning landed on `main` in `7d7ba17`.
coilyco-ops commented 2026-07-24 13:07:55 +00:00
Author
Member
Copy link

v0.1 acceptance audit

All autonomous acceptance work is complete.

  • Contracts and deterministic composition landed through #2 and #3, with tested KDL, manifest, bundle, and trace contracts.
  • The embedded personal-first roster and personality catalog landed through #10 and the later person-source consolidation work.
  • Repo capabilities and model class select skills in agent-compose. AOS publishes provider decisions, while Ward does not parse AOS policy.
  • Native projection supports Claude, Codex, Goose, and OpenCode from the same immutable bundle contract.
  • Ward consumes that contract through a verified fixed read-only mount in Ward commit b339ac4.
  • Decision traces, human summaries, item-level explanations, diffs, and health diagnostics landed through #8.
  • Atomic materialization, warm refresh, and concurrent-launch coverage landed through #6 and subsequent stability fixes.
  • The former AOS composition implementation was absorbed and removed. AOS commit 9f7ec90 retains only the reusable low-context provider decision.
  • Generated bundles, projections, and person snapshots stay outside repositories.
  • Automated release publication is active, and versioned artifacts exist through v0.33.0 before the final evaluation-pack push. Upgrade behavior is documented in the contracts and integration guides.

The full Ward, agent-compose, and AOS validation surfaces passed for the landed changes. The two remaining agent-compose tickets, #72 and #73, contain only human taste and behavior-scoring decisions. They do not represent unfinished v0.1 implementation.

The epic is complete.

## v0.1 acceptance audit All autonomous acceptance work is complete. * Contracts and deterministic composition landed through #2 and #3, with tested KDL, manifest, bundle, and trace contracts. * The embedded personal-first roster and personality catalog landed through #10 and the later person-source consolidation work. * Repo capabilities and model class select skills in agent-compose. AOS publishes provider decisions, while Ward does not parse AOS policy. * Native projection supports Claude, Codex, Goose, and OpenCode from the same immutable bundle contract. * Ward consumes that contract through a verified fixed read-only mount in Ward commit `b339ac4`. * Decision traces, human summaries, item-level explanations, diffs, and health diagnostics landed through #8. * Atomic materialization, warm refresh, and concurrent-launch coverage landed through #6 and subsequent stability fixes. * The former AOS composition implementation was absorbed and removed. AOS commit `9f7ec90` retains only the reusable low-context provider decision. * Generated bundles, projections, and person snapshots stay outside repositories. * Automated release publication is active, and versioned artifacts exist through `v0.33.0` before the final evaluation-pack push. Upgrade behavior is documented in the contracts and integration guides. The full Ward, agent-compose, and AOS validation surfaces passed for the landed changes. The two remaining agent-compose tickets, #72 and #73, contain only human taste and behavior-scoring decisions. They do not represent unfinished v0.1 implementation. The epic is complete.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feat/gamedev-role
feat/boundary-omit
aos/claude/eval-context
aos/claude/eval-current-state
aos/claude/eval-refs-restore
aos/claude/eval-docs-one-page
aos/claude/personality-anchors
aos/claude/favorite-color-spread
aos/claude/personality-catalog-gaps
aos/claude/gh297-binding-skill-selector
aos/claude/personality-prose-distinctiveness
aos/claude/gh56-adopt-aos-eval
aos/claude/aw85-bands
aos/claude/xu59-just
aos/claude/xu59-eval-export
aos/claude/xu59-comment-caps
aos/claude/xu59-pr-ci
aos/claude/xu59-role-attribution
aos/claude/ck78-banner
aos/claude/mg96-fm
rescue/precommit-v0.18-uncommitted
evals/262-board-run
claude/agents-temp-clone-note
assets/compose-mark
adjacency/262-role-adjacents
chore/precommit-bump
prose/257-258-233-second-person
boundary/254-primitive-rename
fix/acompose-undefined-role-bindings
comms/rescope-counterpart
native-home/968-user-scope-projection
meld/248-evidence-acquisition
meld/231-shared-role-melds
evals/240-baseline
evals/240-model-arms
spike/claude-native-ui-surfaces
issue-225-compact-director-eval
issue-210
issue-218
issue-215-remove-context-levels
codex/luna-medium-ai-evaluation
issue-206-align-role-tiers
codex/luna-medium-roster-prose
issue-196-remove-legacy-role-providers
issue-197-role-provider-graph
feat/model-tiers
feat/remove-context-levels
issue-187
issue-178-content-communication-ownership
issue-163-designer-evals
codex/issue-794-preserve-canonical-projections
issue-163-ornith-direct-eval
issue-163-design-current-eval
issue-150-v2-baseline
issue-156-content-code
issue-150-v2-evidence
issue-150-v2-evaluation
issue-154-v2-main-integration
issue-148-remove-v1-integrations
issue-146-core-roster
issue-144-aos-catalogue-manifest
issue-152-release-classifier
issue-139-role-metadata-last
issue-138-designer-visual-web
issue-785-first-person
ward-salvage/agent-compose-078db83c
ward-salvage/agent-compose-74e37165
issue-130
recovery/2026-07-27-local-work
v2.39.0
v2.38.0
v2.37.0
v2.36.0
v2.35.0
v2.34.0
v2.33.0
v2.32.0
v2.31.0
v2.30.0
v2.29.0
v2.28.0
v2.27.0
v2.26.0
v2.25.0
v2.24.0
v2.23.0
v2.22.0
v2.21.0
v2.20.0
v2.19.0
v2.18.0
v2.17.0
v2.16.0
v2.15.0
v2.14.0
v2.13.0
v2.12.0
v2.11.0
v2.10.0
v2.9.0
v2.8.0
v2.7.0
v2.6.0
v2.5.0
v2.4.0
v2.3.0
v2.2.0
v2.1.0
v2.0.0
v1.49.0
v1.48.0
v1.47.0
v1.46.0
v1.45.0
v1.44.0
v1.43.0
v1.42.0
v1.41.0
v1.40.0
v1.39.0
v1.38.0
v1.37.0
v1.36.0
v1.35.0
v1.34.0
v1.33.0
v1.32.0
v1.31.0
v1.30.0
v1.29.0
v1.28.0
v1.27.0
v1.26.0
v1.25.0
v1.24.0
v1.23.0
v1.22.0
v1.21.0
v1.20.0
v1.19.0
v1.18.0
v1.17.0
v1.16.0
v1.15.0
v1.14.0
v1.13.0
v1.12.0
v1.11.0
v1.10.0
v1.9.0
v1.8.0
v1.7.0
v1.6.0
v1.5.0
v1.4.0
v1.3.0
v1.2.0
v1.1.0
v1.0.0
v0.70.0
v0.69.0
v0.68.0
v0.67.0
v0.66.0
v0.65.0
v0.64.0
v0.63.0
v0.62.0
v0.61.0
v0.60.0
v0.59.0
v0.58.0
v0.57.0
v0.56.0
v0.55.0
v0.54.0
v0.53.0
v0.52.0
v0.51.0
v0.50.0
v0.49.0
v0.48.0
v0.47.0
v0.46.0
v0.45.0
v0.44.0
v0.43.0
v0.42.0
v0.41.0
v0.40.0
v0.39.0
v0.38.0
v0.37.0
v0.36.0
v0.35.0
v0.34.0
v0.33.0
v0.32.0
v0.31.0
v0.30.0
v0.29.0
v0.28.0
v0.27.0
v0.26.0
v0.25.0
v0.24.0
v0.23.0
v0.22.0
v0.21.0
v0.20.0
v0.19.0
v0.18.0
v0.17.0
v0.16.0
v0.15.0
v0.14.0
v0.13.0
v0.12.0
v0.11.0
v0.10.0
v0.9.0
v0.8.0
v0.7.0
v0.6.0
v0.5.0
v0.4.1
v0.4.0
v0.3.0
v0.2.1
v0.2.0
v0.1.2
v0.1.1
v0.1.0
Labels
Clear labels
  
autonomy
async-consult
 A human needs to consult on the issue to upgrade it to headless

  
autonomy
epic
 This issue has many units of sub work - its size makes it meaningfully exclusive with other autonomy types

  
autonomy
headless
 The agent can perform the work on its own

  
autonomy
live-collab
 The agent and the human need to work together in realtime

  
coherence-core
Core review set for the warded control plane coherence milestone. These issues form the release spine; adjacent milestone issues are stretch or supporting work.

  
priority
P0
 priority tier

  
priority
P1
 priority tier

  
priority
P2
 priority tier

  
priority
P3
 priority tier

  
priority
P4
 priority tier

  
qa-fixture
Disposable issue admitted to the bounded Ward QA verification lane.

  
role/ai
requires work from the AI Engineer role

  
role/creator
requires work from Content Creator role

  
role/design
requires work from the design role

  
role/director
requires work from the director role

  
role/engineer
requires work from the engineer role

  
role/exec
requires work from the exec role

  
role/human
requires a person, and specifically not an agent seat

  
role/ops
requires work from the ops role

  
role/qa
requires work from the QA role

No labels
autonomy
async-consult
autonomy
epic
autonomy
headless
autonomy
live-collab
coherence-core
priority
P0
priority
P1
priority
P2
priority
P3
priority
P4
qa-fixture
role/ai
role/creator
role/design
role/director
role/engineer
role/exec
role/human
role/ops
role/qa
Milestone
Clear milestone
No items
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-flight-deck/agent-compose#1
No description provided.