| name | team-interactive-craft |
| description | Unified team skill for interactive component crafting. Vanilla JS + CSS interactive components with zero dependencies. Research -> interaction design -> build -> a11y test. Uses team-worker agent architecture. Triggers on "team interactive craft", "interactive component". |
| allowed-tools | ["AskUserQuestion","Bash","Edit","Glob","Grep","Read","SendMessage","Write","mcp__maestro__edit_file","mcp__maestro__read_file","mcp__maestro__team_msg","mcp__maestro__write_file","teammate","todo"] |
| session-mode | run |
<required_reading>
@~/.maestro/workflows/run-mode-lite.md
</required_reading>
Team Interactive Craft
Systematic interactive component pipeline: research -> interaction design -> build -> a11y test. Built on team-worker agent architecture -- all worker roles share a single agent definition with role-specific Phase 2-4 loaded from roles/<role>/role.md.
Architecture
Skill(skill="team-interactive-craft", args="task description")
|
SKILL.md (this file) = Router
|
+--------------+--------------+
| |
no --role flag --role <name>
| |
Coordinator Worker
roles/coordinator/role.md roles/<name>/role.md
|
+-- analyze -> dispatch -> spawn workers -> STOP
|
+-------+-------+-------+-------+
v v v v
[team-worker agents, each loads roles/<role>/role.md]
researcher interaction-designer builder a11y-tester
Role Registry
Pre-load (coordinator, before dispatch)
- Codebase docs: If
.workflow/codebase/ARCHITECTURE.md exists, read for module boundaries
- Specs (coding):
maestro load --type spec --category coding โ load coding constraints as shared context
- Specs (ui):
maestro load --type spec --category ui โ load ui constraints as shared context
- Wiki knowledge:
maestro search "interactive component animation" --json โ top 5 entries as prior context
- All optional โ proceed without if unavailable
Role Router
Parse $ARGUMENTS:
- Has
--role <name> -> Read roles/<name>/role.md, execute Phase 2-4
- No
--role -> @roles/coordinator/role.md, execute entry router
Shared Constants
- Session prefix:
IC
- Session path:
{run_dir}/work/team/
- CLI tools:
maestro delegate --mode analysis (read-only), maestro delegate --mode write (modifications)
- Message bus:
mcp__maestro__team_msg(session_id=<run-id>, ...)
- Max GC rounds: 2
Worker Spawn Template
Coordinator spawns workers using this template:
teammate({ agent: "team-worker", name: "<role>", description: "Spawn <role> worker for <task-id>", context: "fresh" })
User Commands
| Command | Action |
|---|
check / status | View execution status graph |
resume / continue | Advance to next step |
Specs Reference
Session Directory
{run_dir}/work/team/
+-- .msg/
| +-- messages.jsonl # Team message bus
| +-- meta.json # Pipeline config + GC state
+-- {run_dir}/outputs/research/ # Researcher output
| +-- interaction-inventory.json
| +-- browser-api-audit.json
| +-- pattern-reference.json
+-- {run_dir}/outputs/interaction/ # Interaction designer output
| +-- blueprints/
| +-- {component-name}.md
+-- {run_dir}/outputs/build/ # Builder output
| +-- components/
| +-- {name}.js
| +-- {name}.css
+-- {run_dir}/outputs/a11y/ # A11y tester output
| +-- a11y-audit-{NNN}.md
+-- wisdom/ # Cross-task knowledge
Error Handling
| Scenario | Resolution |
|---|
| Unknown command | Error with available command list |
| Role not found | Error with role registry |
| Session corruption | Attempt recovery, fallback to manual |
| Fast-advance conflict | Coordinator reconciles on next callback |
| Completion action fails | Default to Keep Active |
| GC loop stuck > 2 rounds | Escalate to user: accept / retry / terminate |
