@aramassa/ai-rules 0.1.1-npmjs.20250910072942

package/artifact/instructions/rules/documentation/github-protection.md

@@ -0,0 +1,122 @@
+---
+type: documentation
+category: github-protection
+focus: file-protection
+applyTo: "**/*"
+human-instruction: |-
+  ## .github ディレクトリの編集について
+
+  このルールは、AIエージェントが .github ディレクトリ下のファイルを編集することを禁止するものです。
+  これらのファイルは人間が慎重に設計したAI向けの指示や設定が含まれており、
+  個別の案件で「ついで」に修正すると、その後のAIコーディング品質に予期しない影響を与える可能性があります。
+
+  人間の開発者の方へ：
+  - .github ディレクトリの変更は慎重に検討してください
+  - 変更が必要な場合は、その影響範囲を十分に検討してください
+  - AIコーディング品質への影響を評価してください
+---
+
+# GitHub Directory Protection Rules
+
+## 概要
+
+`.github` ディレクトリ下にあるファイルは、AI エージェントによる編集を**禁止**します。これらのファイルには AI 向けの指示や設定が含まれており、安易な編集は AI コーディング品質に重大な影響を与える可能性があります。
+
+## 基本ルール
+
+### 編集禁止の対象
+
+以下のファイル・ディレクトリは AI エージェントによる編集を**絶対に**禁止します：
+
+- `.github/instructions/` - AI向けの指示ファイル
+- `.github/copilot-instructions.md` - GitHub Copilot向けの指示
+- `.github/workflows/` - CI/CD ワークフロー設定
+- `.github/ISSUE_TEMPLATE/` - Issue テンプレート
+- `.github/PULL_REQUEST_TEMPLATE.md` - PR テンプレート
+- その他 `.github/` 下のすべてのファイル
+
+### 厳格な禁止事項
+
+1. **ファイルの編集**: 内容の変更、追記、削除は一切禁止
+2. **ファイルの削除**: ファイル全体の削除は**特に厳禁**
+3. **ファイルの作成**: 新規ファイルの作成も原則禁止
+4. **ディレクトリの変更**: ディレクトリ構造の変更も禁止
+
+## 理由・背景
+
+### AI コーディング品質への影響
+
+- `.github` 下のファイルは AI エージェントの動作を制御する重要な設定
+- 人間が慎重に検討して作成された指示やルールが含まれている
+- 無断で変更すると、その後のすべての AI コーディング作業に影響が波及する
+
+### 管理の一元化
+
+- AI コーディング品質は厳格にコントロールする必要がある
+- 個別の案件で「ついで」のように修正してはいけない
+- 変更は専用のタスクとして、慎重に検討して実施する
+
+## 実装ガイドライン
+
+### PR での確認事項
+
+1. **差分チェック**: PR に `.github/` 下のファイル変更が含まれていないことを確認
+2. **意図確認**: もし変更が含まれている場合は、その必要性を厳格に検証
+3. **影響評価**: 変更による AI コーディング品質への影響を評価
+
+### 例外的な編集が必要な場合
+
+明確に編集が必要な状況でない限り、以下のルールに従う：
+
+1. **事前相談**: 人間の開発者に編集の必要性を相談する
+2. **影響範囲の確認**: 変更がもたらす影響を十分に検討する
+3. **最小限の変更**: 必要最小限の変更に留める
+4. **詳細な説明**: 変更理由と影響を詳細に文書化する
+
+## 違反例と対応
+
+### ❌ 悪い例
+
+```
+# 個別機能実装時に「ついで」で .github ファイルを修正
+- feature: Add new API endpoint
+- fix: Update CI workflow (← これは禁止)
+- docs: Fix typo in copilot-instructions.md (← これも禁止)
+```
+
+### ✅ 良い例
+
+```
+# .github ファイルの変更は避ける
+- feature: Add new API endpoint
+- test: Add tests for new API endpoint
+- docs: Update README with API usage
+```
+
+### 緊急時の対応
+
+もし誤って `.github` ファイルを変更してしまった場合：
+
+1. **即座に復元**: `git checkout HEAD~1 .github/` で変更前の状態に戻す
+2. **変更内容の確認**: 何が変更されたかを確認する
+3. **影響評価**: 変更による影響がないか確認する
+4. **報告**: 人間の開発者に状況を報告する
+
+## 運用における注意点
+
+### AI エージェント開発者向け
+
+- このルールは AI エージェントの品質保証のために設けられている
+- `.github` ディレクトリへの変更は、専用のタスクとして別途検討する
+- 不明な点がある場合は、必ず人間の開発者に確認を取る
+
+### 人間の開発者向け
+
+- `.github` ディレクトリの変更は慎重に行う
+- 変更時は、AI コーディング品質への影響を十分に検討する
+- 必要に応じて、このルールファイル自体も更新する
+
+## 関連ドキュメント
+
+- [GitHub Issue Template Rules](github.md) - Issue テンプレートの使用方法
+- [Documentation Guidelines](common.md) - ドキュメント作成の基本方針

package/artifact/instructions/rules/test/e2e-bdd.md

@@ -0,0 +1,31 @@
+---
+type: test
+framework: bdd
+---
+
+## E2E BDD テストの目的
+
+E2E BDD (Behavior-Driven Development) テストは、システム全体の動作をユーザー視点で検証することを目的としています。これにより、要件が正しく実装されているか、ユーザーの期待に応える動作をしているかを確認します。
+
+## BDD 記述言語
+
+Gauge 記法を使用して、シナリオを自然言語で記述します。以下の要素を含めます。
+
+### シナリオ記述箇所
+
+/e2e/ ディレクトリに、各機能や要件ごとにサブディレクトリを作成し、その中にシナリオファイルを配置します。
+ファイル名は `機能名.gauge.md` とします。
+
+## テスト実行対象とツール
+
+### Web GUI アプリケーション
+
+### Web HTTP API
+
+### Web HTTP API (SSE)
+
+### CLI/TUI アプリケーション
+
+### MCPサーバ (STDOUT)
+
+### MCPサーバ (HTTP API)

package/artifact/instructions/rules/test/nodejs-test-restrictions.md

@@ -0,0 +1,101 @@
+---
+type: test
+category: restrictions
+focus: structure
+language: 
+  - typescript
+  - nodejs
+---
+
+# Node.js/TypeScript テストコード制限
+
+## 概要
+
+Node.js/TypeScript プロジェクトでスケルトン構造検証システムを使用する場合のテストコード制限事項です。
+
+## 制限事項
+
+### it.each の使用禁止
+
+**`it.each` は使用してはいけません**
+
+#### 理由
+
+- スケルトン構造検証システム（`test/skeleton-structure-validation.test.ts`）が正常に動作しなくなるため
+- `it.each` はテストケースを動的に生成するため、静的解析によるスケルトンファイル（`skel/test/`）との構造比較ができない
+- スケルトンファイルの構造同期が破綻し、CI/CD パイプラインでエラーが発生する
+
+#### 対象フレームワーク
+
+- Vitest
+- Jest
+- その他の `it.each` をサポートするテストフレームワーク
+
+#### 代替手段
+
+複数のテストケースが必要な場合は、個別の `it` ブロックを明示的に記述してください。
+
+```typescript
+// ❌ 禁止: it.each の使用
+it.each([
+  { input: 1, expected: 2 },
+  { input: 2, expected: 4 },
+  { input: 3, expected: 6 },
+])('should multiply by 2: $input -> $expected', ({ input, expected }) => {
+  expect(multiply(input, 2)).toBe(expected);
+});
+
+// ✅ 推奨: 個別の it ブロック
+describe('multiply function', () => {
+  it('should multiply 1 by 2 to get 2', () => {
+    expect(multiply(1, 2)).toBe(2);
+  });
+
+  it('should multiply 2 by 2 to get 4', () => {
+    expect(multiply(2, 2)).toBe(4);
+  });
+
+  it('should multiply 3 by 2 to get 6', () => {
+    expect(multiply(3, 2)).toBe(6);
+  });
+});
+```
+
+#### ヘルパー関数を使った構造化
+
+多くのテストケースが必要な場合は、ヘルパー関数を使用して構造化できます：
+
+```typescript
+// ✅ 推奨: ヘルパー関数を使った構造化
+describe('multiply function', () => {
+  const testCases = [
+    { input: 1, expected: 2 },
+    { input: 2, expected: 4 },
+    { input: 3, expected: 6 },
+  ];
+
+  // ヘルパー関数でテストケースを生成
+  const createMultiplyTest = (input: number, expected: number) => {
+    return () => {
+      expect(multiply(input, 2)).toBe(expected);
+    };
+  };
+
+  it('should multiply 1 by 2 to get 2', createMultiplyTest(1, 2));
+  it('should multiply 2 by 2 to get 4', createMultiplyTest(2, 4));
+  it('should multiply 3 by 2 to get 6', createMultiplyTest(3, 6));
+});
+```
+
+## 関連情報
+
+- [スケルトン構造管理ルール](../skel.md)
+- [Node.js コーディング規約](../coding/nodejs.md#テスト方針)
+
+## 影響範囲
+
+この制限は以下のプロジェクトに適用されます：
+
+- スケルトン構造検証システム（`test/skeleton-structure-validation.test.ts`）を使用するプロジェクト
+- `skel/test/` ディレクトリを持つプロジェクト
+- Node.js/TypeScript プロジェクト

package/artifact/instructions/rules/test/timeout-configuration-typescript.md

@@ -0,0 +1,67 @@
+---
+type: test
+category: configuration
+focus: timeout
+language: typescript
+---
+
+# TypeScript / Vitest でのテストタイムアウト設定
+
+## 概要
+
+TypeScript プロジェクトで Vitest を使用する際のテストタイムアウト設定に関する具体的なガイドラインです。
+
+## 推奨設定
+
+### デフォルトタイムアウト設定
+
+- **推奨値**: `vitest.config.ts` で `testTimeout: 20000` (20秒) を設定する
+- **理由**: Vitest のデフォルト 5000ms では、CLI テストやファイル I/O を伴うテストで失敗する可能性が高い
+
+### 個別テストでのタイムアウト上書き
+
+- **長時間テスト**: `{ timeout: 60000 }` オプションを使用してタイムアウトを上書きする
+- **対象**: Docker コンテナ起動、大きなファイル操作、外部 API 呼び出しなど
+
+### CI 環境での考慮事項
+
+- **タイムアウト値**: CI 環境では処理が遅くなる可能性を考慮し、本番環境より 1.5〜2 倍のタイムアウト値を設定する
+
+## 実装例
+
+### vitest.config.ts での設定
+
+```typescript
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    testTimeout: 20000, // デフォルト20秒
+    coverage: {
+      reporter: ["text", "json", "html"],
+    },
+  },
+});
+```
+
+### 個別テストでのタイムアウト上書き例
+
+```typescript
+describe("CLI テスト", () => {
+  it("should process large files", async () => {
+    // 長時間処理用に60秒に設定
+  }, { timeout: 60000 });
+
+  it("should start Docker container", async () => {
+    // Docker起動用に90秒に設定
+  }, { timeout: 90000 });
+});
+```
+
+## ベストプラクティス
+
+- **段階的な設定**: まずデフォルトタイムアウト（20秒）で実行し、必要に応じて個別テストで調整
+- **適切な値の選択**: 処理内容に応じた適切なタイムアウト値を設定（過度に長すぎない）
+- **CI 環境での検証**: CI 環境でも安定して動作することを確認

package/artifact/instructions/rules/test/timeout-configuration.md

@@ -0,0 +1,89 @@
+---
+type: test
+category: configuration
+focus: timeout
+---
+
+# テストタイムアウト設定に関する注意事項
+
+## 概要
+
+このドキュメントでは、テスト実行時のタイムアウト設定に関する重要な注意事項とガイドラインを記載します。適切なタイムアウト設定は、テストの安定性と実行時間のバランスを保つために不可欠です。
+
+## 基本原則
+
+### デフォルトタイムアウト設定
+
+- **推奨値**: テスト設定ファイルで `testTimeout: 20000` (20秒) を設定する
+- **理由**: 多くのテストフレームワークのデフォルト 5000ms では、CLI テストやファイル I/O を伴うテストで失敗する可能性が高い
+- **対象**: 一般的なユニットテスト、統合テスト、軽量なCLIテスト
+
+### 長時間テスト用の個別設定
+
+- **方法**: 個別テストで `{ timeout: 60000 }` オプションを使用してタイムアウトを上書きする
+- **対象例**:
+  - Docker コンテナ起動を伴うテスト
+  - 大きなファイル操作を伴うテスト
+  - 外部 API 呼び出しを伴うテスト
+  - ネットワーク I/O が発生するテスト
+
+### CI 環境での考慮事項
+
+- **タイムアウト値**: CI 環境では処理が遅くなる可能性を考慮し、本番環境より 1.5〜2 倍のタイムアウト値を設定する
+- **環境差**: CI 環境では CPU やディスク I/O が制限される場合があるため、余裕を持った設定が必要
+
+## 設定例
+
+### テスト設定ファイルの設定例
+
+テストフレームワークの設定ファイルで、デフォルトタイムアウト値を設定します：
+
+```
+testTimeout: 20000  // 20秒 - CLIテストやファイルI/O対応
+```
+
+### 個別テストでのタイムアウト上書き例
+
+特定のテストで長時間の処理が必要な場合は、個別にタイムアウト値を指定します：
+
+- **ファイル処理テスト**: 60秒のタイムアウト設定
+- **Docker操作テスト**: 90秒のタイムアウト設定
+- **外部API通信テスト**: 45秒のタイムアウト設定
+
+各テストフレームワークの仕様に従い、適切な方法でタイムアウト値を個別設定してください。
+
+## トラブルシューティング
+
+### よくあるタイムアウトエラー
+
+1. **CLIテストの失敗**: コマンド実行に時間がかかる場合
+   - 解決策: 個別テストのタイムアウト値を増加（30-60秒）
+
+2. **ファイルI/Oテストの失敗**: 大きなファイルの読み書きでタイムアウト
+   - 解決策: 処理時間に応じてタイムアウト値を調整（60-120秒）
+
+3. **Docker関連テストの失敗**: コンテナ起動に時間がかかる場合
+   - 解決策: Docker操作用に90秒以上のタイムアウトを設定
+
+### 設定時の注意点
+
+- **過度に長いタイムアウト**: テスト実行時間が長くなりすぎないよう、必要最小限の値を設定する
+- **短すぎるタイムアウト**: CI環境での実行を考慮し、十分な余裕を持たせる
+- **一貫性**: 同様の処理を行うテストでは、統一されたタイムアウト値を使用する
+
+## 運用指針
+
+### 新しいテスト作成時
+
+1. まずデフォルトタイムアウト（20秒）で実行してみる
+2. タイムアウトエラーが発生した場合、処理内容に応じて適切な値を設定
+3. CI 環境でも動作することを確認する
+
+### 既存テストの見直し
+
+1. タイムアウトエラーが頻発するテストを特定
+2. 処理内容を分析し、適切なタイムアウト値を設定
+3. 過度に長いタイムアウトが設定されているテストを見直し、最適化を検討
+
+この設定により、テストの安定性を保ちながら適切な実行時間を維持できます。
+

package/artifact/instructions/skel/typescript/tsconfig.build.json

@@ -0,0 +1,17 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "types": ["node"],
+    "module": "ESNext",
+    "target": "ES2020",
+    "moduleResolution": "Bundler"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["test/**/*", "src/**/*.test.ts", "src/**/*.spec.ts", "**/*.test.ts", "**/*.spec.ts"]
+}

package/artifact/instructions/skel/typescript/tsconfig.json

@@ -0,0 +1,117 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+    /* Language and Environment */
+    "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+    // "libReplacement": true,                           /* Enable lib replacement. */
+    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
+    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+    /* Modules */
+    "module": "NodeNext",                                /* Specify what module code is generated. */
+    "outDir": "dist",                                    /* Specify an output folder for all emitted files. */
+    "rootDir": ".",                                      /* Specify the root folder within your source files. */
+    "moduleResolution": "NodeNext",                     /* Specify how TypeScript looks up a file from a given module specifier. */
+    "resolveJsonModule": true,                          /* Enable importing .json files. */
+    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
+    // "rewriteRelativeImportExtensions": true,          /* Rewrite '.ts', '.tsx', '.mts', and '.cts' file extensions in relative import paths to their JavaScript equivalent in output files. */
+    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
+    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
+    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
+    // "noUncheckedSideEffectImports": true,             /* Check side effect imports. */
+    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+    /* Emit */
+    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    // "removeComments": true,                           /* Disable emitting comments. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+
+    /* Interop Constraints */
+    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
+    // "isolatedDeclarations": true,                     /* Require sufficient annotation on exports so other tools can trivially generate declaration files. */
+    // "erasableSyntaxOnly": true,                       /* Do not allow runtime constructs that are not part of ECMAScript. */
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
+
+    /* Type Checking */
+    "strict": true,                                      /* Enable all strict type-checking options. */
+    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "strictBuiltinIteratorReturn": true,              /* Built-in iterators are instantiated with a 'TReturn' type of 'undefined' instead of 'any'. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+    /* Completeness */
+    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+    "skipLibCheck": true                                 /* Skip type checking all .d.ts files. */
+  },
+  "include": ["src/**/*", "test/**/*"],
+  "ts-node": {
+    "esm": true
+  }
+}

package/artifact/instructions/skel/typescript/tsdoc.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+  "extends": []
+}

package/artifact/instructions/skel.md

@@ -0,0 +1,88 @@
+---
+type: skel
+---
+
+# skel/ ディレクトリの運用について
+
+- ロジックの修正を行う前に、skel/ ディレクトリにあるスケルトンファイルを更新する。
+  - スケルトンファイルは、実装の構造を定義するためのもので、実装内容は含まない。
+  - スケルトンファイルの更新は、実装の前に必ず行うこと。
+    - 呼び出し元のコメント修正なども忘れないこと
+  - スケルトンファイルの変更差分をpatch形式で取得して、`change_plans/` に記載すること。
+  - `test/skeleton-structure-validation.test.ts` だけを実行して、構造が一致していることを確認する。
+
+## スケルトン（skel/ ディレクトリ）運用ルール
+
+- `skel/` ディレクトリ（例: `skel/`, `test_skel/`
+  など）は、実装ファイルやテストファイルの「構造設計図」を管理するための専用ディレクトリです。
+- スケルトンファイルは、**本体のクラス・関数・メソッド・プロパティ構造と厳密に一致**させてください。
+  - メソッド名・引数・戻り値・順序・static/instance区別・プロパティ名なども完全一致が必須です。
+  - 余計な定義や重複定義が混入しないよう注意してください。
+- スケルトンは「実装詳細を含まず、構造のみ」を記述します。
+- コードやテストの追加・修正時は、**必ず skel/ 側も同時に更新**してください。
+- skel/ 側の構造は `test/skeleton-structure-validation.test.ts` で自動検証されます。
+  - 差分が検出された場合は、skel/ 側を本体に合わせて速やかに修正してください。
+- スケルトンの目的：
+  - 実装とテストの構造同期・設計意図の明示・自動検証による品質担保
+- 運用上の注意：
+  - skel/ 側の構造不一致はCIで検出されます。必ず全テスト合格状態を維持してください。
+  - スケルトンの自動生成・修正時は、不要な重複やゴミ定義が混入しないように注意してください。
+  - スケルトンの自動生成・修正時は、不要な重複やゴミ定義が混入しないように注意してください。
+
+---
+
+## @aramassa/skel-extractor の使い方
+
+### 概要
+
+`@aramassa/skel-extractor` は、TypeScript/JavaScript/Markdown などの実装ファイルやテストファイルから「構造情報（スケルトン）」を自動抽出・生成・比較できるCLI/ライブラリです。skel/ ディレクトリのスケルトンファイルを最新の実装構造に同期させる用途で利用します。
+
+### インストール
+
+```sh
+npm install --save-dev @aramassa/skel-extractor
+```
+
+### コマンド例
+
+> **注意**: npx で利用する場合は `npx @aramassa/skel-extractor@latest` の形式で実行してください。
+
+```sh
+# 既存ファイルを上書き
+npx @aramassa/skel-extractor@latest "docs/**/*.md" "test/**/*.ts" "src/**/*.ts" --output ./skel --force
+
+# 構造diff（./skel と src/ を比較）
+npx @aramassa/skel-extractor@latest --diff --skel-dir ./skel --impl-dir ./src
+```
+
+#### package.json スクリプト例
+
+```json
+{
+  "scripts": {
+    "skel:update": "skel-extractor \"src/**/*.ts\" \"test/**/*.test.ts\"",
+    "skel:diff": "skel-extractor --diff"
+  }
+}
+```
+
+### 生成例
+
+- TypeScript: クラス・関数・型定義・インポート/エクスポート宣言などの構造のみ抽出
+- テスト: describe/it 構造のみ抽出
+- Markdown: ヘッダー構造とHTMLコメントのみ抽出
+
+### 活用例
+
+- 実装と設計の構造同期・レビュー
+- テストカバレッジの構造検証
+- ドキュメントの構造可視化
+- テンプレートや雛形生成
+
+### 注意点
+
+- スケルトンファイルの自動生成・更新時は、不要な重複やゴミ定義が混入しないように注意してください。
+- 抽出後は `test/skeleton-structure-validation.test.ts` を実行し、構造の同期を必ず確認してください。
+- 詳細な使い方やカスタマイズは [公式リポジトリのREADME](https://www.npmjs.com/package/@aramassa/skel-extractor) も参照してください。
+
+---