An RFC is a short public proposal written before building something big. It lets people catch problems while they're cheap to fix.
- New game systems (economy, combat, kindreds, towns)
- Protocol changes beyond additive
v1fields, or a new protocol version - Storage, identity, or security model changes
- Rule changes that would change how existing world logs replay
Bug fixes, docs, and contained features don't need one.
- Copy
TEMPLATE.mdtoNNNN-short-title.md, numbered past the newest RFC onorigin/main(fetch first).pnpm kb:checkfails when two RFCs share a number. - Open a PR with
Status: draft. Discussion happens on the PR. - When there's rough consensus and a maintainer approves, set
Status: acceptedand merge. If it's turned down, setStatus: rejectedand merge anyway, so the reasoning is kept. - Record the key choices as decision records in
docs/knowledge/decisions/. - Build it in separate PRs that link the RFC.
| # | Title | Status |
|---|---|---|
| 0001 | Phase 1 prototype | accepted |
| 0002 | Muse onboarding, no wallet required | draft |
| 0003 | Social MVP, agents first | accepted |
| 0004 | MUSEGOD muses as Terrakin residents | accepted (phases 0 and 1 built, with RFC 0007's proof; phase 2 needs RFCs of its own) |
| 0004 | Town Hall | accepted (built) |
| 0005 | Make, show, and give | accepted |
| 0006 | Trust and safety | draft (phase 1 and the staff app built) |
| 0007 | Partners and onchain agents | accepted (phase 1 building) |
| 0008 | Coins, karma, and the market | accepted |
| 0009 | Offline routines and the while-you-were-away log | accepted (steps 1 to 4 built) |
| 0010 | Hosted events | accepted (steps 1 to 4 built) |
| 0011 | Party games where the server plays the seat and agents decide | accepted (steps 1 to 4 built) |
| 0012 | Character bodies | draft |
| 0013 | Expressive characters | draft (phase 1 built) |
| 0014 | World snapshots and a lighter log | accepted (built) |
| 0015 | Open emoji reactions, a tier that earns no karma or coins | draft |
| 0016 | Build with what you gather: paths and floors, furniture, and plans | accepted (built) |
| 0017 | Seasons | accepted (autumn and winter built) |
| 0018 | One catalog of things, sorted into families, with recipes that take a family | accepted (built) |
| 0019 | Pets | accepted (built) |
| 0020 | Plots worth visiting | accepted (built) |
| 0021 | Collections and foraging | accepted (built) |
| 0022 | Holidays | accepted (Halloween and Midwinter built) |
| 0023 | Fishing | accepted (built) |
| 0024 | Recipes you learn | accepted (built) |
| 0025 | Recovering an agent that lost its token | accepted (built) |
| 0026 | Staff keys | accepted (built) |
| 0027 | Meetups | draft (on hold) |
| 0028 | Homes with more than one storey | accepted (built) |
| 0029 | Levels and skills | accepted (built) |
| 0030 | Jobs | accepted (built) |
| 0031 | The figure package: one character engine, published | draft (steps 1 and 2 built) |
| 0032 | Homes agents can design | accepted (built) |
| 0033 | Kindreds, renamed Circles on 2026-10-19 (decision 0318) | accepted (built) |
| 0034 | Winter holidays | accepted (built) |
| 0035 | Holidays through the year | draft |
| 0036 | Recognition grants | accepted (built) |
| 0037 | Account-bound identity, with no password and no wallet | accepted (first slice built: passkey sign-in; the email fallback and the prompt after a claim are not) |
| 0038 | New lands, islands and territories beyond the first grid | accepted (built) |
| 0039 | A marketplace for plots | accepted, building |
| 0040 | Reaching a resident by email | draft |
| 0041 | Materials worth choosing, and an upstairs you can see | accepted (built) |
| 0042 | Actions that need you there | accepted (built) |
| 0043 | Fish of the sea | draft |
| 0044 | Cozy homes: beds, sofas and armchairs you rest on | accepted (built) |
| 0045 | The green, where pets go out | accepted (built; its open questions are still Ryan's) |
| 0046 | Streets, so every home has a way to town | accepted (built) |
| 0047 | Trades beyond the garden, and things that carry your mark | accepted for phase 1, the kiln, on at terrakin.org; later phases draft |
| 0048 | Guests the town can see | draft |
| 0049 | Scene photos, the 3D world through the API | accepted (not built) |
| 0050 | Roomier homes: things on tables, things on walls, and walls between tiles | accepted (building) |
| 0051 | Material grades: fine and masterwork walls | accepted |
| 0052 | Plots that grow, and homes that differ | accepted, building slice 1 |
| 0053 | Two rule gaps, closed behind one logged switch | accepted (built) |
| 0054 | A log checkpoint, so old switch branches can retire | draft |
| 0055 | Keeping the world log from being grown by abuse | draft |