Add notification hook, directory CLAUDE.md scaffolding

- Wire Notification event in settings.json to new notify.sh hook
- notify.sh: Windows toast notifications via PowerShell balloon tip
- docs/CLAUDE.md: authoring standards for ADRs, TR registry, control manifest, engine reference
- design/CLAUDE.md: GDD directory guidance placeholder
- src/: scaffold with .gitkeep and CLAUDE.md authoring guide

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Donchitos
2026-03-16 20:17:53 +11:00
parent f36494e70c
commit 763ad1f0d1
6 changed files with 154 additions and 0 deletions

0
src/.gitkeep Normal file
View File

36
src/CLAUDE.md Normal file
View File

@@ -0,0 +1,36 @@
# Source Directory
When writing or editing game code in this directory, follow these standards.
## Engine Version Warning
The LLM's training data predates the pinned engine version.
**Always check `docs/engine-reference/` before using any engine API.**
Do not guess at post-cutoff API signatures — look them up first.
## Coding Standards
- All public APIs require doc comments
- Gameplay values must be **data-driven** (external config files), never hardcoded
- Prefer dependency injection over singletons for testability
- Every new system needs a corresponding ADR in `docs/architecture/`
- Commits must reference the relevant story ID or design document
## File Routing
Match the engine-specialist agent to the file type being written.
See `CLAUDE.md` → Technical Preferences → Engine Specialists → File Extension Routing.
When in doubt, use the primary engine specialist configured in `CLAUDE.md`.
## Tests
Tests live in `tests/` — not in `src/`.
Run `/test-setup` to scaffold the test framework if it doesn't exist yet.
Every gameplay system should have unit tests covering its formulas and edge cases.
## Verification-Driven Development
Write tests first when adding gameplay systems.
For UI changes, verify with screenshots.
Compare expected output to actual output before marking work complete.