Share the Claude Code setup and fix outdated project docs

[braulio-dev]

Describe your changes

The project guide files for Claude Code were kept out of git, so every new worktree started without the module notes. Several of those notes also described classes that no longer exist. This puts one accurate, shared setup in the repo.

• Project guide files are now part of the repo.
  • The root guide is instructions for Claude: finding code, when to ask, how to verify, review, ship and track work, plus the house rules.
  • A new architecture doc explains the project itself (modules, build, framework). It's read when needed, so the always-loaded guide stays short.
  • Module guides are short and point to where the detail lives.
• Outdated notes are corrected.
  • Removed the clan levels section. That system isn't in the code.
  • Fixed skill types, clan ranks, game states and shop classes to match the code.
• Long subsystem write-ups moved next to their code as README files.
  • Item access, cutscenes, sites, the network layer and sailing.
• Placeholder domain files with no content are removed, and links to them fixed.
  • The real domain files (clans, champions, game, hub, progression, shops) stay.
• Shared Claude Code helpers:
  • A check that flags rule breaks as code is written (hardcoded text, missing log submit, full class names, records, divider comments).
  • A compile check at the end of a turn. It only runs when Java or Kotlin changed, about 8 seconds warm.
  • Helpers for convention review, the Network Expansion board, Outline docs and library research.
  • A backlog skill with the board's field ids, plus the two champion skill tools.
• Local Claude runtime files are now ignored.

Link to issue (if applicable)

Checklist before requesting a review

• I have performed a self-review of my code
• I have tested my changes.
  • Both checks tested with sample edits and a deliberate compile error in :lunar.

[github-actions]

Test Results

 69 files   69 suites   11s ⏱️
515 tests 512 ✅ 3 💤 0 ❌
523 runs  520 ✅ 3 💤 0 ❌

Results for commit 76bebf4.

[github-actions]

Test Results

 69 files   69 suites   8s ⏱️
515 tests 512 ✅ 3 💤 0 ❌
523 runs  520 ✅ 3 💤 0 ❌

Results for commit 76bebf4.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud