From 7043fd7e4fa2aa47750726f1de9f4d117fa2f978 Mon Sep 17 00:00:00 2001 From: Jeroen Schweitzer Date: Tue, 17 Feb 2026 13:59:55 +0100 Subject: [PATCH] chore(skills): require file output in workshop skill Agents were sending outputs as messages instead of writing files, which prevented Qatux (documenter) from reading other agents' work. Now each round task instructs agents to write to docs/workshops/{name}/{agent}-roundN.md, and between-round steps verify files exist before proceeding. Co-Authored-By: Claude Opus 4.6 --- .claude/skills/start-workshop/SKILL.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/.claude/skills/start-workshop/SKILL.md b/.claude/skills/start-workshop/SKILL.md index 40f11cb5e..5c4d0e1e3 100644 --- a/.claude/skills/start-workshop/SKILL.md +++ b/.claude/skills/start-workshop/SKILL.md @@ -49,8 +49,9 @@ One task per participant containing: - Instruction to read the full brief at its path - The specific questions assigned to that participant (extracted from all layers) - The output format from the brief's round description +- **IMPORTANT — file output requirement:** Instruct each agent to write their full output to `docs/workshops/{name}/{agent}-round{N}.md` (e.g., `docs/workshops/test-architecture/gestalt-round1.md`). Agents must write to disk, not just send messages. This ensures Qatux and other agents can read all outputs directly without relying on message forwarding. -One task for Qatux: "Document Round 1 — read all agent responses and capture decisions, questions, and dissent." +One task for Qatux: "Document Round N — read all agent output files at `docs/workshops/{name}/*-round{N}.md` and capture decisions, questions, and dissent." Assign all tasks using TaskUpdate with `owner` = agent name. @@ -75,10 +76,11 @@ For large workshops (>6 agents), spawn participants in batches to avoid overwhel ### 7. Between Rounds When all Round N tasks are complete: -1. Qatux produces round summary in `workshop-notes.md` -2. Create Round N+1 tasks (integration pass, synthesis, etc.) -3. Assign to agents with TaskUpdate -4. Agents continue working +1. Verify all agents wrote output files to `docs/workshops/{name}/`. If any are missing, nudge the agent or extract from their message and write the file yourself. +2. Qatux reads all `*-round{N}.md` files and produces round summary in `round-{N}-notes.md` +3. Create Round N+1 tasks (integration pass, synthesis, etc.) — include the same file output requirement +4. Assign to agents with TaskUpdate +5. Agents continue working ### 8. Wrap Up