writing-for-agents pass: agent definitions

[diegohb]

writing-for-agents pass: agent definitions

What to build

Every bundled specialist agent definition reads as if authored by the writing-for-agents skill: frontmatter descriptions that trigger reliably, prompt bodies with unambiguous role, prohibitions, delegation rules, and output contracts. Scope: the ten opencode-* agent markdown files under assets/agents/. This is a quality pass on existing content — agent names and frontmatter schema are public API and must not change.

Acceptance criteria

• All ten agent files pass the writing-for-agents checklist
• Agent names and frontmatter field structure unchanged (content quality only)
• bun run check and bun test green

Blocked by

None (can start immediately).

[diegohb]

Implemented on branch issue-4-writing-for-agents-agents (34ddf46). All ten agent files passed the writing-for-agents checklist: MCP-preference pointer collapsed to one positive sentence in all files; unpaired negations retired (draft gates in agent-designer/command-crafter/skill-creator, time-sensitive rule in skill-creator); agent-designer step 4 split into sequence + levers; publisher description branch-dedup and code-style positives aligned with the canonical list. Names and frontmatter field structure unchanged. bun run check + bun test green (27/27). Two-axis code review run: no hard violations; flagged items adjudicated (paired guardrails and environment caches kept per skill).