Reverseport
CLAUDE.md18 starsChanged 7 days agoMITView on GitHub
Read AGENTS.md: layout, architecture rules, checks and tests for both engines. - port/ (ReversePort's own engine): Node ESM, zero runtime dependencies. New tool → schema and handler in port/src/tools.mjs, then docs, skills and tests. npm run test:port. - src/ (deep-analysis engine, TypeScript): npm ci, npm run build:cached, npm run check:fast, focused tests. - Do not put chat or session links in commits, pull requests or files. - main. - claude-directory: the Claude plugin directory reads the plugin from this branch.…
In this repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- llms.txtllms.txt
- rea-analysis-optimizationSkill
- rea-changelog-updateSkill
- rea-ci-tests-auditSkill
- rea-tool-designSkill
- reverse-engineer-anythingSkill
- build-inspectorSkill
- godot-portSkill
- port-projectSkill
- port-verifySkill
- proof-caseSkill
- rebuildSkill
- reverse-engineerSkill
- troubleshootSkill
- unity-to-godotSkill
The file
We split this CLAUDE.md into the rules it gives an agent
5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 3
Read AGENTS.md: layout, architecture rules, checks and tests for both engines.
- Distinctive: line 8
Do not put chat or session links in commits, pull requests or files.
- Very specific: line 23
Never add Claude-Session: lines, session URLs, Co-Authored-By: trailers or "Generated with" / "Generated by" lines to commit messages, PR …
- Distinctive: line 33
When you fix up a contributor's PR, let them make the change first.
- Distinctive: line 39
Never do an issue in parallel that a contributor has claimed or opened a PR for.
≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Working on ReversePort
Read AGENTS.md: layout, architecture rules, checks and tests for both engines.
port/(ReversePort's own engine): Node ESM, zero runtime dependencies. New tool → schema and handler inport/src/tools.mjs, then docs, skills and tests.npm run test:port.src/(deep-analysis engine, TypeScript):npm ci,npm run build:cached,npm run check:fast, focused tests.- Do not put chat or session links in commits, pull requests or files.
Branches that must stay
main.claude-directory: the Claude plugin directory reads the plugin from this branch. It is built frommainby.github/workflows/claude-directory.yml. Never delete it when cleaning up branches; if it is ever missing, run that workflow (workflow_dispatch onmain) to rebuild it.- Branches of open pull requests (release-please, dependabot).
Commits and pull requests
- Agents working for the maintainer (laaielichter) commit as
laaielichter <laaielichter@users.noreply.github.com>. - Contributing from your own account or fork? Commit under your own name and e-mail, so the work is credited to you. Never commit as laaielichter.
- Never add
Claude-Session:lines, session URLs,Co-Authored-By:trailers or "Generated with" / "Generated by" lines to commit messages, PR titles or PR descriptions.
Credit and contributors
This is a laaielichter project, and the goal is to grow its reach. Contributors are welcome and get fair credit.
- The project is presented as laaielichter's own work: in the README, docs, releases and posts, laaielichter is the author and maintainer. Work done by the maintainer's own AI agents is committed as laaielichter.
- A contributor's own commits always stay under their name. Never squash, rewrite or re-author their work away. When you fix up a contributor's PR, let them make the change first; if you land it yourself, merge their branch head so their PR shows as merged.
- Thank contributors by @name, specifically and warmly, and credit them in the release notes or CHANGELOG ("Thanks to @name"). Keep the praise in proportion: they are contributors, not co-owners or "main people" behind the project.
- Answer new contributors quickly, review kindly, and suggest a next
good first issue. - Never do an issue in parallel that a contributor has claimed or opened a PR for.
- Automated pull requests (bots, for example ones marked
oss-bugfix-bot) are reviewed like any other and merged only when they are correct and CI is green. Thank them briefly, and do not count them as people when you talk about contributors.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

