Three-Layer Architecture

┌─────────────────────────────────────────────┐
│              base (required)                 │  core.md + git.md
│  Legacy code attitude / Quality metrics /   │  Applies to all projects
│  Naming / Architecture                      │
├─────────────────────────────────────────────┤
│            language (pick)                   │  typescript.md / java.md / ...
│  Type system / Naming conventions /         │  Based on project language
│  Language-specific features                 │
├─────────────────────────────────────────────┤
│            framework (pick)                  │  vue.md / react.md / ...
│  Component standards / State management /   │  Based on project framework
│  Architecture patterns                      │
└─────────────────────────────────────────────┘

Rule priority: framework > language > base (specific rules override general rules)

Usage

Claude Code Plugin (Recommended)

Install

# Step 1: Add the marketplace
claude plugin marketplace add lifedever/claude-rules

# Step 2: Install the plugin
claude plugin install init-claude-rules@claude-rules

# Step 3: Restart Claude Code

Use

Open any project in Claude Code and run:

/init-rules

The plugin will:

1. Auto-detect your project's tech stack (TypeScript, Vue, React, etc.)
2. Ask you to confirm the detected stack
3. Read the matching rule files from the plugin
4. Generate CLAUDE.md in your project root

Update

When new rules are added upstream, update the local cache:

claude plugin marketplace update claude-rules

Then restart Claude Code. To apply updated rules to a project that already has CLAUDE.md, run /init-rules again — the plugin will ask before overwriting.

Uninstall

claude plugin uninstall init-claude-rules@claude-rules
claude plugin marketplace remove claude-rules

Manual Usage

Clone this repo and concatenate the rule files you need:

git clone https://github.com/lifedever/claude-rules.git
cd claude-rules

# Example: Vue 3 + TypeScript project
cat base/core.md base/git.md languages/typescript.md frameworks/vue.md > /path/to/project/CLAUDE.md

The rules are plain Markdown and work with any AI coding tool. Just place the output where your tool expects:

| Tool | Target File | |------|-------------| | Claude Code | CLAUDE.md | | Cursor | .cursorrules or .cursor/rules/*.mdc | | Antigravity | .antigravity/rules.md | | GitHub Copilot | .github/copilot-instructions.md |

Design Principles

1. Actionable — Every rule is directly executable by AI, no vague wording
2. Exemplified — Key rules include "Bad" and "Good" code comparisons
3. Quantified — Functions ≤30 lines, files ≤300 lines, nesting ≤3 levels, parameters ≤4
4. Up-to-date — Uses modern APIs for each language/framework (@Observable, record, as const, etc.)
5. Not hollow — Instead of "handle errors properly", specifies exactly how to handle them

Contributing

PRs for new languages or frameworks are welcome. Please follow these guidelines:

• Rules must be concrete and actionable — no "use appropriate/proper" phrasing
• Key rules should include code examples (bad practice + good practice)
• Recommend modern idioms — don't document outdated APIs
• Write in English

References

• flyeric0212/cursor-rules — Cursor IDE rules template library

License

MIT