omp-templates

Starter kits that the omp project rooms copy into their own repositories. This repository only ships the templates; every room owns, commits and tunes its own copy. Changes go through a pull request from the omp-bot room.

The bot clones this repository to /root/omp-matrix-bot/omp-templates.

repo-map

repo-map/ stops a fresh session spending tokens rediscovering a repository's layout (omp-matrix-bot#27).

Path	Goes to	Purpose
common/.claude/skills/repo-map/SKILL.md	.claude/skills/repo-map/	The discipline: map, then search, then read line ranges. omp and Claude Code both discover it from the repository root; only its one-line description costs context until it triggers
common/.claude/skills/repo-map/repo-map.sh	same	Prints layout (depth 3), one line of classes and functions per source file, and stack extras: Laravel route:list --json (static scan of routes/*.php when artisan cannot boot) and migrations, CodeIgniter spark routes and migrations, Moodle component, tables, capabilities, services, tasks and observers, MAUI projects and XAML pages, package.json scripts. Needs bash, awk and ripgrep; under a second on the Laravel skeleton
<stack>/CLAUDE.md	repository root	Skeleton with {{PLACEHOLDERS}}: stack, where things live, exact commands, conventions
<stack>/.ignore	repository root	Lock files, minified files and source maps for ripgrep and fd. omp's own grep does not read .ignore; the skill's rules cover it
<stack>/gitignore.add	merge into .gitignore	Dependency and build directories

Stacks: laravel (hildasql, topick-web, dcfcymru, booking), codeigniter (leaverequest), maui (topick-app), moodle, node. Rooms not on that list start from the closest one. repo-map.sh detects the stack itself; --stack overrides it.

Installing from a room's repository root, Laravel shown:

T=/root/omp-matrix-bot/omp-templates/repo-map
cp -rn "$T/common/.claude" .
cp -n "$T/laravel/CLAUDE.md" "$T/laravel/.ignore" .
cat "$T/laravel/gitignore.add"    # add the missing lines to .gitignore by hand
bash .claude/skills/repo-map/repo-map.sh

cp -n never overwrites: the current Laravel skeleton already ships a CLAUDE.md and AGENTS.md, so merge the skeleton's sections into those instead. omp only discovers the skill in the directory it starts in, so the moodle room (workdir /root/moodle) installs it at the Moodle root. There repo-map.sh maps only the top level and summarises each plugin clone inside core; repo-map.sh local/<plugin> maps one plugin in full.

Rollout is tracked in omp-matrix-bot#27: each project room is asked by room-msg to install and tune the template, and its reply is recorded there.

Tests

node --test

Needs Node 20.11 or later, bash, awk, ripgrep and git. No dependencies to install.