Bryan Ramos
341f500396
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.
2.6 KiB
| name | description |
|---|---|
| worker-protocol | Standard output format, feedback handling, and operational procedures for all worker agents. |
Output format
Wrap your output in a worker_submission envelope per the message-schema skill:
---
type: worker_submission
signal: rfr | blocked | escalate
files_changed:
- path/to/file1
- path/to/file2
ac_coverage:
AC1: pass | fail | partial | na
AC2: pass | fail | partial | na
qa_check: pass | fail
---
Then the markdown body:
## Result
[Your deliverable here]
## Self-Assessment
- Acceptance criteria met: [yes/no per criterion, one line each]
- Known limitations: [any, or "none"]
Your job
Produce the assigned deliverable. Accurately. Completely. Nothing more.
- Exactly what was asked. No unrequested additions.
- When uncertain about a specific fact, verify. Otherwise trust context and training.
Self-QA
Before returning your output, run the qa-checklist skill against your work. Fix any issues you find — don't just note them. Your Self-Assessment must include the QA self-check: pass/fail line. If you can't pass your own QA, flag what remains and why.
Cost sensitivity
- Keep responses tight. Result only.
- Context is passed inline, but if your task requires reading files not provided, use Read/Glob/Grep directly. Don't guess at file contents — verify. Keep it targeted.
Commits
Do not commit until your orchestrator sends signal: lgtm. Your output envelope's signal: rfr replaces the old freetext RFR — the envelope IS the signal.
signal: rfr— you → orchestrator: work complete, ready for reviewsignal: lgtm— orchestrator → you: approved, commit nowsignal: revise— orchestrator → you: needs fixes (issues attached)
When you receive LGTM:
- Commit using conventional commit format per project conventions
- One commit per logical change
- Include only files relevant to your task
Operational failures
If blocked (tool failure, missing file, build error): try to work around it and note the workaround. If truly blocked, report to your orchestrator with what failed and what you need. No unexplained partial work.
Receiving reviewer feedback
Your orchestrator may resume you with findings from the reviewer (code quality + AC verification) or the auditor (security + runtime validation), or both.
You already have the task context and your previous work. Address the issues specified. If feedback conflicts with the original requirements, flag to your orchestrator — don't guess. Resubmit complete output in standard format. In Self-Assessment, note which issues you addressed and reference the reviewer or auditor for each.