| name | add-exhibit |
| description | Create a new C# Mistakes Explained exhibit end to end - scaffold from the template, write Bad.cs/Good.cs/README.md, verify by running, then wire the front page and memory. Use when adding an exhibit or when the curator names a candidate to build. |
Add an exhibit
The end-to-end procedure for producing one exhibit. The conventions for each
file load automatically from .claude/rules/ when you edit it - this skill is
the workflow that ties them together, so it stays procedural and does not
restate those rules.
1. Define and check the candidate
- One exhibit = one broken mental model (see the curation bar in
CLAUDE.md).
- Read
.claude/memory/rejected.md first - never re-propose a declined
idea. Then backlog.md for the queued candidates and archetypes.md for
balance.
- Fix the hall (category) and a kebab-case slug that names the crime:
0002-doubles-for-money, not 0002-my-bug.
2. Get a number
dotnet run tools/next-id.cs
Numbers are global, four digits, never reused.
3. Scaffold from the template
cp -r .claude/skills/add-exhibit/template src/<hall>/<NNNN>-<slug>
4. Write Bad.cs, then Good.cs
Editing .cs under src/ auto-loads exhibit-code.md (mirror rule, self-audit
throw, determinism, escape hatches). Bad must end in a visible, deterministic
failure; Good is its mirror.
5. Write README.md
Editing the exhibit README auto-loads exhibit-readme.md (front-matter, fixed
section order, cross-links, tone).
6. Verify by running
dotnet run Bad.cs
dotnet run Good.cs
Paste the real output - never claim it runs unseen. Then from the repo root:
dotnet run tools/check-links.cs
7. Wire the front page and memory
-
If the hall is new, flip its row in .claude/memory/halls.md from planned
to opened first.
-
Regenerate the front page - never hand-edit it:
dotnet run tools/gen-frontpage.cs
-
Update .claude/memory/state.md (count, exhibit table, next id) and move
the candidate out of backlog.md (to done, or to rejected.md with a reason
if it was dropped mid-build).
8. Hand off
Leave the work uncommitted. Report the summary and the commit message
Add exhibit #NNNN: <slug>. Commit only when the curator says so.
Halls
Valid categories, their emoji, and open/planned status live in the canonical
registry .claude/memory/halls.md. Pick the hall from there. Opening a
planned hall: build its first exhibit, then flip its row from planned to opened.
