Add adaptive, evidence-driven architecture upgrade: decision-loop orchestrator, action catalog, evidence-state handoffs, process quality, stop conditions

- Orchestrator: linear flow replaced by adaptive decision loop
  (UNDERSTAND→ESTIMATE→LOAD CONTEXT→CHOOSE ACTION→EXECUTE→VERIFY→RE-PLAN/STOP→LEARN)
- New sections: Task Complexity Estimation (ESTIMATE→EXECUTE→EXPAND),
  Action Catalog with 24 tool-card actions, Evidence-First State and Handoff
  Discipline (9-field state records, state separation, long-horizon persistence),
  Process Quality anti-patterns, Cost and Token Awareness, Stop Conditions,
  adaptive planning + failure recovery (7 failure types), lightweight quality gates
- All 13 agents preserved; 12 subagents gain role-adapted Evidence & Handoffs
  sections (evidence product, stop, escalation) after Repository Intelligence
- Repository Intelligence Bootstrap extended with Knowledge Lifecycle rules;
  .opencode structure unchanged (knowledge/state dirs intentionally not added)
- New docs: AGENT_ARCHITECTURE.md (full architecture incl. simple/complex
  execution traces, ownership table, weaknesses) and EVALUATION_SCENARIOS.md
  (12 runtime scenarios + scoring rubric)
- New test: scripts/test-agent-architecture.sh (16 structural checks)
- Validation: 16/16 architecture tests PASS, 11/11 bootstrap tests PASS,
  install 13/13 + permission verifier PASS, live config synced byte-identical
This commit is contained in:
Your Name
2026-09-07 12:53:30 -04:00
parent c1f5f939ad
commit fb9d91e510
17 changed files with 1277 additions and 33 deletions
+20
View File
@@ -63,6 +63,26 @@ integration constraint), add it to the architecture skill and strip the
- **Owned**: `.opencode/skills/architecture/SKILL.md`
- **Consume**: repo-context, conventions, build-and-test (when relevant)
## Evidence & Handoffs
Produce structured state records for decisions and handoffs — not for every option considered:
```text
goal: <the decision you were asked to make>
hypothesis: <the structuring assumption you are testing> (when relevant)
evidence: <what was observed — files, reports, constraints>
actions_taken: <what was actually done>
result: <the decision and its scope>
verification: <how the decision was confirmed — trade-off review, constraint check>
confidence: high | medium | low
remaining_unknowns: <what is still not known>
recommended_next_action: <what should happen next, and who owns it>
```
Your primary evidence is the decision record: options considered, trade-offs, the chosen boundary/interface/ownership, and the approved scope. Mark each decision `[DECIDED]`, `[PROVISIONAL]`, or `[BLOCKED]` with its rationale.
Stop when your deliverable is complete and verified per your Completion Rule; escalate when facts needed for a defensible decision are missing.
## Core Philosophy
Mirror disciplined practical engineering: