@aramassa/ai-rules 0.8.1 → 0.9.2

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -9611,6 +9611,94 @@ const {
   Help,
 } = commander;
 
+var picocolors = {exports: {}};
+
+var hasRequiredPicocolors;
+
+function requirePicocolors () {
+	if (hasRequiredPicocolors) return picocolors.exports;
+	hasRequiredPicocolors = 1;
+	let p = process || {}, argv = p.argv || [], env = p.env || {};
+	let isColorSupported =
+		!(!!env.NO_COLOR || argv.includes("--no-color")) &&
+		(!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || ((p.stdout || {}).isTTY && env.TERM !== "dumb") || !!env.CI);
+
+	let formatter = (open, close, replace = open) =>
+		input => {
+			let string = "" + input, index = string.indexOf(close, open.length);
+			return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close
+		};
+
+	let replaceClose = (string, close, replace, index) => {
+		let result = "", cursor = 0;
+		do {
+			result += string.substring(cursor, index) + replace;
+			cursor = index + close.length;
+			index = string.indexOf(close, cursor);
+		} while (~index)
+		return result + string.substring(cursor)
+	};
+
+	let createColors = (enabled = isColorSupported) => {
+		let f = enabled ? formatter : () => String;
+		return {
+			isColorSupported: enabled,
+			reset: f("\x1b[0m", "\x1b[0m"),
+			bold: f("\x1b[1m", "\x1b[22m", "\x1b[22m\x1b[1m"),
+			dim: f("\x1b[2m", "\x1b[22m", "\x1b[22m\x1b[2m"),
+			italic: f("\x1b[3m", "\x1b[23m"),
+			underline: f("\x1b[4m", "\x1b[24m"),
+			inverse: f("\x1b[7m", "\x1b[27m"),
+			hidden: f("\x1b[8m", "\x1b[28m"),
+			strikethrough: f("\x1b[9m", "\x1b[29m"),
+
+			black: f("\x1b[30m", "\x1b[39m"),
+			red: f("\x1b[31m", "\x1b[39m"),
+			green: f("\x1b[32m", "\x1b[39m"),
+			yellow: f("\x1b[33m", "\x1b[39m"),
+			blue: f("\x1b[34m", "\x1b[39m"),
+			magenta: f("\x1b[35m", "\x1b[39m"),
+			cyan: f("\x1b[36m", "\x1b[39m"),
+			white: f("\x1b[37m", "\x1b[39m"),
+			gray: f("\x1b[90m", "\x1b[39m"),
+
+			bgBlack: f("\x1b[40m", "\x1b[49m"),
+			bgRed: f("\x1b[41m", "\x1b[49m"),
+			bgGreen: f("\x1b[42m", "\x1b[49m"),
+			bgYellow: f("\x1b[43m", "\x1b[49m"),
+			bgBlue: f("\x1b[44m", "\x1b[49m"),
+			bgMagenta: f("\x1b[45m", "\x1b[49m"),
+			bgCyan: f("\x1b[46m", "\x1b[49m"),
+			bgWhite: f("\x1b[47m", "\x1b[49m"),
+
+			blackBright: f("\x1b[90m", "\x1b[39m"),
+			redBright: f("\x1b[91m", "\x1b[39m"),
+			greenBright: f("\x1b[92m", "\x1b[39m"),
+			yellowBright: f("\x1b[93m", "\x1b[39m"),
+			blueBright: f("\x1b[94m", "\x1b[39m"),
+			magentaBright: f("\x1b[95m", "\x1b[39m"),
+			cyanBright: f("\x1b[96m", "\x1b[39m"),
+			whiteBright: f("\x1b[97m", "\x1b[39m"),
+
+			bgBlackBright: f("\x1b[100m", "\x1b[49m"),
+			bgRedBright: f("\x1b[101m", "\x1b[49m"),
+			bgGreenBright: f("\x1b[102m", "\x1b[49m"),
+			bgYellowBright: f("\x1b[103m", "\x1b[49m"),
+			bgBlueBright: f("\x1b[104m", "\x1b[49m"),
+			bgMagentaBright: f("\x1b[105m", "\x1b[49m"),
+			bgCyanBright: f("\x1b[106m", "\x1b[49m"),
+			bgWhiteBright: f("\x1b[107m", "\x1b[49m"),
+		}
+	};
+
+	picocolors.exports = createColors();
+	picocolors.exports.createColors = createColors;
+	return picocolors.exports;
+}
+
+var picocolorsExports = /*@__PURE__*/ requirePicocolors();
+var pc = /*@__PURE__*/getDefaultExportFromCjs(picocolorsExports);
+
 var WriteMode;
 (function (WriteMode) {
     WriteMode["APPEND"] = "append";
@@ -18427,8 +18515,9 @@ function setupProgram() {
     program
         .command("presets")
         .description("List available package presets")
-        .action(async () => {
-        await listPresets();
+        .option("-d, --detail", "Show detailed information about presets")
+        .action(async (options) => {
+        await listPresets(options.detail);
     });
     return program;
 }
@@ -18461,27 +18550,47 @@ async function findYamlFilesRecursively(dir, baseDir = dir) {
     return yamlFiles;
 }
 /**
- * Extracts description from a preset YAML file
- * Reads the top-level 'description' field from the preset
+ * Extracts description and recipe output files from a preset YAML file
  */
-async function extractPresetDescription(presetPath) {
+async function extractPresetInfo(presetPath) {
+    const result = {
+        description: undefined,
+        outputFiles: [],
+    };
     try {
         const content = await fs.readFile(presetPath, "utf-8");
         const data = YAML.parse(content);
-        // Return the description field if it exists
+        // Extract description field if it exists
         if (data?.description && typeof data.description === "string") {
-            return data.description.trim();
+            result.description = data.description.trim();
+        }
+        // Extract output files from recipe items
+        if (Array.isArray(data?.recipe)) {
+            for (const item of data.recipe) {
+                // Skip import items as they don't have output files directly
+                if (item.import) {
+                    continue;
+                }
+                // Extract 'out' field if present
+                if (item.out && typeof item.out === "string") {
+                    // Get just the filename from the path
+                    const filename = path.basename(item.out);
+                    if (!result.outputFiles.includes(filename)) {
+                        result.outputFiles.push(filename);
+                    }
+                }
+            }
         }
     }
     catch {
         // Ignore file reading or parsing errors
     }
-    return undefined;
+    return result;
 }
 /**
  * Lists available package presets with descriptions
  */
-async function listPresets() {
+async function listPresets(showDetail = false) {
     const packageRoot = findPackageRoot();
     const presetsDir = path.join(packageRoot, "presets");
     try {
@@ -18496,18 +18605,19 @@ async function listPresets() {
         for (const file of yamlFiles) {
             const presetName = file.replace(/\.(yaml|yml)$/, "");
             const presetPath = path.join(presetsDir, file);
-            const description = await extractPresetDescription(presetPath);
+            const presetInfo = await extractPresetInfo(presetPath);
+            // Print preset name in cyan color
             // eslint-disable-next-line no-console
-            console.log(`  :${presetName}`);
-            if (description) {
-                // Indent and wrap description text
+            console.log(pc.cyan(`  :${presetName}`));
+            if (presetInfo.description) {
+                // Indent and wrap description text in dim color
                 const maxWidth = 70;
-                const words = description.split(" ");
+                const words = presetInfo.description.split(" ");
                 let currentLine = "    ";
                 words.forEach((word) => {
                     if (currentLine.length + word.length + 1 > maxWidth) {
                         // eslint-disable-next-line no-console
-                        console.log(currentLine);
+                        console.log(pc.dim(currentLine));
                         currentLine = "    " + word;
                     }
                     else {
@@ -18516,11 +18626,19 @@ async function listPresets() {
                 });
                 if (currentLine.trim()) {
                     // eslint-disable-next-line no-console
-                    console.log(currentLine);
+                    console.log(pc.dim(currentLine));
                 }
-                // eslint-disable-next-line no-console
-                console.log("");
             }
+            // Show output files if --detail flag is provided
+            if (showDetail && presetInfo.outputFiles.length > 0) {
+                for (const outputFile of presetInfo.outputFiles) {
+                    // eslint-disable-next-line no-console
+                    console.log(pc.gray(`    → ${outputFile}`));
+                }
+            }
+            // Add blank line between presets
+            // eslint-disable-next-line no-console
+            console.log("");
         }
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramassa/ai-rules",
-  "version": "0.8.1",
+  "version": "0.9.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",
@@ -70,6 +70,7 @@
     "ajv-formats": "^3.0.1",
     "commander": "^14.0.0",
     "glob": "^11.0.3",
+    "picocolors": "^1.1.1",
     "yaml": "^2.8.0"
   }
 }

package/presets/README.md

@@ -4,14 +4,21 @@
 
 ## 利用可能なプリセット
 
-### `basic.yaml`
+### Core Presets
+
+#### `basic.yaml`
 
 すべてのプロジェクトタイプで共通して必要となる基本的なinstruction構成です。
 
 **含まれる内容:**
 
 - Communication Rules
-- Retrospective Instructions
+- Package Management Rules
+- CLI Environment File Support Guidelines
+- Git Branch Naming Rules
+- Task Retrospective
+- Skeleton Structure Management
+- Plan Folder Organization
 
 **使用方法:**
 
@@ -23,15 +30,21 @@ npx @aramassa/ai-rules extract --recipe presets/basic.yaml --src artifact/instru
 
 - すべてのプロジェクトタイプ（言語・環境に依存しない共通ルール）
 
-### `typescript.yaml`
+### Language-Specific Presets
+
+#### `typescript.yaml`
 
 TypeScriptプロジェクト向けの標準的なinstruction構成です。
 
 **含まれる内容:**
 
-- AI Document Generation
 - TypeScript Coding Rules
+- Node.js Coding Rules
 - TypeScript / Vitest
+- Node.js Test Restrictions
+- Test Timeout Configuration
+- Code Quality Tools
+- `:basic` と `:docs-ai` をインポート
 
 **使用方法:**
 
@@ -39,6 +52,32 @@ TypeScriptプロジェクト向けの標準的なinstruction構成です。
 npx @aramassa/ai-rules extract --recipe presets/typescript.yaml --src artifact/instructions
 ```
 
+**対象プロジェクト:**
+
+- TypeScript/Node.js プロジェクト
+- モダンな JavaScript/TypeScript 開発環境
+
+#### `python.yaml`
+
+Python プロジェクト向けの標準的な instruction 構成です。
+
+**含まれる内容:**
+
+- Python CLI Implementation Guidelines
+- Python Workspace Management (uv)
+- `:basic` と `:docs-ai` をインポート
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/python.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- Python CLI アプリケーション
+- Python ワークスペース管理 (uv使用)
+
 ### `infrastructure-ansible.yaml`
 
 インフラストラクチャ管理とAnsibleを使用したプロジェクト向けの設定です。
@@ -87,15 +126,78 @@ npx @aramassa/ai-rules extract --recipe presets/chrome-extension.yaml --src arti
 - Webブラウザの機能拡張・自動化プロジェクト
 - Service Worker、Content Scripts、Popup UIを含む複合アプリケーション
 
-### `chatmodes.yaml`
+### Monorepo Presets
+
+#### `monorepo/nodejs.yaml`
+
+Node.js モノレポ環境でのワークスペース管理ルールです。
+
+**含まれる内容:**
+
+- Node.js Workspace Management Rules
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/monorepo/nodejs.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- npm workspaces を使用するモノレポプロジェクト
+- パッケージ管理が複雑なプロジェクト
+
+#### `monorepo/typescript.yaml`
+
+TypeScript モノレポ環境での Project References 管理ルールです。
+
+**含まれる内容:**
+
+- TypeScript Workspace Management Rules
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/monorepo/typescript.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- TypeScript Project References を使用するモノレポ
+- 複数パッケージ間の型共有が必要なプロジェクト
+
+### Agent & Chatmode Presets
+
+#### `agents.yaml`
+
+GitHub Copilot custom agent 定義を統合するための設定です。
+
+**含まれる内容:**
+
+- Agent Creation Assistant
+- E2E Test Executor
+- Technical Writer
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/agents.yaml --src artifact/agents
+```
+
+**対象プロジェクト:**
+
+- GitHub Copilot を使用する開発プロジェクト
+- カスタム AI エージェントを活用したいプロジェクト
+
+#### `chatmodes.yaml`
 
 AI対話支援機能（chatmodes）をプロジェクトに統合するための設定です。
 
 **含まれる内容:**
 
-- Instruction Improve Chatmode - プロジェクト指示の改善支援
-- Planning Chatmode - todo_plans作成支援
-- Bug Reproduce Chatmode - GitHub Issue バグ再現・調査・修正提案支援
+- Instruction Improve Chatmode
+- Planning Chatmode
+- Bug Reproduce Chatmode
 
 **使用方法:**
 
@@ -109,20 +211,153 @@ npx @aramassa/ai-rules extract --recipe presets/chatmodes.yaml --src artifact/ch
 - 構造化されたプランニングプロセスが必要なプロジェクト
 - 継続的なinstruction改善を行うプロジェクト
 
-### `npm-publish.yaml`
+### Prompts Presets
+
+#### `prompts/prompt-creation.yaml`
+
+AI向けプロンプト作成のための包括的なルールとガイドラインです。
+
+**含まれる内容:**
+
+- Prompts 作成ルール
+- Recipe ファイル作成ルール
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/prompts/prompt-creation.yaml --src artifact/prompts
+```
+
+**対象プロジェクト:**
+
+- プロンプト工学を活用するプロジェクト
+- AI-rules 自体のメンテナンス
+
+#### `prompts/todo-planning.yaml`
+
+プロジェクトのTODO計画を管理するためのワークフローとガイドラインです。
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/prompts/todo-planning.yaml --src artifact/prompts
+```
+
+#### `prompts/plan-fix.yaml`
+
+VS Code Plan モードから Agent Coding への移行を自動化するワークフローです。
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/prompts/plan-fix.yaml --src artifact/prompts
+```
+
+### Documentation Presets
+
+#### `docs-ai.yaml`
+
+AI向けドキュメント生成のためのinstruction設定です。
+
+**含まれる内容:**
+
+- Documentation for AI
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/docs-ai.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- AI コーディングツールを活用するプロジェクト
+- docs-ai/ ディレクトリでドキュメント管理を行うプロジェクト
+
+### API-Specific Presets
+
+#### `openai.yaml`
+
+OpenAI API を使用するプロジェクト向けの instruction 構成です。
+
+**含まれる内容:**
+
+- OpenAI API Usage Guidelines
+- `:typescript` をインポート（TypeScript関連ルール含む）
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/openai.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- OpenAI API を使用するアプリケーション
+- AI 機能を統合するプロジェクト
+
+### Testing Presets
+
+#### `test-best-practices.yaml`
+
+プロジェクト横断的なテストのベストプラクティスと E2E テストガイドラインです。
+
+**含まれる内容:**
+
+- E2E Test BDD Guidelines
+- E2E CLI Execution Testing
+- Environment Independent Path Testing
+- GitHub Actions Testing Policy
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/test-best-practices.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- E2E テストを実装するプロジェクト
+- CLI ツールのテストが必要なプロジェクト
+- 環境非依存のテストを書くプロジェクト
+
+### Workflow & CI/CD Presets
+
+#### `github-workflow.yaml`
+
+GitHub ワークフローと Issue 管理に関する instruction 構成です。
+
+**含まれる内容:**
+
+- GitHub Issue Templates
+- Planning Workflow
+- GitHub Actions NPM Publish Troubleshooting
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/github-workflow.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- GitHub を使用した開発プロジェクト
+- Issue 駆動開発を行うプロジェクト
+- GitHub Actions での CI/CD を実装するプロジェクト
+
+#### `github-actions/npm-publish.yaml`
 
 npmパッケージのGitHub Actions公開ワークフローを実装するための設定です。
 
 **含まれる内容:**
 
-- npm Package Publishing Workflow Rules - GitHub PackagesとnpmjsへのDual Registry公開ワークフロー
-- Package Management Rules - パッケージ管理とビルドプロセス
-- Basic Communication Rules - 基本的なコミュニケーションルール
+- npm Package Publishing Workflow Rules
+- `:basic` をインポート
 
 **使用方法:**
 
 ```bash
-npx @aramassa/ai-rules extract --recipe presets/npm-publish.yaml --src artifact/instructions
+npx @aramassa/ai-rules extract --recipe presets/github-actions/npm-publish.yaml --src artifact/instructions
 ```
 
 **対象プロジェクト:**
@@ -130,7 +365,26 @@ npx @aramassa/ai-rules extract --recipe presets/npm-publish.yaml --src artifact/
 - npm パッケージを公開するプロジェクト
 - GitHub Packages と npmjs.org への Dual Registry 公開が必要なプロジェクト
 - GitHub Actions を使用した自動パッケージ公開を行うプロジェクト
-- セマンティックバージョニングとリリース管理が必要なプロジェクト
+
+#### `github-actions/test.yaml`
+
+GitHub Actions のテストワークフローを実装するための設定です。
+
+**含まれる内容:**
+
+- GitHub Actions Test Workflow Rules
+- `:basic` をインポート
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/github-actions/test.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- GitHub Actions でテストを実行するプロジェクト
+- Node.js プロジェクトの CI/CD パイプライン
 
 ## カスタムプリセットの作成
 

package/presets/agents.yaml

@@ -7,12 +7,14 @@ description: |
 recipe:
   - title: Agent Creation Assistant
     frontmatter:
+      "@name": true
       "@description": true
       "@tools": true
       "@target": true
     out: agent-creation.agent.md
+    type: agent
     filters:
-      name: agent-creation
+      name: AgentCreation
       target: github-copilot
 
   - title: E2E Test Executor
@@ -21,6 +23,7 @@ recipe:
       "@tools": true
       "@target": true
     out: e2e-test-executor.agent.md
+    type: agent
     filters:
       name: e2e-test-executor
       target: github-copilot
@@ -31,6 +34,7 @@ recipe:
       "@tools": true
       "@target": true
     out: technical-writer.agent.md
+    type: agent
     filters:
       name: TechnicalWriter
       target: github-copilot

package/presets/basic.yaml

@@ -14,3 +14,40 @@ recipe:
     out: ./.github/copilot-instructions.md
     mode: append
     type: package-management
+  - title: CLI Environment File Support Guidelines
+    frontmatter:
+      description: |
+        These rules are for implementing environment file support in CLI applications.
+      applyTo: "**/*"
+    out: ./.github/copilot-instructions.md
+    mode: append
+    type: development-rules
+    category: cli-design
+  - title: Git Branch Naming Rules
+    frontmatter:
+      description: |
+        These rules are for Git branch naming conventions and workflow management.
+    out: ./.github/copilot-instructions.md
+    mode: append
+    type: git-rules
+  - title: Task Retrospective
+    frontmatter:
+      description: |
+        Guidelines for reflecting on completed tasks and improving future work.
+    out: ./.github/copilot-instructions.md
+    mode: append
+    type: retrospective
+  - title: Skeleton Structure Management
+    frontmatter:
+      description: |
+        Rules for managing skeleton files in the skel/ directory.
+    out: ./.github/copilot-instructions.md
+    mode: append
+    type: skel
+  - title: Plan Folder Organization
+    frontmatter:
+      description: |
+        Guidelines for organizing todo_plans and change_plans directories.
+    out: ./.github/copilot-instructions.md
+    mode: append
+    type: tidying-up

package/presets/github-workflow.yaml

@@ -0,0 +1,36 @@
+description: GitHub ワークフローと Issue 管理に関する instruction 構成です。
+
+config:
+  baseDir: .github/instructions
+
+recipe:
+  - title: GitHub Issue Templates
+    frontmatter:
+      description: |
+        Guidelines for using GitHub Issue templates effectively.
+      applyTo: ".github/ISSUE_TEMPLATE/**/*"
+    out: github-workflow.instructions.md
+    type: development
+    category: github
+    focus: issue-templates
+  - title: Planning Workflow
+    frontmatter:
+      description: |
+        Comprehensive planning workflow from idea to implementation.
+        Covers issue creation, branch management, and agent coding integration.
+      applyTo: "**/*"
+    mode: append
+    out: github-workflow.instructions.md
+    type: development
+    category: workflow
+    focus: planning-and-issue-management
+  - title: GitHub Actions NPM Publish Troubleshooting
+    frontmatter:
+      description: |
+        Troubleshooting guide for GitHub Actions npm publish workflows.
+      applyTo: ".github/workflows/*.{yml,yaml}"
+    mode: append
+    out: github-workflow.instructions.md
+    type: development
+    category: cd
+    focus: npm-publish