| name | just-rules |
| description | Use when wanting minimal project rules without design docs or implementation plans — just CLAUDE.md and AGENTS.md |
Just Rules
Creates CLAUDE.md and AGENTS.md only. No docs/, no plans, no design specs.
Files to Create
1. CLAUDE.md (project root)
Project context file. Keep under 60 lines.
Must include:
- Project description (ask user)
- Tech stack and commands (ask user)
@AGENTS.md — import for all coding conventions
2. AGENTS.md (project root)
All coding rules. Keep under 80 lines.
Must include:
# AGENTS.md
## Working Rules
- EXPLAIN FIRST — explain WHAT and WHY before writing code
- ONE LOGICAL UNIT — one unit of work per response, one commit per unit
- COMMIT AFTER EACH FEATURE
- ANSWER QUESTIONS — pause and explain when asked
- DRY — extract shared logic
## Code Style
- Comments explain WHY not WHAT, no JSDoc unless public API
- Use CSS variables/tokens, no arbitrary colors
- Use cn() for conditional class merging
- No inline styles, use Tailwind classes
## Git
- Format: feat: one liner description
- One logical change per commit
## Anti-Patterns (Avoid)
- Generic blue/indigo everywhere
- Same border radius on everything
- Gradient backgrounds
- Template nav bars
- Bland "Welcome to..." headings
- Default shadows on all cards
## Prefer Instead
- Asymmetric layouts, mixed border radii
- Dark mode support
- Micro-interactions, skeleton loaders
- Personality over templates
Rules
- CLAUDE.md = project context + imports. AGENTS.md = coding rules. No overlap.
- Adapt to user's actual stack — don't assume anything
- No fluff
