docs: KB access path for book-grounded design questions
This commit is contained in:
@@ -33,6 +33,36 @@ Non-negotiable canon highlights (full rationale in CONCEPT.md):
|
||||
- **Siege/base-defense mode: permanently rejected.** Do not build,
|
||||
do not re-propose.
|
||||
|
||||
## Design questions — where answers live, in order
|
||||
|
||||
1. **CONCEPT.md / MOE.md** (paths above) — most questions are
|
||||
already settled there; check the decisions log and § Open
|
||||
questions before re-deriving anything.
|
||||
2. **The advisor repo's persistent memory** —
|
||||
`~/development/advisors/game-design/persistent-memory.md` —
|
||||
for context, foot-guns, and tried-and-abandoned ideas.
|
||||
3. **The book, via the KB.** Load-bearing design-theory claims
|
||||
ground in Jesse Schell, *The Art of Game Design* (3rd ed.),
|
||||
retrievable live:
|
||||
|
||||
```bash
|
||||
cd ~/development/advisors/game-design
|
||||
source env.sh # gitignored credentials; if missing, see env.sh.template there
|
||||
uv run --with httpx python kb_query.py "your query" --title "Art of Game Design"
|
||||
```
|
||||
|
||||
Always pass `--title "Art of Game Design"` (mixed corpus). Use
|
||||
distinctive tokens (lens names, Schell's coined terms), not broad
|
||||
words. Confidence buckets: high ≥ 0.030, medium ≥ 0.016.
|
||||
**Honesty discipline (hard floor): quote what the KB returns;
|
||||
if it doesn't surface the claim, say so — never confabulate
|
||||
"Schell says."** An empty result means retrieval missed, not
|
||||
that the book lacks it. Full retrieval guidance: the advisor
|
||||
repo's CLAUDE.md.
|
||||
|
||||
Foot-gun: env.sh carries a borrowed Worldtree key (ratatoskr's);
|
||||
HTTP 401 means it rotated — fix documented in env.sh's header.
|
||||
|
||||
## Engine
|
||||
|
||||
- **Godot 4.7.1-stable, pinned.** Both dev machines run
|
||||
|
||||
Reference in New Issue
Block a user