@aramassa/ai-rules 0.2.2 → 0.3.2

package/artifact/chatmodes/Planning.md

@@ -35,6 +35,8 @@ tools:
 
 todo_plans作成を段階的に支援し、一貫性のあるプランニングプロセスを実現します。
 
+**重要**: このプランニングプロセス中は実際の実装作業を行わず、計画策定のみに集中してください。実装は計画完了後の別フェーズで行います。
+
 ## インタラクティブ・プランニングプロセス
 
 私と一緒に以下の4段階でプランを作成していきましょう。各段階で質問形式のガイダンスを提供し、漏れのない計画策定をサポートします。

package/artifact/prompts/ai-rules/for_recipe.md

@@ -44,10 +44,10 @@ AI-rules プロジェクトにおけるレシピファイル（recipe files）
 **基本構造の決定**
 ```yaml
 config:
-  baseDir: [ベースディレクトリ] # オプション
+  baseDir: [出力先ディレクトリ] # オプション - 出力ファイルの配置場所を指定
 recipe:
   - title: "[レシピアイテムのタイトル]"
-    out: "[出力ファイルパス]"
+    out: "[ファイル名のみ]"  # baseDirが設定されている場合はファイル名のみ推奨
     # フィルタリング条件
     # 出力設定
     # FrontMatter設定
@@ -60,6 +60,57 @@ recipe:
 - **output**: 出力先とモード設定
 - **frontmatter**: メタデータの管理
 
+### ファイル命名規則とbaseDir活用のベストプラクティス
+
+#### ファイル命名規則
+
+**拡張子ルール**
+- **instructionファイル**: `.instructions.md` 
+- **promptファイル**: `.prompt.md`
+- **一般的なドキュメント**: `.md`
+
+#### baseDir活用の正しい方法
+
+**✅ 推奨: baseDirを出力先ディレクトリに設定**
+```yaml
+config:
+  baseDir: .github/instructions  # 出力先ディレクトリを指定
+
+recipe:
+  - title: "TypeScript Guidelines"
+    out: "typescript-rules.instructions.md"  # ファイル名のみ
+    type: coding-rules
+    language: typescript
+```
+
+**❌ 避けるべき: baseDirをソースディレクトリに設定して複雑なパス指定**
+```yaml
+config:
+  baseDir: artifact/instructions  # ソースディレクトリ指定は混乱の原因
+
+recipe:
+  - title: "TypeScript Guidelines"
+    out: "./.github/instructions/typescript-rules.md"  # 複雑なパス指定
+    type: coding-rules
+```
+
+#### 出力パス設定のベストプラクティス
+
+**シンプルなパス管理**
+- `baseDir`: 出力先ディレクトリを指定
+- `out`: ファイル名のみ（拡張子含む）を指定
+- パスの複雑な指定は避ける
+
+**環境変数展開の活用**
+```yaml
+config:
+  baseDir: ~/.config/vscode-prompts  # チルダ展開や環境変数展開に対応
+
+recipe:
+  - title: "Custom Rules"
+    out: "custom-rules.instructions.md"
+```
+
 #### 手順3: フィルタリング条件の設定
 
 **標準フィルター**
@@ -86,8 +137,25 @@ filters:
 
 **出力ファイル設定**
 ```yaml
-out: "./path/to/output.md"     # 出力先パス（環境変数展開対応）
-mode: overwrite               # overwrite（デフォルト）、append、prepend
+out: "filename.instructions.md"  # ファイル名のみ（baseDirが設定されている場合）
+mode: overwrite                  # overwrite（デフォルト）、append、prepend
+```
+
+**パス指定のパターン**
+```yaml
+# パターン1: baseDir + ファイル名のみ（推奨）
+config:
+  baseDir: .github/instructions
+recipe:
+  - out: "typescript.instructions.md"
+
+# パターン2: 絶対パスまたは相対パス（baseDirを無視）
+recipe:
+  - out: "./docs/typescript.md"
+
+# パターン3: 環境変数展開
+recipe:
+  - out: "$HOME/.vscode/prompts/typescript.instructions.md"
 ```
 
 **複数アイテムでの同一ファイル出力**
@@ -145,11 +213,11 @@ recipe:
 # Generated by ai-rules prompt system
 
 config:
-  baseDir: [SOURCE_DIRECTORY]
+  baseDir: [OUTPUT_DIRECTORY]  # 出力先ディレクトリを指定
 
 recipe:
   - title: "[DOCUMENT_TITLE]"
-    out: "[OUTPUT_PATH]"
+    out: "[FILENAME].instructions.md"  # instructionファイルの場合
     type: [INSTRUCTION_TYPE]
     language: [TARGET_LANGUAGE]
     frontmatter:
@@ -200,6 +268,16 @@ recipe:
 - [ ] **フィルター整合性**: 指定したフィルターに対応するファイルが存在する
 - [ ] **パス有効性**: 出力先パスが適切で、ディレクトリが存在または作成可能
 
+#### ファイル出力の品質チェック
+
+- [ ] **baseDir設定**: 出力先ディレクトリが正しく設定されている
+- [ ] **出力パス**: outフィールドがファイル名のみになっている（baseDirを活用する場合）
+- [ ] **拡張子**: ファイルタイプに応じた適切な拡張子を使用
+  - instructionファイル: `.instructions.md`
+  - promptファイル: `.prompt.md`
+  - 一般ドキュメント: `.md`
+- [ ] **パス複雑性**: 不要な相対パス指定を避けている
+
 #### 機能性の検証
 
 - [ ] **フィルタリング**: 期待するファイル群が正しく抽出される
@@ -221,11 +299,11 @@ recipe:
 ```yaml
 # Basic project setup
 config:
-  baseDir: artifact/instructions
+  baseDir: .github/instructions  # 出力先ディレクトリ
 
 recipe:
   - title: "Project Guidelines"
-    out: "./.github/copilot-instructions.md"
+    out: "project-guidelines.instructions.md"  # ファイル名のみ
     type: planning
     frontmatter:
       description: "Basic project development guidelines"
@@ -236,12 +314,15 @@ recipe:
 
 ```yaml
 # TypeScript project comprehensive rules
+config:
+  baseDir: .github/instructions
+
 recipe:
   - import: :basic
   - import: :typescript
   
   - title: "Custom TypeScript Rules"
-    out: "./.github/instructions/custom-typescript.md"
+    out: "custom-typescript.instructions.md"  # ファイル名のみ
     type: coding-rules
     language: typescript
     filters:
@@ -258,21 +339,24 @@ recipe:
 
 ```yaml
 # Generate multiple specialized documents
+config:
+  baseDir: ./docs
+
 recipe:
   - title: "Development Guidelines"
-    out: "./docs/development.md"
+    out: "development.instructions.md"  # ファイル名のみ
     type: coding-rules
     filters:
       category: development
       
   - title: "Testing Guidelines"  
-    out: "./docs/testing.md"
+    out: "testing.instructions.md"  # ファイル名のみ
     type: test
     filters:
       category: best-practices
       
   - title: "Deployment Guidelines"
-    out: "./docs/deployment.md"
+    out: "deployment.instructions.md"  # ファイル名のみ
     filters:
       category: configuration
       focus: deployment
@@ -301,9 +385,13 @@ recipe:
 
 **フロントエンド中心**
 ```yaml
+config:
+  baseDir: .github/instructions
+
 recipe:
   - import: :typescript
   - title: "React Guidelines"
+    out: "react-guidelines.instructions.md"
     type: coding-rules
     language: [typescript, javascript]
     filters:
@@ -313,9 +401,13 @@ recipe:
 
 **バックエンド中心**
 ```yaml
+config:
+  baseDir: .github/instructions
+
 recipe:
   - import: :typescript
   - title: "API Development"
+    out: "api-development.instructions.md"
     type: coding-rules
     filters:
       category: backend
@@ -324,10 +416,14 @@ recipe:
 
 **フルスタック**
 ```yaml
+config:
+  baseDir: .github/instructions
+
 recipe:
   - import: :basic
   - import: :typescript
   - title: "Full Stack Guidelines"
+    out: "fullstack-guidelines.instructions.md"
     type: coding-rules
     filters:
       category: [frontend, backend]
@@ -335,6 +431,40 @@ recipe:
 
 ### トラブルシューティング
 
+#### baseDir設定に関する一般的な問題
+
+**問題1: 意図しない場所にファイルが出力される**
+```yaml
+# ❌ 問題のある例
+config:
+  baseDir: instructions  # ソースディレクトリを指定
+
+recipe:
+  - out: "./.github/instructions/file.md"  # 複雑なパス指定
+    # 結果: instructions/.github/instructions/file.md に出力
+```
+
+```yaml
+# ✅ 修正例
+config:
+  baseDir: .github/instructions  # 出力先ディレクトリを指定
+
+recipe:
+  - out: "file.instructions.md"  # ファイル名のみ
+    # 結果: .github/instructions/file.instructions.md に出力
+```
+
+**問題2: ファイル拡張子の規則が統一されていない**
+```yaml
+# ❌ 問題のある例
+recipe:
+  - out: "typescript-rules.md"  # instructionファイルなのに .md
+
+# ✅ 修正例  
+recipe:
+  - out: "typescript-rules.instructions.md"  # 正しい拡張子
+```
+
 #### 一般的な問題と解決法
 
 **フィルタリング結果が空**

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA0gBA;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBpG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAqjBA;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBpG"}

package/dist/cli.js

@@ -17683,9 +17683,6 @@ function requireDist () {
 var distExports = requireDist();
 var addFormats = /*@__PURE__*/getDefaultExportFromCjs(distExports);
 
-// Get the current file's directory for schema loading
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
 class RecipeValidator {
     constructor() {
         this.ajv = new Ajv({
@@ -17697,7 +17694,8 @@ class RecipeValidator {
     }
     async initialize() {
         try {
-            const schemaPath = path.join(__dirname, '../schemas/recipe.schema.json');
+            const packageRoot = this.findPackageRoot();
+            const schemaPath = path.join(packageRoot, 'schemas/recipe.schema.json');
             const schemaContent = await fs.readFile(schemaPath, 'utf-8');
             this.schema = JSON.parse(schemaContent);
             this.ajv.addSchema(this.schema, 'recipe');
@@ -17715,6 +17713,29 @@ class RecipeValidator {
             this.ajv.addSchema(this.schema, 'recipe');
         }
     }
+    /**
+     * Finds the package root directory by looking for package.json
+     */
+    findPackageRoot() {
+        // For ES modules, get current file path
+        const currentFile = fileURLToPath(import.meta.url);
+        let dir = path.dirname(currentFile);
+        // Walk up directory tree looking for package.json
+        while (dir !== path.dirname(dir)) {
+            const packageJsonPath = path.join(dir, 'package.json');
+            try {
+                // Use synchronous check since this is initialization
+                fsSync.accessSync(packageJsonPath);
+                return dir;
+            }
+            catch {
+                // Continue searching
+            }
+            dir = path.dirname(dir);
+        }
+        // Fallback to current working directory
+        return process.cwd();
+    }
     validateRecipe(recipeData) {
         const result = {
             isValid: true,
@@ -17954,6 +17975,16 @@ function resolveDefaultSrcDir(providedSrc) {
     const packageRoot = findPackageRoot();
     return path.join(packageRoot, 'artifact');
 }
+/**
+ * Resolves source directory for a recipe item following priority order:
+ * 1. CLI --src option (highest priority)
+ * 2. Recipe item src field (medium priority)
+ * 3. Import-level src field (medium priority)
+ * 4. Default package artifact/ directory (lowest priority)
+ */
+function resolveItemSrcDir(cliSrc, itemSrc, importSrc) {
+    return cliSrc || itemSrc || importSrc || resolveDefaultSrcDir();
+}
 /**
  * Resolves output path with baseDir support following priority order:
  * 1. CLI baseDir option (highest priority)
@@ -18103,24 +18134,51 @@ async function expandRecipeImports(items, currentPath, debugLogger, visited = ne
                     throw new Error(`Invalid imported recipe file '${importPath}': 'recipe' array not found`);
                 }
                 debugLogger?.log(`Import contains ${importData.recipe.length} items`);
-                // Check if this import item has an import-level baseDir
+                // Check if this import item has import-level configurations
                 const importLevelBaseDir = item.baseDir;
+                const importLevelSrc = item.src;
+                const importLevelVariables = item.variables;
                 if (importLevelBaseDir) {
                     debugLogger?.log(`Import has baseDir: ${importLevelBaseDir}`);
                 }
+                if (importLevelSrc) {
+                    debugLogger?.log(`Import has src: ${importLevelSrc}`);
+                }
+                if (importLevelVariables) {
+                    debugLogger?.log(`Import has variables:`, importLevelVariables);
+                }
                 // Recursively expand imports in the imported recipe
                 debugLogger?.time(`Expanding nested imports in: ${resolvedImportPath}`);
                 const expandedImported = await expandRecipeImports(importData.recipe, resolvedImportPath, debugLogger, newVisited, imported, depth + 1);
                 debugLogger?.timeEnd(`Expanding nested imports in: ${resolvedImportPath}`);
                 debugLogger?.log(`Nested expansion yielded ${expandedImported.length} items`);
-                // If import has baseDir, tag all expanded items with it
-                if (importLevelBaseDir) {
+                // Apply import-level configurations to all expanded items
+                if (importLevelBaseDir || importLevelSrc || importLevelVariables) {
                     expandedImported.forEach(expandedItem => {
-                        // Only set _importBaseDir if not already set (to preserve nested import baseDir priority)
-                        if (!expandedItem._importBaseDir) {
+                        // Apply baseDir if specified (only if not already set to preserve nested import priority)
+                        if (importLevelBaseDir && !expandedItem._importBaseDir) {
                             expandedItem._importBaseDir = importLevelBaseDir;
                             debugLogger?.log(`Tagged item '${expandedItem.title || expandedItem.out || 'untitled'}' with import baseDir: ${importLevelBaseDir}`);
                         }
+                        // Apply src if specified (only if not already set to preserve nested import priority)
+                        if (importLevelSrc && !expandedItem._importSrc) {
+                            expandedItem._importSrc = importLevelSrc;
+                            debugLogger?.log(`Tagged item '${expandedItem.title || expandedItem.out || 'untitled'}' with import src: ${importLevelSrc}`);
+                        }
+                        // Apply variables if specified (merge with existing variables, with import-level taking priority)
+                        if (importLevelVariables) {
+                            if (!expandedItem._importVariables) {
+                                expandedItem._importVariables = { ...importLevelVariables };
+                            }
+                            else {
+                                // Merge variables, with import-level taking priority over nested imports
+                                expandedItem._importVariables = {
+                                    ...expandedItem._importVariables,
+                                    ...importLevelVariables
+                                };
+                            }
+                            debugLogger?.log(`Tagged item '${expandedItem.title || expandedItem.out || 'untitled'}' with import variables:`, expandedItem._importVariables);
+                        }
                     });
                 }
                 // Add all expanded items from the import
@@ -18625,11 +18683,11 @@ async function handleExtractCommand(options) {
         await validateRecipeFilesExist(options.recipe);
         if (options.recipe.length === 1) {
             // Single recipe - maintain backward compatibility
-            await processRecipe(options.recipe[0], extractOptions, new ContentTracker(), debugLogger, options.baseDir, options.out);
+            await processRecipe(options.recipe[0], extractOptions, new ContentTracker(), debugLogger, options.baseDir, options.out, options.src);
         }
         else {
             // Multiple recipes - process in order with auto-append
-            await processMultipleRecipes(options.recipe, extractOptions, debugLogger, options.baseDir, options.out);
+            await processMultipleRecipes(options.recipe, extractOptions, debugLogger, options.baseDir, options.out, options.src);
         }
     }
     else {
@@ -18655,13 +18713,13 @@ async function handleStatsCommand(options) {
 /**
  * Processes multiple recipe files in the specified order
  */
-async function processMultipleRecipes(recipePaths, baseOptions, debugLogger, cliBaseDir, cliOutFile) {
+async function processMultipleRecipes(recipePaths, baseOptions, debugLogger, cliBaseDir, cliOutFile, cliSrc) {
     const contentTracker = new ContentTracker();
     debugLogger.log(`Processing ${recipePaths.length} recipes in order`);
     for (const recipePath of recipePaths) {
         try {
             debugLogger.log(`Starting processing of recipe: ${recipePath}`);
-            await processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile);
+            await processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile, cliSrc);
             debugLogger.log(`Completed processing of recipe: ${recipePath}`);
         }
         catch (error) {
@@ -18770,7 +18828,7 @@ async function processFrontmatterInheritance(frontmatter, srcDir, types, languag
 /**
  * Processes a recipe file with multiple extract operations
  */
-async function processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile) {
+async function processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile, cliSrc) {
     const resolvedPath = resolveRecipePath(recipePath);
     debugLogger?.log(`Processing recipe at path: ${resolvedPath}`);
     try {
@@ -18853,18 +18911,34 @@ async function processRecipe(recipePath, baseOptions, contentTracker, debugLogge
                 baseAttrFilters: attrFilters,
                 itemFilters: item.filters || 'none'
             });
-            // Resolve template variables for this item (merge CLI, recipe item, and base variables)
+            // Resolve template variables for this item (merge import variables, recipe item variables, and CLI variables)
             let itemVars = vars;
-            if (item.variables) {
+            if (item.variables || item._importVariables) {
                 const cliVariables = vars ? VariableResolver.parseCliVariables(vars) : {};
-                const mergedVariables = { ...item.variables, ...cliVariables };
+                const importVariables = item._importVariables || {};
+                const itemVariables = item.variables || {};
+                // Merge with priority: CLI > item > import
+                const mergedVariables = { ...importVariables, ...itemVariables, ...cliVariables };
                 itemVars = Object.entries(mergedVariables)
                     .map(([key, value]) => `${key}=${value}`)
                     .join(',');
-                debugLogger?.log(`Merged variables for item ${index + 1}:`, mergedVariables);
+                debugLogger?.log(`Merged variables for item ${index + 1}:`, {
+                    importVariables,
+                    itemVariables,
+                    cliVariables,
+                    merged: mergedVariables
+                });
             }
+            // Resolve source directory for this item with priority: CLI --src > item.src > import.src > default
+            const itemSrcDir = resolveItemSrcDir(cliSrc, item.src, item._importSrc);
+            debugLogger?.log(`Resolved source directory for item ${index + 1}:`, {
+                cliSrc,
+                itemSrc: item.src,
+                importSrc: item._importSrc,
+                resolved: itemSrcDir
+            });
             debugLogger?.time(`Content generation for item ${index + 1}`);
-            const filtered = await loadAndFilterFiles(srcDir, itemTypes, itemLanguages, combinedAttrFilters, debugLogger);
+            const filtered = await loadAndFilterFiles(itemSrcDir, itemTypes, itemLanguages, combinedAttrFilters, debugLogger);
             const merged = filtered.map((f) => f.content.trim()).join("\n\n");
             const contentWithTitle = itemTitle ? `# ${itemTitle}\n\n${merged}` : merged;
             debugLogger?.timeEnd(`Content generation for item ${index + 1}`);
@@ -18895,10 +18969,10 @@ async function processRecipe(recipePath, baseOptions, contentTracker, debugLogge
             }
             // Process frontmatter inheritance (@ syntax)
             debugLogger?.time(`Frontmatter inheritance processing for item ${index + 1}`);
-            const processedFrontmatter = await processFrontmatterInheritance(item.frontmatter, baseOptions.srcDir, itemTypes, itemLanguages, combinedAttrFilters, debugLogger);
+            const processedFrontmatter = await processFrontmatterInheritance(item.frontmatter, itemSrcDir, itemTypes, itemLanguages, combinedAttrFilters, debugLogger);
             debugLogger?.timeEnd(`Frontmatter inheritance processing for item ${index + 1}`);
             const options = {
-                srcDir: baseOptions.srcDir,
+                srcDir: itemSrcDir,
                 outFile: outputFile,
                 types: itemTypes,
                 languages: itemLanguages,

package/dist/recipeValidator.d.ts

@@ -8,6 +8,10 @@ export declare class RecipeValidator {
     private schema;
     constructor();
     initialize(): Promise<void>;
+    /**
+     * Finds the package root directory by looking for package.json
+     */
+    private findPackageRoot;
     validateRecipe(recipeData: any): ValidationResult;
     private formatSchemaError;
     private getHelpfulMessageForProperty;

package/dist/recipeValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipeValidator.d.ts","sourceRoot":"","sources":["../src/recipeValidator.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAM;;IAWd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,gBAAgB;IA0CjD,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,4BAA4B;IAYpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;CAyC5B;AAKD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMnE"}
+{"version":3,"file":"recipeValidator.d.ts","sourceRoot":"","sources":["../src/recipeValidator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAM;;IAWd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,gBAAgB;IA0CjD,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,4BAA4B;IAYpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;CAyC5B;AAKD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMnE"}

package/dist/recipeValidator.js

@@ -1,11 +1,9 @@
 import Ajv from 'ajv';
 import addFormats from 'ajv-formats';
 import fs from 'fs/promises';
+import fsSync from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-// Get the current file's directory for schema loading
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
 export class RecipeValidator {
     constructor() {
         this.ajv = new Ajv({
@@ -17,7 +15,8 @@ export class RecipeValidator {
     }
     async initialize() {
         try {
-            const schemaPath = path.join(__dirname, '../schemas/recipe.schema.json');
+            const packageRoot = this.findPackageRoot();
+            const schemaPath = path.join(packageRoot, 'schemas/recipe.schema.json');
             const schemaContent = await fs.readFile(schemaPath, 'utf-8');
             this.schema = JSON.parse(schemaContent);
             this.ajv.addSchema(this.schema, 'recipe');
@@ -35,6 +34,29 @@ export class RecipeValidator {
             this.ajv.addSchema(this.schema, 'recipe');
         }
     }
+    /**
+     * Finds the package root directory by looking for package.json
+     */
+    findPackageRoot() {
+        // For ES modules, get current file path
+        const currentFile = fileURLToPath(import.meta.url);
+        let dir = path.dirname(currentFile);
+        // Walk up directory tree looking for package.json
+        while (dir !== path.dirname(dir)) {
+            const packageJsonPath = path.join(dir, 'package.json');
+            try {
+                // Use synchronous check since this is initialization
+                fsSync.accessSync(packageJsonPath);
+                return dir;
+            }
+            catch {
+                // Continue searching
+            }
+            dir = path.dirname(dir);
+        }
+        // Fallback to current working directory
+        return process.cwd();
+    }
     validateRecipe(recipeData) {
         const result = {
             isValid: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramassa/ai-rules",
-  "version": "0.2.2",
+  "version": "0.3.2",
   "description": "This repository collects guidelines and instructions for developing AI agents. It contains documents covering communication rules, coding standards, testing strategies, and general operational practices.",
   "workspaces": [
     "packages/extract",