Skip to content

Commit c7eac63

Browse files
author
Taylor Arndt
committed
Fix Codex accessibility subagent dispatch
1 parent f2267cc commit c7eac63

1 file changed

Lines changed: 11 additions & 8 deletions

File tree

  • codex-plugin/skills/web-accessibility

codex-plugin/skills/web-accessibility/SKILL.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,14 +15,17 @@ unless the user explicitly asks for a single-agent pass.
1515
## Workflow
1616

1717
1. Explicitly spawn `accessibility-lead` as a Codex custom subagent for every user-facing web accessibility task. Do not satisfy this step by reading the lead reference inline. The lead coordinates the same specialist team used by Claude Code.
18-
2. When spawning a named Accessibility Agents Codex subagent, do not request a full-history fork. Pass the task context explicitly so Codex can use the selected custom agent type without inheriting the parent agent type.
19-
3. Read `codex-plugin/references/specialists/accessibility-lead.md` and `codex-plugin/references/specialists/index.json` when available. In installed Codex plugin layouts, use `.agents/plugins/a11y-agents-codex/references/specialists/` or `~/.agents/plugins/a11y-agents-codex/references/specialists/`. Use the lead decision matrix and the index to select relevant specialist references and Codex subagents.
20-
4. Identify the task domain: semantics, ARIA, keyboard, forms, contrast, overlays, live updates, headings, links, tables, mobile web, or full audit.
21-
5. Check installed Accessibility Agents extensions before finalizing dispatch. Look for extension manifests under `.a11y-agents/extensions/`, `~/.a11y-agents/extensions/`, and this plugin's `extensions/` directory.
22-
6. Dispatch matching Codex custom subagents by default for reviews, audits, new UI, changed UI, and PR accessibility checks. Do not make users manually name every specialist.
23-
7. If Codex cannot spawn `accessibility-lead`, say so before continuing. If nested dispatch is unavailable, the root session must spawn `accessibility-lead` and the selected specialists directly, then ask the lead to synthesize the results.
24-
8. The lead synthesizes specialist output: deduplicate, resolve conflicts, assign severity, map to WCAG/public standards or extension rules, and make a ship/no-ship call.
25-
9. Label extension findings with the extension name.
18+
2. If `multi_agent_v1.spawn_agent` is not already in the active tool list, call `tool_search` for `multi-agent subagent accessibility` before saying subagents are unavailable. Do not downgrade to local-only review just because the spawn tool was lazy-loaded.
19+
3. If tool discovery still does not expose `multi_agent_v1.spawn_agent`, stop and ask the user to enable subagents/Accessibility Agents before continuing, unless the user explicitly authorizes a local fallback.
20+
4. When spawning any named Accessibility Agents Codex subagent, do not request a full-history fork. Pass the task context explicitly so Codex can use the selected custom agent type without inheriting the parent agent type.
21+
5. Pass skill context to every spawned Accessibility Agents subagent. Include this skill as an item when possible: `{ "type": "skill", "name": "web-accessibility", "path": "/Users/taylorarndt/.agents/skills/web-accessibility/SKILL.md" }`. Also include the relevant specialist reference path or excerpt when the task depends on a specialist workflow.
22+
6. Read `codex-plugin/references/specialists/accessibility-lead.md` and `codex-plugin/references/specialists/index.json` when available. In installed Codex plugin layouts, use `.agents/plugins/a11y-agents-codex/references/specialists/` or `~/.agents/plugins/a11y-agents-codex/references/specialists/`. Use the lead decision matrix and the index to select relevant specialist references and Codex subagents.
23+
7. Identify the task domain: semantics, ARIA, keyboard, forms, contrast, overlays, live updates, headings, links, tables, mobile web, or full audit.
24+
8. Check installed Accessibility Agents extensions before finalizing dispatch. Look for extension manifests under `.a11y-agents/extensions/`, `~/.a11y-agents/extensions/`, and this plugin's `extensions/` directory.
25+
9. Dispatch matching Codex custom subagents by default for reviews, audits, new UI, changed UI, and PR accessibility checks. Do not make users manually name every specialist.
26+
10. If nested dispatch is unavailable inside `accessibility-lead`, the root session must spawn `accessibility-lead` and the selected specialists directly, then ask the lead to synthesize the results.
27+
11. The lead synthesizes specialist output: deduplicate, resolve conflicts, assign severity, map to WCAG/public standards or extension rules, and make a ship/no-ship call.
28+
12. Label extension findings with the extension name.
2629

2730
## Default Subagent Dispatch
2831

0 commit comments

Comments
 (0)