shmup/mud
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update agent config with new notes

Browse source
This commit is contained in:
Jared Miller 2026-02-07 13:54:07 -05:00
parent 8934397b1e
commit 9f867c5bee
Signed by: shmup
GPG key ID: 22B5C6D66A38B06C
1 changed files with 4 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
.claude/CLAUDE.md
View file

@ -8,6 +8,7 @@ Telnet MUD engine built on telnetlib3. Python 3.12+, managed with uv.
- `just lint` / `just typecheck` / `just test` - individual steps - `just lint` / `just typecheck` / `just test` - individual steps
- `just run` - start the server (`python -m mudlib`) - `just run` - start the server (`python -m mudlib`)
- `just debug` - start with debug logging - `just debug` - start with debug logging
- `just render` - generate full world map HTML in `build/`
## Project Layout ## Project Layout
@ -16,6 +17,8 @@ Telnet MUD engine built on telnetlib3. Python 3.12+, managed with uv.
- `worlds/` - world definition files (yaml/toml, version controlled) - `worlds/` - world definition files (yaml/toml, version controlled)
- `docs/` - project knowledge (see below) - `docs/` - project knowledge (see below)
- `DREAMBOOK.md` - the vision, philosophy, wild ideas. not a spec - `DREAMBOOK.md` - the vision, philosophy, wild ideas. not a spec
- `scripts/` - standalone tools (map renderer, etc)
- `build/` - generated output (gitignored)
- `repos/` - symlinked reference repos (telnetlib3, miniboa). gitignored, not our code - `repos/` - symlinked reference repos (telnetlib3, miniboa). gitignored, not our code
## Docs ## Docs
@ -42,6 +45,7 @@ Update docs when:
- telnetlib3 is a **dependency**, not vendored. contribute fixes upstream - telnetlib3 is a **dependency**, not vendored. contribute fixes upstream
- telnetlib3 gives us: GMCP, MSDP, NAWS, async server, reader/writer streams - telnetlib3 gives us: GMCP, MSDP, NAWS, async server, reader/writer streams
- game loop is tick-based (async task alongside telnet server) - game loop is tick-based (async task alongside telnet server)
- world is toroidal (wraps in both axes). terrain noise tiles seamlessly
- world definitions live in data files, runtime state lives in memory - world definitions live in data files, runtime state lives in memory
- SQLite for persistence (player accounts, progress) - SQLite for persistence (player accounts, progress)
- session mode stack filters what events reach the player (normal/combat/editor) - session mode stack filters what events reach the player (normal/combat/editor)