@malamute/ai-rules 1.3.1 → 1.3.2

package/README.md

@@ -74,26 +74,24 @@ ai-rules list               # List available technologies
 
 ```
 your-project/
-├── CLAUDE.md                    # Architecture & conventions
+├── CLAUDE.md                    # Your project-specific info (not touched)
 └── .claude/
     ├── settings.json            # Allowed/denied commands
     ├── rules/                   # Framework-specific patterns
-    │   ├── components.md
-    │   ├── state.md
-    │   └── testing.md
+    │   ├── nextjs/
+    │   │   ├── core.md          # Stack, architecture, conventions
+    │   │   ├── components.md
+    │   │   └── ...
+    │   ├── conventions/         # Shared conventions
+    │   │   └── core.md
+    │   └── security/
     └── skills/                  # Optional workflows
         ├── learning/
         ├── review/
         └── debug/
 ```
 
-### CLAUDE.md
-
-The main instruction file. Contains:
-- Project architecture overview
-- Technology stack and versions
-- Coding conventions (naming, structure, patterns)
-- Commands to run (build, test, lint)
+> **Note:** Your project's `CLAUDE.md` is never modified. Use it for project-specific context (business domain, team conventions, etc.).
 
 ### Rules
 
@@ -183,9 +181,8 @@ DRY RUN - No files will be modified
 ℹ Would install to: /your/project
 
 ℹ Would install angular...
-○   CLAUDE.md (create)
 ○   settings.json (create)
-○   rules/ (8 files)
+○   rules/angular/ (9 files)
 
 Summary:
   10 file(s) would be created
@@ -287,12 +284,12 @@ ai-rules update
 
 ## How It Works
 
-1. **CLAUDE.md** is read by Claude Code at session start
-2. **Rules** activate based on file paths you're editing
+1. **Rules** are loaded by Claude Code based on file paths you're editing
+2. **`rules/core.md`** with `alwaysApply: true` provides framework conventions
 3. **Skills** are invoked on-demand with `/skill-name`
 4. **Settings** define what commands Claude can run
 
-Claude Code sees your conventions as first-class instructions, not just suggestions in the chat.
+Your project's `CLAUDE.md` stays clean for project-specific context, while framework conventions live in rules.
 
 ## Contributing
 
@@ -306,13 +303,13 @@ npm install
 npm test
 
 # Add a new technology
-mkdir configs/your-tech
-# Add CLAUDE.md and .claude/rules/
+mkdir -p configs/your-tech/rules
+# Add rules/core.md and other rules
 ```
 
 ### Adding a Technology
 
-1. Create `configs/[tech]/CLAUDE.md` — start with `@../_shared/CLAUDE.md`
+1. Create `configs/[tech]/rules/core.md` with framework conventions
 2. Add rules in `configs/[tech]/rules/`
 3. Add `configs/[tech]/settings.json` for permissions
 4. Add tests

package/configs/_shared/{CLAUDE.md → rules/conventions/core.md}

@@ -1,3 +1,8 @@
+---
+description: "Shared coding conventions across all technologies"
+alwaysApply: true
+---
+
 # Shared Conventions
 
 ## Code Quality

package/configs/angular/{CLAUDE.md → rules/core.md}

@@ -1,6 +1,9 @@
-# Angular Project Guidelines
+---
+description: "Angular 21+ project conventions and architecture"
+alwaysApply: true
+---
 
-@../_shared/CLAUDE.md
+# Angular Project Guidelines
 
 ## Stack
 

package/configs/dotnet/{CLAUDE.md → rules/core.md}

@@ -1,6 +1,9 @@
-# .NET Project Guidelines
+---
+description: ".NET 9 project conventions and architecture"
+alwaysApply: true
+---
 
-@../_shared/CLAUDE.md
+# .NET Project Guidelines
 
 ## Stack
 

package/configs/fastapi/{CLAUDE.md → rules/core.md}

@@ -1,6 +1,9 @@
-# FastAPI Project Guidelines
+---
+description: "FastAPI project conventions and architecture"
+alwaysApply: true
+---
 
-@../_shared/CLAUDE.md
+# FastAPI Project Guidelines
 
 ## Stack
 

package/configs/flask/{CLAUDE.md → rules/core.md}

@@ -1,6 +1,9 @@
-# Flask Project Guidelines
+---
+description: "Flask 3.0+ project conventions and architecture"
+alwaysApply: true
+---
 
-@../_shared/CLAUDE.md
+# Flask Project Guidelines
 
 ## Stack
 

package/configs/nestjs/{CLAUDE.md → rules/core.md}

@@ -1,6 +1,9 @@
-# NestJS Project Guidelines
+---
+description: "NestJS 11+ project conventions and architecture"
+alwaysApply: true
+---
 
-@../_shared/CLAUDE.md
+# NestJS Project Guidelines
 
 ## Stack
 

package/configs/nextjs/{CLAUDE.md → rules/core.md}

@@ -1,6 +1,9 @@
-# Next.js Project Guidelines
+---
+description: "Next.js 15+ project conventions and architecture"
+alwaysApply: true
+---
 
-@../_shared/CLAUDE.md
+# Next.js Project Guidelines
 
 ## Stack
 
@@ -31,7 +34,7 @@ libs/[domain]/
 ### Folder Conventions
 
 | Pattern | Meaning |
-|---------|---------	|
+|---------|---------|
 | `_folder/` | Private - co-located, not a route |
 | `(folder)/` | Route group - organizational only |
 | `[param]/` | Dynamic segment |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@malamute/ai-rules",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Claude Code configuration boilerplates for Angular, Next.js, NestJS, .NET, Python and more",
   "type": "module",
   "main": "src/index.js",

package/src/installer.js

@@ -2,7 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import { colors, log, getFilesRecursive, copyDirRecursive, backupFile } from './utils.js';
 import { CONFIGS_DIR, AVAILABLE_TECHS, VERSION, getRulePathsToInclude, shouldIncludeRule } from './config.js';
-import { mergeClaudeMd, mergeSettingsJson, readManifest, writeManifest } from './merge.js';
+import { mergeSettingsJson, readManifest, writeManifest } from './merge.js';
 
 /**
  * Copy skills to target directory with flat structure.
@@ -187,8 +187,6 @@ export function init(techs, options) {
     fs.mkdirSync(path.join(targetDir, '.claude', 'rules'), { recursive: true });
   }
 
-  let isFirstClaudeMd = true;
-
   for (const tech of techs) {
     log.info(`${dryRun ? 'Would install' : 'Installing'} ${tech}...`);
 
@@ -199,24 +197,6 @@ export function init(techs, options) {
       process.exit(1);
     }
 
-    const claudeMdPath = path.join(techDir, 'CLAUDE.md');
-    if (fs.existsSync(claudeMdPath)) {
-      const op = mergeClaudeMd(
-        path.join(targetDir, 'CLAUDE.md'),
-        claudeMdPath,
-        isFirstClaudeMd,
-        { dryRun, backup, targetDir }
-      );
-      operations.push(op);
-      isFirstClaudeMd = false;
-
-      if (dryRun) {
-        log.dry(`  CLAUDE.md (${op.type})`);
-      } else {
-        log.success(`  CLAUDE.md`);
-      }
-    }
-
     const settingsPath = path.join(techDir, 'settings.json');
     if (fs.existsSync(settingsPath)) {
       const op = mergeSettingsJson(
@@ -312,23 +292,6 @@ export function init(techs, options) {
     }
   }
 
-  // Resolve @../_shared/CLAUDE.md imports
-  const targetClaudeMd = path.join(targetDir, 'CLAUDE.md');
-  if (!dryRun && fs.existsSync(targetClaudeMd)) {
-    let content = fs.readFileSync(targetClaudeMd, 'utf8');
-
-    if (content.includes('@../_shared/CLAUDE.md')) {
-      const sharedClaudeMd = path.join(sharedDir, 'CLAUDE.md');
-      if (fs.existsSync(sharedClaudeMd)) {
-        const sharedContent = fs.readFileSync(sharedClaudeMd, 'utf8');
-        content = content.replace(/@..\/_shared\/CLAUDE\.md/g, '');
-        content = sharedContent + '\n\n' + content;
-        fs.writeFileSync(targetClaudeMd, content);
-        log.success('Merged shared conventions into CLAUDE.md');
-      }
-    }
-  }
-
   writeManifest(
     targetDir,
     {

package/src/merge.js

@@ -3,29 +3,6 @@ import path from 'path';
 import { log, backupFile } from './utils.js';
 import { VERSION } from './config.js';
 
-export function mergeClaudeMd(targetPath, sourcePath, isFirst, options = {}) {
-  const { dryRun = false, backup = false, targetDir } = options;
-  const content = fs.readFileSync(sourcePath, 'utf8');
-  const exists = fs.existsSync(targetPath);
-
-  if (dryRun) {
-    return { type: exists ? 'merge' : 'create', path: 'CLAUDE.md' };
-  }
-
-  if (exists && backup && isFirst) {
-    backupFile(targetPath, targetDir);
-  }
-
-  if (isFirst) {
-    fs.writeFileSync(targetPath, content);
-  } else {
-    const existing = fs.readFileSync(targetPath, 'utf8');
-    fs.writeFileSync(targetPath, `${existing}\n\n---\n\n${content}`);
-  }
-
-  return { type: exists ? 'merge' : 'create', path: 'CLAUDE.md' };
-}
-
 export function mergeSettingsJson(targetPath, sourcePath, options = {}) {
   const { dryRun = false, backup = false, targetDir } = options;
   const exists = fs.existsSync(targetPath);