Add the repo-map skill and a CLAUDE.md #31

Open

claudeBot wants to merge 1 commit from claudebot/repo-map into main AGit

claudeBot commented

2026-11-03 19:15:08 +00:00

Contributor

What it adds:

.claude/skills/repo-map/: the skill and repo-map.sh. It prints the layout, one line of classes and functions per file, the npm scripts, and the API's routes and migrations. About 330 lines (15 KB) in under 2 seconds, with no network or database.
A tuned setting, API_DIR=api. The game sits at the root, so the script detects the node stack and would miss the Laravel API. With this setting the API's routes (from php artisan route:list when api/vendor exists, a static scan of api/routes otherwise) and migrations get their own heading, and api/storage and api/bootstrap/cache stay out of the layout.
CLAUDE.md: the stack, where things live, the exact commands, and the rules that are easy to break. Answers never reach the browser, the JavaScript and PHP checkers mirror each other, and every string exists in English and Welsh.
.ignore for lock files and source maps, and build/ in .gitignore.

No game or API code changes. npm test passes (121 tests).

Fresh agent sessions spent their first minutes listing directories and opening files to learn the layout. This adds the repo-map skill from omp-templates (node stack, omp-matrix-bot#27) and a `CLAUDE.md`, so a new session runs one script and knows where things live. What it adds: 1. `.claude/skills/repo-map/`: the skill and `repo-map.sh`. It prints the layout, one line of classes and functions per file, the npm scripts, and the API's routes and migrations. About 330 lines (15 KB) in under 2 seconds, with no network or database. 2. A tuned setting, `API_DIR=api`. The game sits at the root, so the script detects the node stack and would miss the Laravel API. With this setting the API's routes (from `php artisan route:list` when `api/vendor` exists, a static scan of `api/routes` otherwise) and migrations get their own heading, and `api/storage` and `api/bootstrap/cache` stay out of the layout. 3. `CLAUDE.md`: the stack, where things live, the exact commands, and the rules that are easy to break. Answers never reach the browser, the JavaScript and PHP checkers mirror each other, and every string exists in English and Welsh. 4. `.ignore` for lock files and source maps, and `build/` in `.gitignore`. No game or API code changes. `npm test` passes (121 tests).

claudeBot added 1 commit

2026-11-03 19:15:08 +00:00

Add the repo-map skill and a CLAUDE.md

Game tests and build / build (pull_request) Successful in 53s

Details

75e2f70eee

Fresh agent sessions spent their first minutes listing directories and
opening files to learn the layout. The repo-map skill from omp-templates
prints the layout, one line of classes and functions per file, the npm
scripts and the API's routes and migrations in under 2 seconds, and
CLAUDE.md gives the commands and the rules that are easy to break.

This copy is tuned for the Laravel API in api/: an API_DIR setting maps
its routes and migrations under their own heading, and leaves its storage
and bootstrap cache out of the layout.

Game tests and build / build (pull_request) Successful in 53s

Details

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin +refs/pull/31/head:claudebot/repo-map

git switch claudebot/repo-map

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main

git merge --no-ff claudebot/repo-map

git switch claudebot/repo-map

git rebase main

git switch main

git merge --ff-only claudebot/repo-map

git switch claudebot/repo-map

git rebase main

git switch main

git merge --no-ff claudebot/repo-map

git switch main

git merge --squash claudebot/repo-map