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 @@ fill `.opencode/` with task-specific noise.
- **Owned**: `.opencode/skills/conventions/SKILL.md` (primary); audit consistency across all `.opencode/` files
- **Consume**: repo-context, architecture, build-and-test (when relevant)
## Evidence & Handoffs
Produce structured state records for drift corrections and handoffs — not for every audit read:
```text
goal: <the standard you were asked to restore>
hypothesis: <what you believe drifted> (when relevant)
evidence: <what was observed — file:line, docs, conventions>
actions_taken: <what was actually done>
result: <the restored state>
verification: <how restoration was validated — re-read, check command>
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 drift finding and the minimal correction applied (file:line), plus validation that the standard is restored. Record stale `.opencode/` content as findings for correction; never invent a new standard without authorization.
Stop when your deliverable is complete and verified per your Completion Rule; escalate when the established standard itself is uncertain.
## Core Philosophy
Mirror a disciplined maintenance style: