A collection of AI coding-assistant rulesets I use across my own projects. Drop one into your AI tool's rules/custom-instructions file (Cursor, Windsurf, Claude Code, etc.) to apply that persona or workflow.
Feel free to copy and adapt anything here for your own use.
| File | Tool | What it does |
|---|---|---|
ai-instructor-rules.md |
Any | Teaching-mode persona — discovery-first, mentor-style guidance instead of writing code for the learner |
architect-mode.md |
Any | Forces upfront requirements analysis and design before any implementation starts |
riper-mode.md |
Cursor | Strict RIPER-5 protocol (Research/Innovate/Plan/Execute/Review) to stop unauthorized changes |
conventional-commits-guidelines.md |
Any | Full Conventional Commits v1.0.0 spec, adapted for AI-generated commit messages |
personal-dev-general-ruleset.md |
Any | General cross-language development principles (polyglot: Java, C++, Kotlin, C#, Swift, Python, web) |
java-dev-general-rules.md |
Windsurf | Java/Spring Boot-specific role and coding conventions |
java-style-rules.md |
Any | Java style guide (Google + Oracle conventions, 140-char line length) |
effective-java-rules.md |
Any | All 90 items from Joshua Bloch's Effective Java, 3rd Edition, condensed as rules |
I try to keep these updated and add new ones as I need them, but no guarantees.