rulesync 0.12.0 → 0.13.0

package/README.ja.md

@@ -0,0 +1,290 @@
+# rulesync
+
+[![CI](https://github.com/dyoshikawa/rulesync/actions/workflows/ci.yml/badge.svg)](https://github.com/dyoshikawa/rulesync/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/rulesync.svg)](https://www.npmjs.com/package/rulesync)
+
+統一されたAIルールファイル（`.rulesync/*.md`）から、様々なAI開発ツール用の設定ファイルを自動生成するNode.js CLIツールです。
+
+[English](./README.md) | **日本語**
+
+## 対応ツール
+
+- **GitHub Copilot Custom Instructions** (`.github/copilot-instructions.md` + `.github/instructions/*.instructions.md`)
+- **Cursor Project Rules** (`.cursor/rules/*.mdc`) 
+- **Cline Rules** (`.clinerules/*.md`)
+- **Claude Code Memory** (`./CLAUDE.md` + `.claude/memories/*.md`)
+- **Roo Code Rules** (`.roo/rules/*.md`)
+
+## インストール
+
+```bash
+npm install -g rulesync
+# または
+pnpm add -g rulesync
+# または  
+yarn global add rulesync
+```
+
+## 使い始める
+
+1. **プロジェクトを初期化:**
+   ```bash
+   npx rulesync init
+   ```
+
+2. **`.rulesync/`ディレクトリの生成されたルールファイル**をプロジェクトのニーズに合わせて編集します
+   
+   または新しいルールファイルを追加:
+   ```bash
+   npx rulesync add my-custom-rules
+   ```
+
+3. **ツール固有の設定ファイルを生成:**
+   ```bash
+   npx rulesync generate
+   ```
+
+4. **オプション: 生成されたファイルを.gitignoreに追加:**
+   ```bash
+   npx rulesync gitignore
+   ```
+
+以上です！AIコーディングアシスタントが生成された設定ファイルを自動的に使用するようになります。
+
+## rulesyncを使う理由
+
+### 🔧 **ツールの柔軟性**
+チームメンバーは好みのAIコーディングツールを自由に選択できます。GitHub Copilot、Cursor、Cline、Claude Codeのいずれであっても、各開発者は生産性を最大化するツールを使用できます。
+
+### 📈 **将来を見据えた開発**
+AI開発ツールは新しいツールが頻繁に登場し、急速に進化しています。rulesyncがあれば、ツールを切り替える際にルールを一から再定義する必要がありません。
+
+### 🎯 **マルチツールワークフロー**
+複数のAIツールを組み合わせたハイブリッド開発ワークフローを可能にします：
+- GitHub Copilot：コード補完
+- Cursor：リファクタリング
+- Claude Code：アーキテクチャ設計
+- Cline：デバッグ支援
+
+### 🔓 **ベンダーロックインなし**
+ベンダーロックインを完全に回避できます。rulesyncの使用を停止することを決定した場合でも、生成されたルールファイル（`.github/instructions/`、`.cursor/rules/`、`.clinerules/`、`CLAUDE.md`など）をそのまま使い続けることができます。
+
+### 🎯 **ツール間の一貫性**
+すべてのAIツールに一貫したルールを適用し、チーム全体のコード品質と開発体験を向上させます。
+
+## Claude Code統合
+
+### カスタムスラッシュコマンドの作成
+
+Claude Codeの組み込み`/init`コマンドを使用する代わりに、rulesync専用のカスタムスラッシュコマンドを作成することをお勧めします。
+
+[Claude Codeスラッシュコマンドドキュメント](https://docs.anthropic.com/en/docs/claude-code/slash-commands)を参照し、以下のカスタムコマンドを追加してください：
+
+**`.claude/commands/init-rulesync.md`**
+
+```markdown
+このプロジェクトの内容を確認し、必要に応じて.rulesync/*.mdファイルを更新してください。
+
+手順:
+1. プロジェクト構造とコードベースを分析
+2. 既存の.rulesync/ファイルを確認
+3. プロジェクトの技術スタック、アーキテクチャ、コーディング規約を考慮
+4. 不足している要素や改善点が見つかった場合は.rulesync/*.mdファイルを更新
+5. 必要に応じてrulesync generateを実行
+
+考慮すべきプロジェクトの特徴:
+- 技術スタック
+- アーキテクチャパターン
+- コーディング規約
+- セキュリティ要件
+- パフォーマンスの考慮事項
+```
+
+### 統合のメリット
+
+- **プロジェクト固有の初期化**: 各プロジェクトに最適化されたルール設定
+- **自動ルール更新**: プロジェクトの変更に応じてルールが自動的に適応
+- **チーム標準化**: すべてのメンバーが同じルールセットを使用
+- **継続的改善**: プロジェクトの成長とともにルールが進化
+
+## 使用方法
+
+### 1. 初期化
+
+```bash
+npx rulesync init
+```
+
+これにより、サンプルルールファイルを含む`.rulesync/`ディレクトリが作成されます。
+
+### 2. ルールファイルの編集
+
+`.rulesync/`ディレクトリ内の各Markdownファイルでメタデータをフロントマターで定義します。詳細な例については、下記の[ファイル例](#ファイル例)セクションを参照してください。
+
+### ルールレベル
+
+rulesyncは2レベルのルールシステムを使用します：
+
+- **root: true**: プロジェクト全体の概要とポリシー
+  - プロジェクトごとに**1つ**のrootファイルのみ許可
+  - 高レベルのガイドラインとプロジェクトコンテキストを含む
+- **root: false**: 具体的な実装ルールと詳細なガイドライン
+  - 複数の非rootファイルが許可
+  - 具体的なコーディングルール、命名規約などを含む
+
+#### ツール固有の動作
+
+各AIツールはルールレベルを異なって処理します：
+
+| ツール | ルートルール | 非ルートルール | 特別な動作 |
+|------|------------|----------------|------------------|
+| **Claude Code** | `./CLAUDE.md` | `.claude/memories/*.md` | CLAUDE.mdが詳細ファイルへの`@filename`参照を含む |
+| **Cursor** | `ruletype: always` | `ruletype: autoattached` | globsのない詳細ルールは`ruletype: agentrequested`を使用 |
+| **GitHub Copilot** | 標準フォーマット | 標準フォーマット | すべてのルールがフロントマター付きの同じフォーマットを使用 |
+| **Cline** | 標準フォーマット | 標準フォーマット | すべてのルールがプレーンMarkdownフォーマットを使用 |
+| **Roo Code** | 標準フォーマット | 標準フォーマット | すべてのルールが説明ヘッダー付きのプレーンMarkdownフォーマットを使用 |
+
+### 3. 設定ファイルの生成
+
+```bash
+# すべてのツール用に生成
+npx rulesync generate
+
+# 特定のツール用に生成
+npx rulesync generate --copilot
+npx rulesync generate --cursor  
+npx rulesync generate --cline
+npx rulesync generate --claude
+npx rulesync generate --roo
+
+# クリーンビルド（既存ファイルを最初に削除）
+npx rulesync generate --delete
+
+# 特定ツール用のクリーンビルド
+npx rulesync generate --copilot --cursor --delete
+
+# 詳細出力
+npx rulesync generate --verbose
+npx rulesync generate --delete --verbose
+```
+
+#### 生成オプション
+
+- `--delete`: 新しいファイルを作成する前に既存の生成済みファイルをすべて削除
+- `--verbose`: 生成プロセス中に詳細出力を表示
+- `--copilot`, `--cursor`, `--cline`, `--claude`, `--roo`: 指定されたツールのみ生成
+
+### 4. その他のコマンド
+
+```bash
+# サンプルファイルでプロジェクトを初期化
+npx rulesync init
+
+# 新しいルールファイルを追加
+npx rulesync add <filename>
+npx rulesync add typescript-rules
+npx rulesync add security.md  # .md拡張子は自動的に処理される
+
+# ルールファイルを検証
+npx rulesync validate
+
+# 現在のステータスを確認  
+npx rulesync status
+
+# ファイルを監視して自動生成
+npx rulesync watch
+
+# 生成されたファイルを.gitignoreに追加
+npx rulesync gitignore
+```
+
+## 設定ファイル構造
+
+```
+.rulesync/
+├── overview.md          # プロジェクト概要 (root: true, 1つのみ)
+├── coding-rules.md      # コーディングルール (root: false)
+├── naming-conventions.md # 命名規約 (root: false)
+├── architecture.md      # アーキテクチャガイドライン (root: false)  
+├── security.md          # セキュリティルール (root: false)
+└── custom.md           # プロジェクト固有ルール (root: false)
+```
+
+### フロントマタースキーマ
+
+各ルールファイルには以下のフィールドを含むフロントマターが必要です：
+
+```yaml
+---
+root: true | false               # 必須: ルールレベル (概要の場合true、詳細の場合false)
+targets: ["*"]                   # 必須: ターゲットツール (* = すべて、または特定のツール)
+description: "簡潔な説明"        # 必須: ルールの説明
+globs: ["**/*.ts", "**/*.js"]    # 必須: ファイルパターン (空の配列可)
+---
+```
+
+### ファイル例
+
+**ルートファイル** (`.rulesync/overview.md`):
+```markdown
+---
+root: true
+targets: ["*"]
+description: "プロジェクト概要と開発思想"
+globs: ["src/**/*.ts"]
+---
+
+# プロジェクト開発ガイドライン
+
+このプロジェクトはクリーンアーキテクチャの原則に従ったTypeScript-firstの開発を行っています。
+```
+
+**非ルートファイル** (`.rulesync/coding-rules.md`):
+```markdown
+---
+root: false
+targets: ["copilot", "cursor", "roo"]
+description: "TypeScriptコーディング標準"
+globs: ["**/*.ts", "**/*.tsx"]
+---
+
+# TypeScriptコーディングルール
+
+- 厳密なTypeScript設定を使用
+- オブジェクト形状にはtypeよりinterfaceを優先
+- 意味のある変数名を使用
+```
+
+## 生成される設定ファイル
+
+| ツール | 出力パス | フォーマット | ルールレベル処理 |
+|------|------------|--------|-------------------|
+| **GitHub Copilot** | `.github/instructions/*.instructions.md` | フロントマター + Markdown | 両レベルとも同じフォーマットを使用 |
+| **Cursor** | `.cursor/rules/*.mdc` | MDC (YAMLヘッダー + Markdown) | ルート: `ruletype: always`<br>非ルート: `ruletype: autoattached`<br>globsなしの非ルート: `ruletype: agentrequested` |
+| **Cline** | `.clinerules/*.md` | プレーンMarkdown | 両レベルとも同じフォーマットを使用 |
+| **Claude Code** | `./CLAUDE.md` (ルート)<br>`.claude/memories/*.md` (非ルート) | プレーンMarkdown | ルートはCLAUDE.mdに移動<br>非ルートは別メモリファイルに移動<br>CLAUDE.mdは`@filename`参照を含む |
+| **Roo Code** | `.roo/rules/*.md` | プレーンMarkdown | 両レベルとも説明ヘッダー付きの同じフォーマットを使用 |
+
+## バリデーション
+
+rulesyncはルールファイルを検証し、有用なエラーメッセージを提供します：
+
+```bash
+npx rulesync validate
+```
+
+一般的なバリデーションルール：
+- プロジェクトごとに1つのルートファイル（root: true）のみ許可
+- すべてのフロントマターフィールドが必須で適切にフォーマットされている
+- ファイルパターン（globs）が有効な構文を使用
+- ターゲットツールが認識される値である
+
+## ライセンス
+
+MIT License
+
+## 貢献
+
+Issues と Pull Requests を歓迎します！
+
+開発環境の設定と貢献ガイドラインについては、[CONTRIBUTING.ja.md](./CONTRIBUTING.ja.md)を参照してください。

package/README.md

@@ -5,9 +5,11 @@
 
 A Node.js CLI tool that automatically generates configuration files for various AI development tools from unified AI rule files (`.rulesync/*.md`).
 
+**English** | [日本語](./README.ja.md)
+
 ## Supported Tools
 
-- **GitHub Copilot Custom Instructions** (`.github/instructions/*.instructions.md`)
+- **GitHub Copilot Custom Instructions** (`.github/copilot-instructions.md` + `.github/instructions/*.instructions.md`)
 - **Cursor Project Rules** (`.cursor/rules/*.mdc`) 
 - **Cline Rules** (`.clinerules/*.md`)
 - **Claude Code Memory** (`./CLAUDE.md` + `.claude/memories/*.md`)
@@ -25,73 +27,29 @@ yarn global add rulesync
 
 ## Getting Started
 
-### Quick Start Example
-
 1. **Initialize your project:**
    ```bash
-   rulesync init
+   npx rulesync init
    ```
 
-2. **Create an overview file** (`.rulesync/overview.md`):
-   ```markdown
-   ---
-   root: true
-   targets: ["*"]
-   description: "Project overview and development philosophy"
-   globs: ["src/**/*.ts", "src/**/*.js"]
-   ---
-
-   # Project Development Guidelines
-
-   This is a TypeScript/JavaScript project following clean architecture principles.
-   We prioritize code readability, maintainability, and type safety.
-
-   ## Tech Stack
-   - TypeScript for type safety
-   - Node.js runtime
-   - Modern ES6+ features
-   ```
-
-3. **Create detail rules** (`.rulesync/coding-rules.md`):
-   ```markdown
-   ---
-   root: false
-   targets: ["copilot", "cursor", "cline"]
-   description: "TypeScript coding standards and best practices"
-   globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
-   ---
-
-   # TypeScript Coding Rules
-
-   ## Code Style
-   - Use strict TypeScript configuration
-   - Prefer `const` over `let` when possible
-   - Use meaningful, descriptive variable names
-   - Write JSDoc comments for public APIs
-
-   ## Type Definitions
-   - Prefer interfaces over types for object shapes
-   - Use union types for controlled values
-   - Avoid `any` type - use `unknown` instead
-   - Define return types for functions explicitly
-
-   ## Error Handling
-   - Use Result pattern for error handling
-   - Throw errors only for unexpected conditions
-   - Validate input parameters at function boundaries
+2. **Edit the generated rule files** in `.rulesync/` directory to match your project needs
+   
+   Or add new rule files:
+   ```bash
+   npx rulesync add my-custom-rules
    ```
 
-4. **Generate configuration files:**
+3. **Generate tool-specific configuration files:**
    ```bash
-   rulesync generate
+   npx rulesync generate
    ```
 
-5. **Optional: Add generated files to .gitignore:**
+4. **Optional: Add generated files to .gitignore:**
    ```bash
-   rulesync gitignore
+   npx rulesync gitignore
    ```
 
-This will create tool-specific configuration files that your AI coding assistants can use automatically.
+That's it! Your AI coding assistants will now use the generated configuration files automatically.
 
 ## Why rulesync?
 
@@ -154,28 +112,14 @@ Project characteristics to consider:
 ### 1. Initialize
 
 ```bash
-rulesync init
+npx rulesync init
 ```
 
 This creates a `.rulesync/` directory with sample rule files.
 
 ### 2. Edit Rule Files
 
-Define metadata in front matter for each Markdown file:
-
-```markdown
----
-root: true # or false
-targets: ["*"] # or [copilot, cursor, cline, claude, roo]
-description: "TypeScript coding rules"
-globs: ["**/*.ts", "**/*.tsx"]
----
-
-# TypeScript Rules
-
-- Use TypeScript
-- Write clear type annotations
-```
+Define metadata in front matter for each Markdown file in the `.rulesync/` directory. See the [Example Files](#example-files) section below for detailed examples.
 
 ### Rule Levels
 
@@ -204,24 +148,24 @@ Each AI tool handles rule levels differently:
 
 ```bash
 # Generate for all tools
-rulesync generate
+npx rulesync generate
 
 # Generate for specific tools
-rulesync generate --copilot
-rulesync generate --cursor  
-rulesync generate --cline
-rulesync generate --claude
-rulesync generate --roo
+npx rulesync generate --copilot
+npx rulesync generate --cursor  
+npx rulesync generate --cline
+npx rulesync generate --claude
+npx rulesync generate --roo
 
 # Clean build (delete existing files first)
-rulesync generate --delete
+npx rulesync generate --delete
 
 # Clean build for specific tools
-rulesync generate --copilot --cursor --delete
+npx rulesync generate --copilot --cursor --delete
 
 # Verbose output
-rulesync generate --verbose
-rulesync generate --delete --verbose
+npx rulesync generate --verbose
+npx rulesync generate --delete --verbose
 ```
 
 #### Generate Options
@@ -234,19 +178,24 @@ rulesync generate --delete --verbose
 
 ```bash
 # Initialize project with sample files
-rulesync init
+npx rulesync init
+
+# Add a new rule file
+npx rulesync add <filename>
+npx rulesync add typescript-rules
+npx rulesync add security.md  # .md extension is automatically handled
 
 # Validate rule files
-rulesync validate
+npx rulesync validate
 
 # Check current status  
-rulesync status
+npx rulesync status
 
 # Watch files and auto-generate
-rulesync watch
+npx rulesync watch
 
 # Add generated files to .gitignore
-rulesync gitignore
+npx rulesync gitignore
 ```
 
 ## Configuration File Structure
@@ -321,7 +270,7 @@ globs: ["**/*.ts", "**/*.tsx"]
 rulesync validates your rule files and provides helpful error messages:
 
 ```bash
-rulesync validate
+npx rulesync validate
 ```
 
 Common validation rules:

package/dist/index.js

@@ -26,8 +26,70 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/cli/index.ts
 var import_commander = require("commander");
 
+// src/cli/commands/add.ts
+var import_promises = require("fs/promises");
+var import_node_path = __toESM(require("path"));
+
+// src/utils/config.ts
+function getDefaultConfig() {
+  return {
+    aiRulesDir: ".rulesync",
+    outputPaths: {
+      copilot: ".github/instructions",
+      cursor: ".cursor/rules",
+      cline: ".clinerules",
+      claude: ".",
+      roo: ".roo/rules"
+    },
+    watchEnabled: false,
+    defaultTargets: ["copilot", "cursor", "cline", "claude", "roo"]
+  };
+}
+function resolveTargets(targets, config) {
+  if (targets.includes("*")) {
+    return config.defaultTargets;
+  }
+  return targets;
+}
+
+// src/cli/commands/add.ts
+function sanitizeFilename(filename) {
+  return filename.endsWith(".md") ? filename.slice(0, -3) : filename;
+}
+function generateRuleTemplate(filename) {
+  return `---
+root: false
+targets: ["*"]
+description: "Rules for ${filename}"
+globs: []
+---
+
+# ${filename.charAt(0).toUpperCase() + filename.slice(1)} Rules
+
+Add your rules here.
+`;
+}
+async function addCommand(filename) {
+  try {
+    const config = getDefaultConfig();
+    const sanitizedFilename = sanitizeFilename(filename);
+    const rulesDir = config.aiRulesDir;
+    const filePath = import_node_path.default.join(rulesDir, `${sanitizedFilename}.md`);
+    await (0, import_promises.mkdir)(rulesDir, { recursive: true });
+    const template = generateRuleTemplate(sanitizedFilename);
+    await (0, import_promises.writeFile)(filePath, template, "utf8");
+    console.log(`\u2705 Created rule file: ${filePath}`);
+    console.log(`\u{1F4DD} Edit the file to customize your rules.`);
+  } catch (error) {
+    console.error(
+      `\u274C Failed to create rule file: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(3);
+  }
+}
+
 // src/generators/claude.ts
-var import_node_path = require("path");
+var import_node_path2 = require("path");
 async function generateClaudeConfig(rules, config) {
   const outputs = [];
   const rootRules = rules.filter((r) => r.frontmatter.root === true);
@@ -35,14 +97,14 @@ async function generateClaudeConfig(rules, config) {
   const claudeMdContent = generateClaudeMarkdown(rootRules, detailRules);
   outputs.push({
     tool: "claude",
-    filepath: (0, import_node_path.join)(config.outputPaths.claude, "CLAUDE.md"),
+    filepath: (0, import_node_path2.join)(config.outputPaths.claude, "CLAUDE.md"),
     content: claudeMdContent
   });
   for (const rule of detailRules) {
     const memoryContent = generateMemoryFile(rule);
     outputs.push({
       tool: "claude",
-      filepath: (0, import_node_path.join)(config.outputPaths.claude, ".claude", "memories", `${rule.filename}.md`),
+      filepath: (0, import_node_path2.join)(config.outputPaths.claude, ".claude", "memories", `${rule.filename}.md`),
       content: memoryContent
     });
   }
@@ -84,12 +146,12 @@ function generateMemoryFile(rule) {
 }
 
 // src/generators/cline.ts
-var import_node_path2 = require("path");
+var import_node_path3 = require("path");
 async function generateClineConfig(rules, config) {
   const outputs = [];
   for (const rule of rules) {
     const content = generateClineMarkdown(rule);
-    const filepath = (0, import_node_path2.join)(config.outputPaths.cline, `${rule.filename}.md`);
+    const filepath = (0, import_node_path3.join)(config.outputPaths.cline, `${rule.filename}.md`);
     outputs.push({
       tool: "cline",
       filepath,
@@ -103,13 +165,13 @@ function generateClineMarkdown(rule) {
 }
 
 // src/generators/copilot.ts
-var import_node_path3 = require("path");
+var import_node_path4 = require("path");
 async function generateCopilotConfig(rules, config) {
   const outputs = [];
   for (const rule of rules) {
     const content = generateCopilotMarkdown(rule);
     const baseFilename = rule.filename.replace(/\.md$/, "");
-    const filepath = (0, import_node_path3.join)(config.outputPaths.copilot, `${baseFilename}.instructions.md`);
+    const filepath = (0, import_node_path4.join)(config.outputPaths.copilot, `${baseFilename}.instructions.md`);
     outputs.push({
       tool: "copilot",
       filepath,
@@ -133,12 +195,12 @@ function generateCopilotMarkdown(rule) {
 }
 
 // src/generators/cursor.ts
-var import_node_path4 = require("path");
+var import_node_path5 = require("path");
 async function generateCursorConfig(rules, config) {
   const outputs = [];
   for (const rule of rules) {
     const content = generateCursorMarkdown(rule);
-    const filepath = (0, import_node_path4.join)(config.outputPaths.cursor, `${rule.filename}.mdc`);
+    const filepath = (0, import_node_path5.join)(config.outputPaths.cursor, `${rule.filename}.mdc`);
     outputs.push({
       tool: "cursor",
       filepath,
@@ -169,12 +231,12 @@ function generateCursorMarkdown(rule) {
 }
 
 // src/generators/roo.ts
-var import_node_path5 = require("path");
+var import_node_path6 = require("path");
 async function generateRooConfig(rules, config) {
   const outputs = [];
   for (const rule of rules) {
     const content = generateRooMarkdown(rule);
-    const filepath = (0, import_node_path5.join)(config.outputPaths.roo, `${rule.filename}.md`);
+    const filepath = (0, import_node_path6.join)(config.outputPaths.roo, `${rule.filename}.md`);
     outputs.push({
       tool: "roo",
       filepath,
@@ -187,56 +249,34 @@ function generateRooMarkdown(rule) {
   return rule.content.trim();
 }
 
-// src/utils/config.ts
-function getDefaultConfig() {
-  return {
-    aiRulesDir: ".rulesync",
-    outputPaths: {
-      copilot: ".github/instructions",
-      cursor: ".cursor/rules",
-      cline: ".clinerules",
-      claude: ".",
-      roo: ".roo/rules"
-    },
-    watchEnabled: false,
-    defaultTargets: ["copilot", "cursor", "cline", "claude", "roo"]
-  };
-}
-function resolveTargets(targets, config) {
-  if (targets.includes("*")) {
-    return config.defaultTargets;
-  }
-  return targets;
-}
-
 // src/utils/file.ts
-var import_promises = require("fs/promises");
-var import_node_path6 = require("path");
+var import_promises2 = require("fs/promises");
+var import_node_path7 = require("path");
 async function ensureDir(dirPath) {
   try {
-    await (0, import_promises.stat)(dirPath);
+    await (0, import_promises2.stat)(dirPath);
   } catch {
-    await (0, import_promises.mkdir)(dirPath, { recursive: true });
+    await (0, import_promises2.mkdir)(dirPath, { recursive: true });
   }
 }
 async function readFileContent(filepath) {
-  return (0, import_promises.readFile)(filepath, "utf-8");
+  return (0, import_promises2.readFile)(filepath, "utf-8");
 }
 async function writeFileContent(filepath, content) {
-  await ensureDir((0, import_node_path6.dirname)(filepath));
-  await (0, import_promises.writeFile)(filepath, content, "utf-8");
+  await ensureDir((0, import_node_path7.dirname)(filepath));
+  await (0, import_promises2.writeFile)(filepath, content, "utf-8");
 }
 async function findFiles(dir, extension = ".md") {
   try {
-    const files = await (0, import_promises.readdir)(dir);
-    return files.filter((file) => file.endsWith(extension)).map((file) => (0, import_node_path6.join)(dir, file));
+    const files = await (0, import_promises2.readdir)(dir);
+    return files.filter((file) => file.endsWith(extension)).map((file) => (0, import_node_path7.join)(dir, file));
   } catch {
     return [];
   }
 }
 async function fileExists(filepath) {
   try {
-    await (0, import_promises.stat)(filepath);
+    await (0, import_promises2.stat)(filepath);
     return true;
   } catch {
     return false;
@@ -250,7 +290,7 @@ async function removeDirectory(dirPath) {
   }
   try {
     if (await fileExists(dirPath)) {
-      await (0, import_promises.rm)(dirPath, { recursive: true, force: true });
+      await (0, import_promises2.rm)(dirPath, { recursive: true, force: true });
     }
   } catch (error) {
     console.warn(`Failed to remove directory ${dirPath}:`, error);
@@ -259,7 +299,7 @@ async function removeDirectory(dirPath) {
 async function removeFile(filepath) {
   try {
     if (await fileExists(filepath)) {
-      await (0, import_promises.rm)(filepath);
+      await (0, import_promises2.rm)(filepath);
     }
   } catch (error) {
     console.warn(`Failed to remove file ${filepath}:`, error);
@@ -318,7 +358,7 @@ async function generateForTool(tool, rules, config) {
 }
 
 // src/core/parser.ts
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
 var import_gray_matter = __toESM(require("gray-matter"));
 async function parseRulesFromDirectory(aiRulesDir) {
   const ruleFiles = await findFiles(aiRulesDir);
@@ -338,7 +378,7 @@ async function parseRuleFile(filepath) {
   const parsed = (0, import_gray_matter.default)(content);
   validateFrontmatter(parsed.data, filepath);
   const frontmatter = parsed.data;
-  const filename = (0, import_node_path7.basename)(filepath, ".md");
+  const filename = (0, import_node_path8.basename)(filepath, ".md");
   return {
     frontmatter,
     content: parsed.content,
@@ -497,9 +537,9 @@ async function generateCommand(options = {}) {
 
 // src/cli/commands/gitignore.ts
 var import_node_fs = require("fs");
-var import_node_path8 = require("path");
+var import_node_path9 = require("path");
 var gitignoreCommand = async () => {
-  const gitignorePath = (0, import_node_path8.join)(process.cwd(), ".gitignore");
+  const gitignorePath = (0, import_node_path9.join)(process.cwd(), ".gitignore");
   const rulesFilesToIgnore = [
     "# Generated by rulesync - AI tool configuration files",
     ".github/copilot-instructions.md",
@@ -539,7 +579,7 @@ ${linesToAdd.join("\n")}
 };
 
 // src/cli/commands/init.ts
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 async function initCommand() {
   const aiRulesDir = ".rulesync";
   console.log("Initializing rulesync...");
@@ -629,7 +669,7 @@ globs: ["src/**/*.ts"]
     }
   ];
   for (const file of sampleFiles) {
-    const filepath = (0, import_node_path9.join)(aiRulesDir, file.filename);
+    const filepath = (0, import_node_path10.join)(aiRulesDir, file.filename);
     if (!await fileExists(filepath)) {
       await writeFileContent(filepath, file.content);
       console.log(`Created ${filepath}`);
@@ -740,11 +780,11 @@ async function watchCommand() {
     persistent: true
   });
   let isGenerating = false;
-  const handleChange = async (path) => {
+  const handleChange = async (path2) => {
     if (isGenerating) return;
     isGenerating = true;
     console.log(`
-\u{1F4DD} Detected change in ${path}`);
+\u{1F4DD} Detected change in ${path2}`);
     try {
       await generateCommand({ verbose: false });
       console.log("\u2705 Regenerated configuration files");
@@ -754,10 +794,10 @@ async function watchCommand() {
       isGenerating = false;
     }
   };
-  watcher.on("change", handleChange).on("add", handleChange).on("unlink", (path) => {
+  watcher.on("change", handleChange).on("add", handleChange).on("unlink", (path2) => {
     console.log(`
-\u{1F5D1}\uFE0F  Removed ${path}`);
-    handleChange(path);
+\u{1F5D1}\uFE0F  Removed ${path2}`);
+    handleChange(path2);
   }).on("error", (error) => {
     console.error("\u274C Watcher error:", error);
   });
@@ -772,6 +812,7 @@ async function watchCommand() {
 var program = new import_commander.Command();
 program.name("rulesync").description("Unified AI rules management CLI tool").version("0.1.0");
 program.command("init").description("Initialize rulesync in current directory").action(initCommand);
+program.command("add <filename>").description("Add a new rule file").action(addCommand);
 program.command("gitignore").description("Add generated files to .gitignore").action(gitignoreCommand);
 program.command("generate").description("Generate configuration files for AI tools").option("--copilot", "Generate only for GitHub Copilot").option("--cursor", "Generate only for Cursor").option("--cline", "Generate only for Cline").option("--claude", "Generate only for Claude Code").option("--delete", "Delete all existing files in output directories before generating").option("-v, --verbose", "Verbose output").action(async (options) => {
   const tools = [];

package/dist/index.mjs

@@ -3,6 +3,68 @@
 // src/cli/index.ts
 import { Command } from "commander";
 
+// src/cli/commands/add.ts
+import { mkdir, writeFile } from "fs/promises";
+import path from "path";
+
+// src/utils/config.ts
+function getDefaultConfig() {
+  return {
+    aiRulesDir: ".rulesync",
+    outputPaths: {
+      copilot: ".github/instructions",
+      cursor: ".cursor/rules",
+      cline: ".clinerules",
+      claude: ".",
+      roo: ".roo/rules"
+    },
+    watchEnabled: false,
+    defaultTargets: ["copilot", "cursor", "cline", "claude", "roo"]
+  };
+}
+function resolveTargets(targets, config) {
+  if (targets.includes("*")) {
+    return config.defaultTargets;
+  }
+  return targets;
+}
+
+// src/cli/commands/add.ts
+function sanitizeFilename(filename) {
+  return filename.endsWith(".md") ? filename.slice(0, -3) : filename;
+}
+function generateRuleTemplate(filename) {
+  return `---
+root: false
+targets: ["*"]
+description: "Rules for ${filename}"
+globs: []
+---
+
+# ${filename.charAt(0).toUpperCase() + filename.slice(1)} Rules
+
+Add your rules here.
+`;
+}
+async function addCommand(filename) {
+  try {
+    const config = getDefaultConfig();
+    const sanitizedFilename = sanitizeFilename(filename);
+    const rulesDir = config.aiRulesDir;
+    const filePath = path.join(rulesDir, `${sanitizedFilename}.md`);
+    await mkdir(rulesDir, { recursive: true });
+    const template = generateRuleTemplate(sanitizedFilename);
+    await writeFile(filePath, template, "utf8");
+    console.log(`\u2705 Created rule file: ${filePath}`);
+    console.log(`\u{1F4DD} Edit the file to customize your rules.`);
+  } catch (error) {
+    console.error(
+      `\u274C Failed to create rule file: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(3);
+  }
+}
+
 // src/generators/claude.ts
 import { join } from "path";
 async function generateClaudeConfig(rules, config) {
@@ -164,36 +226,14 @@ function generateRooMarkdown(rule) {
   return rule.content.trim();
 }
 
-// src/utils/config.ts
-function getDefaultConfig() {
-  return {
-    aiRulesDir: ".rulesync",
-    outputPaths: {
-      copilot: ".github/instructions",
-      cursor: ".cursor/rules",
-      cline: ".clinerules",
-      claude: ".",
-      roo: ".roo/rules"
-    },
-    watchEnabled: false,
-    defaultTargets: ["copilot", "cursor", "cline", "claude", "roo"]
-  };
-}
-function resolveTargets(targets, config) {
-  if (targets.includes("*")) {
-    return config.defaultTargets;
-  }
-  return targets;
-}
-
 // src/utils/file.ts
-import { mkdir, readdir, readFile, rm, stat, writeFile } from "fs/promises";
+import { mkdir as mkdir2, readdir, readFile, rm, stat, writeFile as writeFile2 } from "fs/promises";
 import { dirname, join as join6 } from "path";
 async function ensureDir(dirPath) {
   try {
     await stat(dirPath);
   } catch {
-    await mkdir(dirPath, { recursive: true });
+    await mkdir2(dirPath, { recursive: true });
   }
 }
 async function readFileContent(filepath) {
@@ -201,7 +241,7 @@ async function readFileContent(filepath) {
 }
 async function writeFileContent(filepath, content) {
   await ensureDir(dirname(filepath));
-  await writeFile(filepath, content, "utf-8");
+  await writeFile2(filepath, content, "utf-8");
 }
 async function findFiles(dir, extension = ".md") {
   try {
@@ -717,11 +757,11 @@ async function watchCommand() {
     persistent: true
   });
   let isGenerating = false;
-  const handleChange = async (path) => {
+  const handleChange = async (path2) => {
     if (isGenerating) return;
     isGenerating = true;
     console.log(`
-\u{1F4DD} Detected change in ${path}`);
+\u{1F4DD} Detected change in ${path2}`);
     try {
       await generateCommand({ verbose: false });
       console.log("\u2705 Regenerated configuration files");
@@ -731,10 +771,10 @@ async function watchCommand() {
       isGenerating = false;
     }
   };
-  watcher.on("change", handleChange).on("add", handleChange).on("unlink", (path) => {
+  watcher.on("change", handleChange).on("add", handleChange).on("unlink", (path2) => {
     console.log(`
-\u{1F5D1}\uFE0F  Removed ${path}`);
-    handleChange(path);
+\u{1F5D1}\uFE0F  Removed ${path2}`);
+    handleChange(path2);
   }).on("error", (error) => {
     console.error("\u274C Watcher error:", error);
   });
@@ -749,6 +789,7 @@ async function watchCommand() {
 var program = new Command();
 program.name("rulesync").description("Unified AI rules management CLI tool").version("0.1.0");
 program.command("init").description("Initialize rulesync in current directory").action(initCommand);
+program.command("add <filename>").description("Add a new rule file").action(addCommand);
 program.command("gitignore").description("Add generated files to .gitignore").action(gitignoreCommand);
 program.command("generate").description("Generate configuration files for AI tools").option("--copilot", "Generate only for GitHub Copilot").option("--cursor", "Generate only for Cursor").option("--cline", "Generate only for Cline").option("--claude", "Generate only for Claude Code").option("--delete", "Delete all existing files in output directories before generating").option("-v, --verbose", "Verbose output").action(async (options) => {
   const tools = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",