jpmschweitzer/settled-reach
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(skills): require file output in workshop skill

Browse Source 
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 <noreply@anthropic.com>
This commit is contained in:
jpmschweitzer
2026-02-17 13:59:55 +01:00
co-authored by Claude Opus 4.6
parent 6bf075ed8e
commit 7043fd7e4f
1 changed files with 7 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/start-workshop/SKILL.md
+7 -5
View File
@@ -49,8 +49,9 @@ One task per participant containing:
- Instruction to read the full brief at its path - Instruction to read the full brief at its path
- The specific questions assigned to that participant (extracted from all layers) - The specific questions assigned to that participant (extracted from all layers)
- The output format from the brief's round description - 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. 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 ### 7. Between Rounds
When all Round N tasks are complete: When all Round N tasks are complete:
1. Qatux produces round summary in `workshop-notes.md` 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. Create Round N+1 tasks (integration pass, synthesis, etc.) 2. Qatux reads all `*-round{N}.md` files and produces round summary in `round-{N}-notes.md`
3. Assign to agents with TaskUpdate 3. Create Round N+1 tasks (integration pass, synthesis, etc.) — include the same file output requirement
4. Agents continue working 4. Assign to agents with TaskUpdate
5. Agents continue working
### 8. Wrap Up ### 8. Wrap Up