submit-solution

name	submit-solution
description	Guide a workshop attendee through committing their starter-agent decomposition and opening a PR with their solution + workshop feedback. Invoke when the user says "submit", "I'm done", "open a PR", or asks how to share their solution.

Submit your StockPilot solution

You're helping a workshop attendee package up their agents/starter/agent.py decomposition and open a PR. The PR is how facilitators see what approaches people took, and the description doubles as the workshop feedback form.

Step 1 — Ask about their experience first

Before touching git, ask these three questions (use AskUserQuestion or just conversational):

1. Which subagent approach did you go with for cycle 3? (callable_agents / spawn_subagent / inline / something else)
2. What was the hardest part of the workshop? (a specific cycle, a concept, the tooling, the timing)
3. One thing you'd change about it?

Hold onto their answers — they go in the PR body.

Step 2 — Show them what they're submitting

git diff main -- agent-decomposition/agents/starter/agent.py

Walk through the diff briefly: which tools they dropped, which skills they enabled, which subagent approach they wired. If the diff is empty, they haven't edited starter — ask if they worked in a different file.

Also grab their final eval score:

ls -t evals/reports/*/starter.json | head -1 | xargs cat | python -c "import json,sys; d=json.load(sys.stdin); print(f'{d[\"score\"]:.0%}')"

Step 3 — Commit and push

git checkout -b solution/<their-name-or-handle>
git add agent-decomposition/agents/starter/agent.py
git commit -m "Workshop solution: <subagent approach>, <score>%"
git push -u origin solution/<their-name-or-handle>

Ask for their name/handle if you don't have it. If they don't have push rights to anthropics/cwc-workshops, have them fork first (gh repo fork --clone=false) and push to their fork.

Step 4 — Open the PR with feedback in the body

gh pr create --title "Workshop solution — <name>" --body-file -

PR body template (fill from step 1 + step 2):

## My decomposition

- Subagent approach: <callable_agents | spawn_subagent | inline | other>
- Final eval score: <NN>%
- Tools I dropped: <list>
- Skills I enabled: <list>

## Workshop feedback

**Hardest part:** <their answer>

**One thing I'd change:** <their answer>

**Anything else:** <free text — leave blank if nothing>

Step 5 — Confirm

Give them the PR URL and thank them. Mention that facilitators read every PR and the feedback directly shapes the next run of this workshop.

Don't

• Don't open the PR before they've seen the diff and the body
• Don't skip the feedback questions to "save time" — that's the point
• Don't include evals/reports/ or .stockpilot_ids.json in the commit