Decision needed (Jack) — ratify the depth-1 redesign's three fork-facing gates
This is the gate that unblocks all fork-side work (B1–B8) in the Amico agent/skill architecture depth-1 redesign. Design spec is in Aaron's vault (spec-20260708-112732-amico-agent-architecture-depth1-redesign); happy to walk through it live. No fork code changes until this is ratified — B1–B8 are drafted but intentionally unfiled.
Context (one paragraph)
The Amico agent stack was built for Claude Code (root session = orchestrator). Amicode is an opencode fork. Source audit finding: opencode does not hard-block subagent nesting — it's a per-agent task permission default, overridable in config (CC blocks it hard; the fork is soft). So the 1117-line orchestrator could be ported, but shouldn't — control flow (iteration loop, DAG walk, escalation) belongs in a score + extension, not an LLM, for reproducibility/cost/provenance. Agents flatten to depth-1 leaves; the tool surface standardizes on a CLI that both runtimes call.
The three decisions
- G-1 — orchestration home: opencode score (data-driven flow) vs extension TS. Recommendation: score manifests for flow +
amicode_* tool validation for enforcement; TS only for genuinely new stage-kinds. Open sub-question: does the experiment-iteration loop fit the stage model or need a TS driver?
- G-8 — depth policy: flat-by-default, with a governed
task-grant escape hatch in the opencode ring only. Recommendation: built-in general/explore stay ungranted; nothing granted now; the skill/agent lint hard-fails a task grant lacking a justifying frontmatter annotation.
- G-9 — tool-transport boundary: CLI-first spine (
amico verbs, the amico-run lineage) + optional amico mcp-serve facade + opencode-plugins reserved for interview/session-bound UX + remote HTTP for the cloud ring. Interacts with the open-core release — this puts the entitlement gate (gate.ts, exit-64) in the OSS shell. A runnable draft scaffold exists (Aaron's machine, ~/harmoniqs/amico-cli-draft, bun test green) generalizing the real amico-run; the amicode_* migration is the load-bearing sub-decision.
What ratification unblocks
B1 generalize amico-run → amico CLI · B2/B3 migrate bookkeeping tools to verbs · B4 harness-reframe prototype · B5 MCP facade · B6 one-source agent/skill compiler · B7 retrieval tools · B8 full orchestrator dissolution.
Acceptance criteria
Blocked by
None — this is the decision gate for Track B.
Decision needed (Jack) — ratify the depth-1 redesign's three fork-facing gates
This is the gate that unblocks all fork-side work (B1–B8) in the Amico agent/skill architecture depth-1 redesign. Design spec is in Aaron's vault (
spec-20260708-112732-amico-agent-architecture-depth1-redesign); happy to walk through it live. No fork code changes until this is ratified — B1–B8 are drafted but intentionally unfiled.Context (one paragraph)
The Amico agent stack was built for Claude Code (root session = orchestrator). Amicode is an opencode fork. Source audit finding: opencode does not hard-block subagent nesting — it's a per-agent
taskpermission default, overridable in config (CC blocks it hard; the fork is soft). So the 1117-line orchestrator could be ported, but shouldn't — control flow (iteration loop, DAG walk, escalation) belongs in a score + extension, not an LLM, for reproducibility/cost/provenance. Agents flatten to depth-1 leaves; the tool surface standardizes on a CLI that both runtimes call.The three decisions
amicode_*tool validation for enforcement; TS only for genuinely new stage-kinds. Open sub-question: does the experiment-iteration loop fit the stage model or need a TS driver?task-grant escape hatch in the opencode ring only. Recommendation: built-ingeneral/explorestay ungranted; nothing granted now; the skill/agent lint hard-fails ataskgrant lacking a justifying frontmatter annotation.amicoverbs, theamico-runlineage) + optionalamico mcp-servefacade + opencode-plugins reserved for interview/session-bound UX + remote HTTP for the cloud ring. Interacts with the open-core release — this puts the entitlement gate (gate.ts, exit-64) in the OSS shell. A runnable draft scaffold exists (Aaron's machine,~/harmoniqs/amico-cli-draft,bun testgreen) generalizing the realamico-run; theamicode_*migration is the load-bearing sub-decision.What ratification unblocks
B1 generalize
amico-run→amicoCLI · B2/B3 migrate bookkeeping tools to verbs · B4 harness-reframe prototype · B5 MCP facade · B6 one-source agent/skill compiler · B7 retrieval tools · B8 full orchestrator dissolution.Acceptance criteria
amicode_*triage ratified (coordinated with the open-core split)Blocked by
None — this is the decision gate for Track B.