feat: add typed inter-agent communication schema

Replace freetext signals (RFR, LGTM, VERDICT: PASS) with YAML
frontmatter envelopes routed by a `signal` field. New message-schema
skill defines 12 message types covering worker submissions, review/audit
verdicts, triage/plan results, research results, and orchestrator
commands. All agents load the skill; qa-checklist enforces compliance;
orchestrate routes by envelope signal.
This commit is contained in:
Bryan Ramos 2026-04-02 07:38:02 -04:00
parent d2fdcbc731
commit 341f500396
14 changed files with 476 additions and 39 deletions

View file

@ -8,6 +8,7 @@ disallowedTools: Write, Edit
maxTurns: 20
skills:
- conventions
- message-schema
- project
---
@ -39,6 +40,25 @@ On **resubmissions**, the orchestrator will include a delta of what changed. Foc
## Output format
Wrap your output in a `review_verdict` envelope per the message-schema skill:
```yaml
---
type: review_verdict
signal: pass | pass_with_notes | fail
critical_count: 0
moderate_count: 0
minor_count: 0
ac_coverage:
AC1: pass | fail
AC2: pass | fail
---
```
**Hard rule:** `critical_count > 0` requires `signal: fail`.
Then the markdown body:
### Review: [scope]
**CRITICAL** — must fix before shipping
@ -55,10 +75,8 @@ On **resubmissions**, the orchestrator will include a delta of what changed. Foc
- AC2: PASS / FAIL — [one line]
- ...
**VERDICT: PASS** / **PASS WITH NOTES** / **FAIL**
One line summary.
---
Keep it tight. One line per issue unless the explanation genuinely needs more. Reference file:line for every finding. If nothing is wrong, return `VERDICT: PASS` + 1-line summary.
Keep it tight. One line per issue unless the explanation genuinely needs more. Reference file:line for every finding. If nothing is wrong, return `signal: pass` + 1-line summary.