@malamute/ai-rules 1.3.1 → 1.4.0

package/README.md

@@ -10,12 +10,12 @@ AI Rules installs curated configuration boilerplates that teach Claude Code your
 
 ## Why Use This?
 
-| Without AI Rules | With AI Rules |
-|------------------|---------------|
-| Claude uses generic patterns | Claude follows your framework's idioms |
-| You repeat "use signals, not decorators" | Angular 21 patterns are built-in |
-| Security issues slip through | OWASP Top 10 rules catch vulnerabilities |
-| Inconsistent code style | Consistent conventions across the team |
+| Without AI Rules                         | With AI Rules                            |
+| ---------------------------------------- | ---------------------------------------- |
+| Claude uses generic patterns             | Claude follows your framework's idioms   |
+| You repeat "use signals, not decorators" | Angular 21 patterns are built-in         |
+| Security issues slip through             | OWASP Top 10 rules catch vulnerabilities |
+| Inconsistent code style                  | Consistent conventions across the team   |
 
 ## Quick Start
 
@@ -24,7 +24,7 @@ AI Rules installs curated configuration boilerplates that teach Claude Code your
 npx @malamute/ai-rules init
 
 # Or specify your stack directly
-npx @malamute/ai-rules init angular nestjs --all
+npx @malamute/ai-rules init angular nestjs
 ```
 
 That's it. Claude Code now understands your stack.
@@ -41,19 +41,20 @@ npx @malamute/ai-rules <command>
 
 ## Supported Technologies
 
-| Technology | Stack | Version |
-|------------|-------|---------|
-| **Angular** | Nx + NgRx + Signals + Vitest | 21+ |
-| **Next.js** | App Router + React 19 + Server Components | 15+ |
-| **NestJS** | Prisma/TypeORM + Passport + Vitest | 11+ |
-| **.NET** | Clean Architecture + MediatR + EF Core | 9+ |
-| **FastAPI** | Pydantic v2 + SQLAlchemy 2.0 + pytest | 0.115+ |
-| **Flask** | Marshmallow + SQLAlchemy 2.0 + pytest | 3.0+ |
+| Technology  | Stack                                     | Version |
+| ----------- | ----------------------------------------- | ------- |
+| **Angular** | Nx + NgRx + Signals + Vitest              | 21+     |
+| **Next.js** | App Router + React 19 + Server Components | 15+     |
+| **NestJS**  | Prisma/TypeORM + Passport + Vitest        | 11+     |
+| **.NET**    | Clean Architecture + MediatR + EF Core    | 9+      |
+| **FastAPI** | Pydantic v2 + SQLAlchemy 2.0 + pytest     | 0.115+  |
+| **Flask**   | Marshmallow + SQLAlchemy 2.0 + pytest     | 3.0+    |
 
 ## Commands
 
 ```bash
 ai-rules init [tech...]     # Install configs (interactive if no tech)
+ai-rules add <tech>         # Add technology to existing installation
 ai-rules update             # Update to latest rules
 ai-rules status             # Show installation info
 ai-rules list               # List available technologies
@@ -61,39 +62,37 @@ ai-rules list               # List available technologies
 
 ### Options
 
-| Option | Description |
-|--------|-------------|
-| `--with-skills` | Add skills: `/learning`, `/review`, `/debug`, etc. |
-| `--with-rules` | Add shared rules: security, performance, accessibility |
-| `--all` | Include both skills and rules |
-| `--dry-run` | Preview changes without writing files |
-| `--target <dir>` | Install to a specific directory |
-| `--force` | Overwrite without creating backups |
+| Option           | Description                                               |
+| ---------------- | --------------------------------------------------------- |
+| `--minimal`      | Skip skills and shared rules (only tech rules + settings) |
+| `--dry-run`      | Preview changes without writing files                     |
+| `--target <dir>` | Install to a specific directory                           |
+| `--force`        | Overwrite without creating backups                        |
+
+By default, `init` installs everything (skills + shared rules). Use `--minimal` to skip extras.
 
 ## What Gets Installed
 
 ```
 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
 
@@ -102,9 +101,11 @@ Context-aware rules that activate based on file paths:
 ```markdown
 ---
 paths:
-  - "**/*.component.ts"
+  - '**/*.component.ts'
 ---
+
 # Angular Component Rules
+
 - Use `ChangeDetectionStrategy.OnPush`
 - Use `input()`, `output()`, not decorators
 - Template in separate `.html` file
@@ -114,33 +115,33 @@ paths:
 
 Interactive workflows invoked with `/skill-name`:
 
-| Skill | Description |
-|-------|-------------|
-| `/learning` | Pedagogical mode — explains before coding |
-| `/review` | Code review with security/perf checklist |
-| `/debug` | Structured debugging workflow |
-| `/spec` | Write technical spec before implementing |
-| `/fix-issue` | Analyze GitHub issue and implement fix |
-| `/generate-tests` | Generate comprehensive tests |
+| Skill             | Description                               |
+| ----------------- | ----------------------------------------- |
+| `/learning`       | Pedagogical mode — explains before coding |
+| `/review`         | Code review with security/perf checklist  |
+| `/debug`          | Structured debugging workflow             |
+| `/spec`           | Write technical spec before implementing  |
+| `/fix-issue`      | Analyze GitHub issue and implement fix    |
+| `/generate-tests` | Generate comprehensive tests              |
 
 <details>
 <summary><strong>See all 13 skills</strong></summary>
 
-| Skill | Usage | Description |
-|-------|-------|-------------|
-| `/learning` | `/learning nextjs` | Explains concepts before implementing |
-| `/review` | `/review src/users/` | Code review with checklist |
-| `/spec` | `/spec add auth` | Technical specification |
-| `/debug` | `/debug TypeError...` | Systematic debugging |
-| `/fix-issue` | `/fix-issue 123` | Fix GitHub issue |
-| `/review-pr` | `/review-pr 456` | Review pull request |
-| `/generate-tests` | `/generate-tests src/user.ts` | Generate tests |
-| `/api-endpoint` | `/api-endpoint POST /users` | Generate API endpoint |
-| `/migration` | `/migration add users` | Database migration |
-| `/security-audit` | `/security-audit` | Security analysis |
-| `/docker` | `/docker` | Dockerfile generation |
-| `/deploy` | `/deploy` | Deployment config |
-| `/explore` | `/explore` | Repository analysis |
+| Skill             | Usage                         | Description                           |
+| ----------------- | ----------------------------- | ------------------------------------- |
+| `/learning`       | `/learning nextjs`            | Explains concepts before implementing |
+| `/review`         | `/review src/users/`          | Code review with checklist            |
+| `/spec`           | `/spec add auth`              | Technical specification               |
+| `/debug`          | `/debug TypeError...`         | Systematic debugging                  |
+| `/fix-issue`      | `/fix-issue 123`              | Fix GitHub issue                      |
+| `/review-pr`      | `/review-pr 456`              | Review pull request                   |
+| `/generate-tests` | `/generate-tests src/user.ts` | Generate tests                        |
+| `/api-endpoint`   | `/api-endpoint POST /users`   | Generate API endpoint                 |
+| `/migration`      | `/migration add users`        | Database migration                    |
+| `/security-audit` | `/security-audit`             | Security analysis                     |
+| `/docker`         | `/docker`                     | Dockerfile generation                 |
+| `/deploy`         | `/deploy`                     | Deployment config                     |
+| `/explore`        | `/explore`                    | Repository analysis                   |
 
 </details>
 
@@ -148,15 +149,15 @@ Interactive workflows invoked with `/skill-name`:
 
 Cross-framework rules included with `--with-rules`:
 
-| Rule | What It Covers |
-|------|----------------|
-| **security.md** | OWASP Top 10: injection, XSS, CSRF, secrets |
-| **performance.md** | N+1 queries, caching, lazy loading |
-| **accessibility.md** | WCAG 2.1, semantic HTML, ARIA |
-| **testing-patterns.md** | AAA pattern, mocking, coverage |
-| **error-handling.md** | Error categories, response formats |
-| **git.md** | Conventional commits, branching, PRs |
-| **observability.md** | Logging, metrics, tracing |
+| Rule                    | What It Covers                              |
+| ----------------------- | ------------------------------------------- |
+| **security.md**         | OWASP Top 10: injection, XSS, CSRF, secrets |
+| **performance.md**      | N+1 queries, caching, lazy loading          |
+| **accessibility.md**    | WCAG 2.1, semantic HTML, ARIA               |
+| **testing-patterns.md** | AAA pattern, mocking, coverage              |
+| **error-handling.md**   | Error categories, response formats          |
+| **git.md**              | Conventional commits, branching, PRs        |
+| **observability.md**    | Logging, metrics, tracing                   |
 
 ## Examples
 
@@ -164,10 +165,16 @@ Cross-framework rules included with `--with-rules`:
 
 ```bash
 # Angular frontend + NestJS backend
-ai-rules init angular nestjs --all
+ai-rules init angular nestjs
 
 # Next.js frontend + FastAPI backend
-ai-rules init nextjs fastapi --all
+ai-rules init nextjs fastapi
+
+# Add a technology to existing installation
+ai-rules add nestjs
+
+# Minimal install (no skills/shared rules)
+ai-rules init angular --minimal
 ```
 
 ### Preview Before Installing
@@ -177,15 +184,15 @@ ai-rules init angular --dry-run
 ```
 
 Output:
+
 ```
 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
@@ -210,89 +217,89 @@ ai-rules update
 <details>
 <summary><strong>Angular</strong></summary>
 
-| Aspect | Convention |
-|--------|------------|
-| Components | Standalone, OnPush change detection |
-| Signals | `input()`, `output()`, `model()` functions |
-| State | NgRx with Entity Adapter + Functional Effects |
-| Structure | Nx monorepo with feature/ui/data-access libs |
-| Tests | Vitest + Marble testing |
+| Aspect     | Convention                                    |
+| ---------- | --------------------------------------------- |
+| Components | Standalone, OnPush change detection           |
+| Signals    | `input()`, `output()`, `model()` functions    |
+| State      | NgRx with Entity Adapter + Functional Effects |
+| Structure  | Nx monorepo with feature/ui/data-access libs  |
+| Tests      | Vitest + Marble testing                       |
 
 </details>
 
 <details>
 <summary><strong>Next.js</strong></summary>
 
-| Aspect | Convention |
-|--------|------------|
-| Components | Server Components by default |
-| Client | `'use client'` directive for interactivity |
-| Data | Server Components + fetch, Server Actions |
-| State | Zustand (simple) / Redux Toolkit (complex) |
-| Structure | App Router with route groups |
+| Aspect     | Convention                                 |
+| ---------- | ------------------------------------------ |
+| Components | Server Components by default               |
+| Client     | `'use client'` directive for interactivity |
+| Data       | Server Components + fetch, Server Actions  |
+| State      | Zustand (simple) / Redux Toolkit (complex) |
+| Structure  | App Router with route groups               |
 
 </details>
 
 <details>
 <summary><strong>NestJS</strong></summary>
 
-| Aspect | Convention |
-|--------|------------|
-| Architecture | Modular Monolith |
-| Validation | class-validator + class-transformer |
-| Database | Prisma (modern) / TypeORM (decorators) |
-| Auth | Passport + JWT |
-| Tests | Vitest + Supertest |
+| Aspect       | Convention                             |
+| ------------ | -------------------------------------- |
+| Architecture | Modular Monolith                       |
+| Validation   | class-validator + class-transformer    |
+| Database     | Prisma (modern) / TypeORM (decorators) |
+| Auth         | Passport + JWT                         |
+| Tests        | Vitest + Supertest                     |
 
 </details>
 
 <details>
 <summary><strong>.NET</strong></summary>
 
-| Aspect | Convention |
-|--------|------------|
+| Aspect       | Convention                                |
+| ------------ | ----------------------------------------- |
 | Architecture | Clean Architecture (Domain → App → Infra) |
-| API | Minimal APIs (preferred) or Controllers |
-| CQRS | MediatR for Commands/Queries |
-| ORM | Entity Framework Core |
-| Tests | xUnit + NSubstitute + FluentAssertions |
+| API          | Minimal APIs (preferred) or Controllers   |
+| CQRS         | MediatR for Commands/Queries              |
+| ORM          | Entity Framework Core                     |
+| Tests        | xUnit + NSubstitute + FluentAssertions    |
 
 </details>
 
 <details>
 <summary><strong>FastAPI</strong></summary>
 
-| Aspect | Convention |
-|--------|------------|
-| Framework | FastAPI with async/await |
-| Validation | Pydantic v2 |
-| ORM | SQLAlchemy 2.0 with async support |
-| Tests | pytest + httpx |
-| Migrations | Alembic |
+| Aspect     | Convention                        |
+| ---------- | --------------------------------- |
+| Framework  | FastAPI with async/await          |
+| Validation | Pydantic v2                       |
+| ORM        | SQLAlchemy 2.0 with async support |
+| Tests      | pytest + httpx                    |
+| Migrations | Alembic                           |
 
 </details>
 
 <details>
 <summary><strong>Flask</strong></summary>
 
-| Aspect | Convention |
-|--------|------------|
-| Framework | Flask 3.0 with Application Factory |
-| Validation | Marshmallow schemas |
-| ORM | SQLAlchemy 2.0 |
-| Tests | pytest |
+| Aspect     | Convention                                          |
+| ---------- | --------------------------------------------------- |
+| Framework  | Flask 3.0 with Application Factory                  |
+| Validation | Marshmallow schemas                                 |
+| ORM        | SQLAlchemy 2.0                                      |
+| Tests      | pytest                                              |
 | Extensions | Flask-SQLAlchemy, Flask-Migrate, Flask-JWT-Extended |
 
 </details>
 
 ## 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 +313,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/_shared/rules/conventions/git.md

@@ -9,6 +9,8 @@ paths:
 
 Format: `type(scope): description`
 
+**No `Co-Authored-By`** - Do not add Co-Authored-By trailers to commits.
+
 ```bash
 # Types
 feat     # New feature

package/configs/_shared/rules/lang/python/python.md

@@ -1,13 +1,11 @@
-# Python Conventions
-
-## Activation
-
-```yaml
+---
 paths:
   - "**/*.py"
   - "**/pyproject.toml"
   - "**/requirements*.txt"
-```
+---
+
+# Python Conventions
 
 ## Type Hints (Required)
 

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/flask/rules/flask.md

@@ -1,11 +1,9 @@
-# Flask Rules
-
-## Activation
-
-```yaml
+---
 paths:
   - "**/*.py"
-```
+---
+
+# Flask Rules
 
 ## Application Factory
 

package/configs/flask/rules/marshmallow.md

@@ -1,11 +1,9 @@
-# Marshmallow Validation Rules
-
-## Activation
-
-```yaml
+---
 paths:
   - "**/*.py"
-```
+---
+
+# Marshmallow Validation Rules
 
 ## Schema Definition
 

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.4.0",
   "description": "Claude Code configuration boilerplates for Angular, Next.js, NestJS, .NET, Python and more",
   "type": "module",
   "main": "src/index.js",
@@ -11,6 +11,8 @@
     "test:coverage": "vitest run --coverage",
     "lint": "eslint src bin",
     "lint:rules": "node scripts/lint-rules.js",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "validate": "npm test && npm run lint:rules"
   },
   "keywords": [
@@ -46,10 +48,14 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "dependencies": {
+    "@inquirer/prompts": "^7.5.3"
+  },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "eslint": "^9.39.2",
     "husky": "^9.1.7",
+    "prettier": "^3.5.3",
     "vitest": "^2.0.0"
   },
   "packageManager": "yarn@4.12.0"

package/src/cli.js

@@ -1,7 +1,8 @@
-import readline from 'readline';
+import { checkbox, input } from '@inquirer/prompts';
 import { colors, log } from './utils.js';
 import { VERSION, AVAILABLE_TECHS } from './config.js';
 import { init, update, status, listTechnologies } from './installer.js';
+import { readManifest } from './merge.js';
 
 function printUsage() {
   console.log(`
@@ -9,12 +10,14 @@ ${colors.bold('AI Rules')} v${VERSION} - Claude Code configuration boilerplates
 
 ${colors.bold('Usage:')}
   ai-rules init [tech] [tech2] [options]
+  ai-rules add <tech> [options]
   ai-rules update [options]
   ai-rules status
   ai-rules list
 
 ${colors.bold('Commands:')}
   init      Install configuration (interactive if no tech specified)
+  add       Add a technology to existing installation
   update    Update installed configs to latest version
   status    Show current installation status
   list      List available technologies
@@ -28,7 +31,7 @@ ${colors.bold('Technologies:')}
   flask      Flask + SQLAlchemy + Marshmallow
 
 ${colors.bold('Options:')}
-  --minimal        Only install CLAUDE.md, settings.json, and tech rules (no shared skills/rules)
+  --minimal        Only install settings.json and tech rules (no shared skills/rules)
   --target <dir>   Target directory (default: current directory)
   --dry-run        Preview changes without writing files
   --force          Overwrite files without backup (update command)
@@ -37,78 +40,54 @@ ${colors.bold('Examples:')}
   ai-rules init                          # Interactive mode
   ai-rules init angular                  # Full install (skills + rules)
   ai-rules init angular --minimal        # Minimal install
-  ai-rules init nextjs --dry-run
+  ai-rules add nestjs                    # Add NestJS to existing install
   ai-rules update
-  ai-rules update --force
   ai-rules status
 `);
 }
 
-async function prompt(question) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-async function multiSelect(message, choices) {
-  console.log(`\n${colors.bold(message)}`);
-  console.log(colors.dim('(enter numbers separated by spaces, or "all")'));
-  console.log('');
-
-  choices.forEach((choice, i) => {
-    console.log(`  ${colors.cyan(i + 1)}. ${choice.name} ${colors.dim(`- ${choice.description}`)}`);
-  });
-
-  console.log('');
-  const answer = await prompt('Your selection: ');
-
-  if (answer.toLowerCase() === 'all') {
-    return choices.map((c) => c.value);
-  }
-
-  const indices = answer
-    .split(/[\s,]+/)
-    .map((s) => parseInt(s, 10) - 1)
-    .filter((i) => i >= 0 && i < choices.length);
-
-  return indices.map((i) => choices[i].value);
-}
-
 async function interactiveInit() {
   console.log(`\n${colors.bold('AI Rules')} - Interactive Setup\n`);
 
-  const techChoices = [
-    { name: 'Angular', value: 'angular', description: 'Angular 21 + Nx + NgRx + Signals' },
-    { name: 'Next.js', value: 'nextjs', description: 'Next.js 15 + React 19 + App Router' },
-    { name: 'NestJS', value: 'nestjs', description: 'NestJS 11 + Prisma/TypeORM + Passport' },
-    { name: '.NET', value: 'dotnet', description: '.NET 9 + ASP.NET Core + EF Core' },
-    { name: 'FastAPI', value: 'fastapi', description: 'FastAPI + SQLAlchemy 2.0 + Pydantic v2' },
-    { name: 'Flask', value: 'flask', description: 'Flask + SQLAlchemy 2.0 + Marshmallow' },
-  ];
-
-  const techs = await multiSelect('Select technologies:', techChoices);
+  const techs = await checkbox({
+    message: 'Select technologies:',
+    instructions: '(Space to select, Enter to confirm)',
+    choices: [
+      { name: 'Angular - Angular 21 + Nx + NgRx + Signals', value: 'angular' },
+      { name: 'Next.js - Next.js 15 + React 19 + App Router', value: 'nextjs' },
+      { name: 'NestJS - NestJS 11 + Prisma/TypeORM + Passport', value: 'nestjs' },
+      { name: '.NET - .NET 9 + ASP.NET Core + EF Core', value: 'dotnet' },
+      { name: 'FastAPI - FastAPI + SQLAlchemy 2.0 + Pydantic v2', value: 'fastapi' },
+      { name: 'Flask - Flask + SQLAlchemy 2.0 + Marshmallow', value: 'flask' },
+    ],
+  });
 
   if (techs.length === 0) {
     log.error('No technology selected');
     process.exit(1);
   }
 
-  const extraChoices = [
-    { name: 'Skills', value: 'skills', description: '/learning, /review, /spec, /debug, etc.' },
-    { name: 'Shared Rules', value: 'rules', description: 'security, performance, accessibility' },
-  ];
-
-  const extras = await multiSelect('Include extras:', extraChoices);
+  const extras = await checkbox({
+    message: 'Include extras:',
+    instructions: '(Space to toggle, Enter to confirm)',
+    choices: [
+      {
+        name: 'Skills - /learning, /review, /spec, /debug, etc.',
+        value: 'skills',
+        checked: true,
+      },
+      {
+        name: 'Shared Rules - security, performance, accessibility',
+        value: 'rules',
+        checked: true,
+      },
+    ],
+  });
 
-  const targetDir = await prompt(`Target directory ${colors.dim('(. for current)')}: `) || '.';
+  const targetDir = await input({
+    message: 'Target directory:',
+    default: '.',
+  });
 
   const options = {
     target: targetDir === '.' ? null : targetDir,
@@ -164,6 +143,61 @@ export async function run(args) {
     return;
   }
 
+  if (command === 'add') {
+    const targetIndex = args.indexOf('--target');
+    const targetDir = targetIndex !== -1 ? args[targetIndex + 1] : process.cwd();
+
+    const manifest = readManifest(targetDir);
+    if (!manifest) {
+      log.error('No ai-rules installation found.');
+      console.log(`Run ${colors.cyan('ai-rules init')} first.`);
+      process.exit(1);
+    }
+
+    const newTechs = [];
+    for (let i = 1; i < args.length; i++) {
+      const arg = args[i];
+      if (arg === '--target') {
+        i++; // Skip next arg
+      } else if (arg === '--dry-run' || arg === '--force') {
+        // Handled below
+      } else if (!arg.startsWith('-')) {
+        if (AVAILABLE_TECHS.includes(arg)) {
+          if (manifest.technologies.includes(arg)) {
+            log.warning(`${arg} is already installed, skipping`);
+          } else {
+            newTechs.push(arg);
+          }
+        } else {
+          log.error(`Unknown technology: ${arg}`);
+          console.log(`Available: ${AVAILABLE_TECHS.join(', ')}`);
+          process.exit(1);
+        }
+      }
+    }
+
+    if (newTechs.length === 0) {
+      log.error('No new technology to add');
+      process.exit(1);
+    }
+
+    const allTechs = [...manifest.technologies, ...newTechs];
+
+    const options = {
+      target: targetDir === process.cwd() ? null : targetDir,
+      withSkills: manifest.options?.withSkills ?? true,
+      withRules: manifest.options?.withRules ?? true,
+      dryRun: args.includes('--dry-run'),
+      force: args.includes('--force'),
+    };
+
+    console.log('');
+    log.info(`Adding ${newTechs.join(', ')} to existing installation`);
+
+    init(allTechs, options);
+    return;
+  }
+
   if (command === 'init') {
     const minimal = args.includes('--minimal');
     const options = {

package/src/installer.js

@@ -1,8 +1,14 @@
 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 {
+  CONFIGS_DIR,
+  AVAILABLE_TECHS,
+  VERSION,
+  getRulePathsToInclude,
+  shouldIncludeRule,
+} from './config.js';
+import { mergeSettingsJson, readManifest, writeManifest } from './merge.js';
 
 /**
  * Copy skills to target directory with flat structure.
@@ -114,8 +120,12 @@ export function listTechnologies() {
   const skills = fs.existsSync(path.join(sharedPath, 'skills'));
   const rules = fs.existsSync(path.join(sharedPath, 'rules'));
 
-  console.log(`  ${skills ? colors.green('✓') : colors.red('✗')} skills     /learning, /review, /spec, /debug, and more`);
-  console.log(`  ${rules ? colors.green('✓') : colors.red('✗')} rules      security, performance, accessibility`);
+  console.log(
+    `  ${skills ? colors.green('✓') : colors.red('✗')} skills     /learning, /review, /spec, /debug, and more`
+  );
+  console.log(
+    `  ${rules ? colors.green('✓') : colors.red('✗')} rules      security, performance, accessibility`
+  );
   console.log('');
 }
 
@@ -136,7 +146,9 @@ export function status(targetDir) {
 
   console.log(`  ${colors.bold('Installed version:')} ${manifest.version}`);
   console.log(`  ${colors.bold('Latest version:')}   ${VERSION}`);
-  console.log(`  ${colors.bold('Installed at:')}     ${new Date(manifest.installedAt).toLocaleString()}`);
+  console.log(
+    `  ${colors.bold('Installed at:')}     ${new Date(manifest.installedAt).toLocaleString()}`
+  );
   console.log('');
 
   if (manifest.technologies?.length) {
@@ -155,7 +167,9 @@ export function status(targetDir) {
   }
 
   if (manifest.version !== VERSION) {
-    console.log(`  ${colors.yellow('⚠')} Update available! Run ${colors.cyan('ai-rules update')} to update.`);
+    console.log(
+      `  ${colors.yellow('⚠')} Update available! Run ${colors.cyan('ai-rules update')} to update.`
+    );
     console.log('');
   }
 
@@ -187,8 +201,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,31 +211,13 @@ 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(
-        path.join(targetDir, '.claude', 'settings.json'),
-        settingsPath,
-        { dryRun, backup, targetDir }
-      );
+      const op = mergeSettingsJson(path.join(targetDir, '.claude', 'settings.json'), settingsPath, {
+        dryRun,
+        backup,
+        targetDir,
+      });
       operations.push(op);
 
       if (dryRun) {
@@ -235,11 +229,11 @@ export function init(techs, options) {
 
     const rulesDir = path.join(techDir, 'rules');
     if (fs.existsSync(rulesDir)) {
-      const ops = copyDirRecursive(
-        rulesDir,
-        path.join(targetDir, '.claude', 'rules', tech),
-        { dryRun, backup, targetDir }
-      );
+      const ops = copyDirRecursive(rulesDir, path.join(targetDir, '.claude', 'rules', tech), {
+        dryRun,
+        backup,
+        targetDir,
+      });
       operations.push(...ops);
 
       if (dryRun) {
@@ -252,11 +246,11 @@ export function init(techs, options) {
     if (options.withSkills) {
       const techSkillsDir = path.join(techDir, 'skills');
       if (fs.existsSync(techSkillsDir)) {
-        const ops = copySkillsToTarget(
-          techSkillsDir,
-          path.join(targetDir, '.claude', 'skills'),
-          { dryRun, backup, targetDir }
-        );
+        const ops = copySkillsToTarget(techSkillsDir, path.join(targetDir, '.claude', 'skills'), {
+          dryRun,
+          backup,
+          targetDir,
+        });
         operations.push(...ops);
       }
     }
@@ -268,11 +262,11 @@ export function init(techs, options) {
     log.info(`${dryRun ? 'Would install' : 'Installing'} skills...`);
     const skillsDir = path.join(sharedDir, 'skills');
     if (fs.existsSync(skillsDir)) {
-      const ops = copySkillsToTarget(
-        skillsDir,
-        path.join(targetDir, '.claude', 'skills'),
-        { dryRun, backup, targetDir }
-      );
+      const ops = copySkillsToTarget(skillsDir, path.join(targetDir, '.claude', 'skills'), {
+        dryRun,
+        backup,
+        targetDir,
+      });
       operations.push(...ops);
 
       if (dryRun) {
@@ -312,23 +306,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);

package/src/tech-config.json

@@ -36,10 +36,5 @@
       "backend": "domain/backend"
     }
   },
-  "alwaysInclude": [
-    "conventions",
-    "quality",
-    "security",
-    "devops"
-  ]
+  "alwaysInclude": ["conventions", "quality", "security", "devops"]
 }