The loop
Five stages. Humans own the decisions; Claude does most of the typing. The last stage feeds the first: each loop starts smarter than the one before. The commands in each box come from the Compound Engineering plugin.
Brainstorm
Whole team · Claude asks questions
Agree on the civic question, who it is for, and what a good result at 2:30 looks like.
Output: A one-paragraph problem statement.
/ce-brainstormPlan
Claude drafts · team edits
Break the goal into small steps. Decide what to skip if time runs short.
Output: A numbered plan with a must-have demo.
/ce-planArchitecture
Claude proposes · team decides
Pick the data files, the tools (a map? a chart? a page?), and where it will live.
Output: A sketch: data → cleaning → output.
plan mode (Shift+Tab)Build
Claude types · one person drives
Work one step at a time. Open the result after every step. Commit when something works.
Output: Working code, committed.
/ce-workQA
Everyone · plus automated tests
Check the numbers against the raw data, try it on a phone, run the tests, get a review.
Output: Tests passing and a list of known gaps.
/ce-code-review
↺ Compound: write down what worked and what broke (/ce-compound), then start the next loop.
The loop on the day
The event runs 11 to 3. A realistic plan is one full loop before lunch and a second, smaller loop after.
- 11:00Welcome
- 11:15Plan
- 11:45Build 1
- 12:30QA 1
- 12:45Food
- 1:00Build 2
- 2:00QA + README
- 2:30Demos
A typical prototype architecture
Most Day in Our Data projects share one shape. Name each box when you ask Claude to plan, and it will build in that order.
Raw data
Already in the event repo
CSV and GeoJSON files in
data/, each with a fetch script that records its source.Output: Untouched source files.
Clean
pandas / geopandas
Fix types, trim junk, join tables. Keep this in its own script so it can be tested.
Output:
data/clean/*.csvAnalyze
pandas, plain Python
Answer the civic question with numbers: counts, rates, change over time.
Output: A small summary table.
Present
folium, plotly, streamlit, HTML
A map, a chart, or a one-page app a resident can understand in 30 seconds.
Output: Something you can open and demo.
Publish
A zip or GitHub, then the showcase
Write the five-heading README, then save your work (a zip from the workspace, or a push to GitHub) and enter it in the showcase.
Output: Your entry in the showcase.
Who does what
| Stage | The team decides | Claude does | Prompt to try |
|---|---|---|---|
| Brainstorm | Which question matters to residents | Asks clarifying questions, suggests angles | Interview us about starter project 6 until you can write a one-paragraph goal. |
| Plan | What is in and out of scope | Drafts steps, flags risks and unknowns | Plan this in 5 steps. Mark the must-have demo and what to cut first. |
| Architecture | Map or chart? Page or notebook? | Proposes files, libraries, and data flow | Propose the simplest architecture. No databases unless we need one. |
| Build | When a step is good enough | Writes and runs code, fixes its own errors | Do step 1 only, then tell me how to open the result. |
| QA | Whether the numbers are believable | Writes tests, reviews code, checks accessibility | Write tests that compare your totals to the raw CSV, then run them. |
| Compound | What to remember next time | Writes notes into CLAUDE.md or docs/ | Add what we learned today to CLAUDE.md. |
Compound Engineering in one page
| Type this | What it does |
|---|---|
/ce-ideate | Not sure what to build? Explore options first. |
/ce-brainstorm | Question-and-answer session that ends in a written requirements plan. |
/ce-plan | Turn requirements into a step-by-step implementation plan. |
/ce-work | Carry out the plan, writing and running the code. |
/ce-simplify-code | Tidy fresh code for clarity and reuse. |
/ce-code-review | Several reviewer agents check the work against the plan. |
/ce-compound | Record the lessons in docs/solutions/ so the next loop starts smarter. |
/ce-debug | Start from a bug report instead of a feature. |
/lfg | Run the whole pipeline hands-off. Fun to watch; review everything it produces. |