@knowledgine/cli 0.5.0 → 0.6.1

package/dist/templates/skills/knowledgine-debrief/references.ja.js

@@ -0,0 +1,141 @@
+export const REFERENCES = {
+    "debrief-template.md": `# デブリーフテンプレート
+
+セッションデブリーフのキャプチャを作成する際は、以下のテンプレートに記入してください。
+該当しないセクションは省略してください。
+
+---
+
+\`\`\`markdown
+## Session Debrief: <YYYY-MM-DD> — <主なトピック>
+
+### 概要
+<セッションの目標と結果を1〜2文で要約>
+
+### 解決した問題
+<!-- 重要な問題それぞれについて、根本原因と解決策を記載 -->
+- **<問題のタイトル>**
+  - Root cause: <原因>
+  - Solution: <対処内容>
+  - Files changed: <ファイルのリスト>
+
+### 行った判断
+<!-- アーキテクチャまたは実装上の判断とその理由を記載 -->
+- **<判断のタイトル>**
+  - Options considered: <A, B, C>
+  - Chosen: <選択肢>
+  - Reason: <理由>
+
+### 発見したパターン
+<!-- このセッションで発見した再利用可能な知見やパターン -->
+- **<パターン名>**: <簡単な説明といつ適用するか>
+
+### 変更したコード
+<!-- 何をなぜ変更したかの概要 -->
+| File | Change | Purpose |
+|------|--------|---------|
+| <path> | <created/modified/deleted> | <理由> |
+
+### 未解決の疑問
+<!-- 将来のセッションに向けた未解決の事項 -->
+- <疑問点または不確実な点>
+- <調査または判断が必要な事項>
+
+### 参照
+<!-- このセッションで参照した外部ソース -->
+- <URLまたはドキュメントタイトル>
+\`\`\`
+
+---
+
+## 使用上の注意
+
+**タイトルフォーマット**："Session Debrief: 2026-03-15 — Entity extraction pipeline fix"
+
+**タグ**：必ず \`debrief\` を含めること。主なトピック領域を追加する：
+- \`debrief\`, \`bug-fix\` — 主にバグ修正のセッション
+- \`debrief\`, \`design-decision\` — 設計が中心のセッション
+- \`debrief\`, \`refactoring\` — リファクタリング中心のセッション
+- \`debrief\`, \`feature\` — 新機能を追加したセッション
+
+**最小限のデブリーフ**：時間が少ない場合は、最低限以下を記録する：
+1. 何をしたか（タスクごとに1文）
+2. 重要な判断または落とし穴
+3. 未解決の疑問
+
+**個別キャプチャ**：重大なバグや判断については、先に個別のキャプチャを作成し
+（knowledgine-captureを使用）、デブリーフのサマリーでそれらを参照してください。
+これにより、個別の知見がデブリーフを通じてだけでなく、タイプ別にも検索可能になります。
+`,
+    "example-output.md": `# デブリーフ出力例
+
+適切に書かれたセッションデブリーフの具体的な例。
+
+---
+
+**タイトル**：Session Debrief: 2026-03-15 — ESM import resolution and sqlite-vec fix
+
+**タグ**：\`debrief\`, \`bug-fix\`
+
+**内容**：
+\`\`\`markdown
+## Session Debrief: 2026-03-15 — ESM import resolution and sqlite-vec fix
+
+### 概要
+Node.js 20へのアップグレードによって発生したビルド時の2つの障害を修正した。
+CLIソースファイルにESMインポートの拡張子が欠落していた問題と、
+sqlite-vecネイティブモジュールが新しいABI向けに再コンパイルが必要だった問題。
+
+### 解決した問題
+
+- **ESMインポートの.js拡張子が欠落**
+  - Root cause: TypeScriptソースが拡張子なしのインポート（例：\`import foo from "./foo"\`）を
+    使用していた。CommonJSでは動作するが、厳格なESMモード（Node 20 + type: "module"）では失敗する。
+  - Solution: packages/cli/src/ と packages/core/src/ のすべての相対インポートに
+    .js拡張子を追加した。tsconfig を moduleResolution: "NodeNext" に更新した。
+  - Files changed: cli と core パッケージにまたがる約40ファイル
+
+- **Node 20での sqlite-vec "invalid ELF header"**
+  - Root cause: ネイティブ .node バイナリが Node 18 ABI（NODE_MODULE_VERSION 108）向けに
+    コンパイルされていた。Node 20 は ABI 115 を使用する。
+  - Solution: \`npm rebuild\` を実行して sqlite-vec を Node 20 向けに再コンパイルした。
+    再発防止のために CI キャッシュキーに ABI バージョンチェックを追加した。
+  - Files changed: ソース変更なし。CIワークフローを更新した。
+
+### 行った判断
+
+- **moduleResolution: NodeNext を恒久的に維持する**
+  - Options: CommonJSに戻す、または NodeNext に更新する
+  - Chosen: NodeNext。ESMはNode.jsが向かっている方向であり、巻き戻すとさらに移行の負債が積み上がる。
+    .js拡張子の要件は一度限りのコストである。
+
+### 発見したパターン
+
+- **Node.jsメジャーアップグレード後の npm rebuild**：ネイティブモジュールを使用するプロジェクトは
+  Node.jsのメジャーバージョンアップグレード後に必ず \`npm rebuild\` を実行する必要がある。
+  アップグレードの手順書にこれを追加すること。
+  関連：個別キャプチャ "sqlite-vec fails after Node.js upgrade" も参照。
+
+### 変更したコード
+
+| File | Change | Purpose |
+|------|--------|---------|
+| packages/cli/src/**/*.ts | modified | すべての相対インポートに .js を追加 |
+| packages/core/src/**/*.ts | modified | すべての相対インポートに .js を追加 |
+| tsconfig.json | modified | moduleResolution: NodeNext |
+| .github/workflows/ci.yml | modified | キャッシュキーに NODE_ABI を追加 |
+
+### 未解決の疑問
+
+- .js拡張子を強制するコードモッドまたはlintルールはあるか？ESLint importプラグインが
+  対応している可能性がある——将来の利用に向けて調査が必要。
+- knowledgine initコマンドがABIの不一致をプロアクティブに検出すべきか？
+
+### 参照
+
+- https://www.typescriptlang.org/docs/handbook/esm-node.html
+- https://nodejs.org/api/esm.html#mandatory-file-extensions
+\`\`\`
+`,
+};
+//# sourceMappingURL=references.ja.js.map

package/dist/templates/skills/knowledgine-debrief/references.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmExB;IAEC,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEtB;CACA,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.d.ts

@@ -1,2 +1,2 @@
-export declare const SKILL_MD = "---\nname: knowledgine-debrief\ndescription: >\n  Summarize and record all learnings from the current session at its end. Invoke when\n  the user signals the session is complete, after finishing a major task, or when asked\n  for a session review. Produces a structured knowledge capture covering problems solved,\n  decisions made, patterns found, and open questions.\n---\n# knowledgine-debrief\n\n## Purpose\n\nConsolidate all learnings from the session into the knowledge base before context is\nlost. A debrief transforms the raw events of a session \u2014 bugs fixed, decisions made,\ncode changed \u2014 into durable structured knowledge that future sessions can build on.\n\n## When to Use\n\n- **End of session** \u2014 User says \"done\", \"that's all\", \"let's wrap up\", or similar\n- **After completing a major task** \u2014 Significant feature, complex bug fix, or refactoring\n- **User requests a review** \u2014 \"What did we do today?\", \"Summarize the session\"\n- **Before switching contexts** \u2014 Moving to a completely different area of the codebase\n\n## When NOT to Use\n\n- Mid-session after every small change \u2014 save debrief for meaningful milestones\n- When nothing significant happened (trivial edits only)\n\n## How to Debrief (MCP Tool)\n\nUse `capture_knowledge` to save the session summary:\n\n```\ncapture_knowledge(\n  content: string,    // Full structured debrief using the template\n  title: string,      // \"Session Debrief: <date> \u2014 <main topic>\"\n  tags: string[],     // [\"debrief\", \"<primary-area>\", ...]\n  source?: string     // Optional: session identifier\n)\n```\n\n## Step-by-Step Instructions\n\n1. **Recall the session** \u2014 Review what was worked on (rely on your context window)\n2. **Identify key events** \u2014 Problems solved, decisions made, patterns found\n3. **Draft the debrief** \u2014 Use the structured template from debrief-template.md\n4. **Capture each major learning individually** \u2014 If a bug fix or decision is significant\n   enough to stand alone, capture it separately with the appropriate skill first\n5. **Capture the session summary** \u2014 Save the consolidated debrief note\n6. **Confirm completion** \u2014 Report to the user what was captured\n\n## Debrief Structure\n\nA good debrief contains:\n\n- **Problems Solved** \u2014 What broke and how it was fixed\n- **Decisions Made** \u2014 What was chosen and why\n- **Patterns Found** \u2014 Reusable insights discovered\n- **Code Changed** \u2014 Summary of files modified and purpose\n- **Open Questions** \u2014 Unresolved items for future sessions\n\n## Best Practices\n\n- Write for a future reader with no context from this session\n- Be specific about what changed, not just what was done\n- Open questions are as valuable as answers \u2014 document uncertainty\n- If the session was long, do individual captures for major events before the summary\n\n## Reference Files\n\n- See `debrief-template.md` for the structured template to fill in\n- See `example-output.md` for a concrete example of a well-written debrief\n";
+export declare const SKILL_MD = "---\nname: knowledgine-debrief\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Summarize and record all learnings from the current session at its end. Invoke when\n  the user signals the session is complete, after finishing a major task, or when asked\n  for a session review. Produces a structured knowledge capture covering problems solved,\n  decisions made, patterns found, and open questions.\n---\n# knowledgine-debrief\n\n## Purpose\n\nConsolidate all learnings from the session into the knowledge base before context is\nlost. A debrief transforms the raw events of a session \u2014 bugs fixed, decisions made,\ncode changed \u2014 into durable structured knowledge that future sessions can build on.\n\n## When to Use\n\n- **End of session** \u2014 User says \"done\", \"that's all\", \"let's wrap up\", or similar\n- **After completing a major task** \u2014 Significant feature, complex bug fix, or refactoring\n- **User requests a review** \u2014 \"What did we do today?\", \"Summarize the session\"\n- **Before switching contexts** \u2014 Moving to a completely different area of the codebase\n\n## When NOT to Use\n\n- Mid-session after every small change \u2014 save debrief for meaningful milestones\n- When nothing significant happened (trivial edits only)\n\n## How to Debrief (MCP Tool)\n\nUse `capture_knowledge` to save the session summary:\n\n```\ncapture_knowledge(\n  content: string,    // Full structured debrief using the template\n  title?: string,     // \"Session Debrief: <date> \u2014 <main topic>\"\n  tags?: string[],    // [\"debrief\", \"<primary-area>\", ...]\n  source?: string     // Optional: session identifier\n)\n```\n\n## How to Debrief (CLI Alternative)\n\n```bash\nknowledgine capture add \"<debrief content>\" --title \"Session Debrief: <date>\" --tags \"debrief,<area>\"\n```\n\n## Step-by-Step Instructions\n\n1. **Recall the session** \u2014 Review what was worked on (rely on your context window)\n2. **Identify key events** \u2014 Problems solved, decisions made, patterns found\n3. **Draft the debrief** \u2014 Use the structured template from debrief-template.md\n4. **Capture each major learning individually** \u2014 If a bug fix or decision is significant\n   enough to stand alone, capture it separately with the appropriate skill first\n5. **Capture the session summary** \u2014 Save the consolidated debrief note\n6. **Confirm completion** \u2014 Report to the user what was captured\n\n## Debrief Structure\n\nA good debrief contains:\n\n- **Problems Solved** \u2014 What broke and how it was fixed\n- **Decisions Made** \u2014 What was chosen and why\n- **Patterns Found** \u2014 Reusable insights discovered\n- **Code Changed** \u2014 Summary of files modified and purpose\n- **Open Questions** \u2014 Unresolved items for future sessions\n\n## Best Practices\n\n- Write for a future reader with no context from this session\n- Be specific about what changed, not just what was done\n- Open questions are as valuable as answers \u2014 document uncertainty\n- If the session was long, do individual captures for major events before the summary\n\n## Reference Files\n\n- See `debrief-template.md` for the structured template to fill in\n- See `example-output.md` for a concrete example of a well-written debrief\n";
 //# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skills/knowledgine-debrief/skill-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,8gGAwEpB,CAAC"}
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,gtGAgFpB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-debrief\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u30BB\u30C3\u30B7\u30E7\u30F3\u7D42\u4E86\u6642\u306B\u3001\u73FE\u5728\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u5F97\u305F\u3059\u3079\u3066\u306E\u5B66\u3073\u3092\u8981\u7D04\u3057\u3066\u8A18\u9332\u3057\u307E\u3059\u3002\n  \u30E6\u30FC\u30B6\u30FC\u304C\u30BB\u30C3\u30B7\u30E7\u30F3\u5B8C\u4E86\u3092\u77E5\u3089\u305B\u305F\u3068\u304D\u3001\u5927\u304D\u306A\u30BF\u30B9\u30AF\u3092\u5B8C\u4E86\u3057\u305F\u5F8C\u3001\u307E\u305F\u306F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30EC\u30D3\u30E5\u30FC\u3092\n  \u6C42\u3081\u3089\u308C\u305F\u3068\u304D\u306B\u547C\u3073\u51FA\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u89E3\u6C7A\u3057\u305F\u554F\u984C\u3001\u884C\u3063\u305F\u5224\u65AD\u3001\u767A\u898B\u3057\u305F\u30D1\u30BF\u30FC\u30F3\u3001\n  \u672A\u89E3\u6C7A\u306E\u7591\u554F\u3092\u7DB2\u7F85\u3059\u308B\u69CB\u9020\u5316\u3055\u308C\u305F\u77E5\u8B58\u30AD\u30E3\u30D7\u30C1\u30E3\u3092\u751F\u6210\u3057\u307E\u3059\u3002\n---\n# knowledgine-debrief\n\n## \u76EE\u7684\n\n\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u5F97\u305F\u3059\u3079\u3066\u306E\u5B66\u3073\u3092\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5931\u308F\u308C\u308B\u524D\u306B\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3078\u96C6\u7D04\u3057\u307E\u3059\u3002\n\u30C7\u30D6\u30EA\u30FC\u30D5\u306F\u3001\u30D0\u30B0\u4FEE\u6B63\u30FB\u5224\u65AD\u30FB\u30B3\u30FC\u30C9\u5909\u66F4\u3068\u3044\u3063\u305F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u751F\u306E\u51FA\u6765\u4E8B\u3092\u3001\n\u5C06\u6765\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u7A4D\u307F\u4E0A\u3052\u3089\u308C\u308B\u8010\u4E45\u6027\u306E\u3042\u308B\u69CB\u9020\u5316\u3055\u308C\u305F\u77E5\u8B58\u3078\u3068\u5909\u63DB\u3057\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u30BB\u30C3\u30B7\u30E7\u30F3\u7D42\u4E86\u6642** \u2014 \u30E6\u30FC\u30B6\u30FC\u304C\u300C\u5B8C\u4E86\u300D\u300C\u4EE5\u4E0A\u3067\u3059\u300D\u300C\u307E\u3068\u3081\u307E\u3057\u3087\u3046\u300D\u306A\u3069\u3068\u8A00\u3063\u305F\u3068\u304D\n- **\u5927\u304D\u306A\u30BF\u30B9\u30AF\u5B8C\u4E86\u5F8C** \u2014 \u91CD\u8981\u306A\u6A5F\u80FD\u3001\u8907\u96D1\u306A\u30D0\u30B0\u4FEE\u6B63\u3001\u307E\u305F\u306F\u30EA\u30D5\u30A1\u30AF\u30BF\u30EA\u30F3\u30B0\u306E\u5F8C\n- **\u30E6\u30FC\u30B6\u30FC\u304C\u30EC\u30D3\u30E5\u30FC\u3092\u6C42\u3081\u305F\u3068\u304D** \u2014 \u300C\u4ECA\u65E5\u4F55\u3092\u3057\u307E\u3057\u305F\u304B\uFF1F\u300D\u300C\u30BB\u30C3\u30B7\u30E7\u30F3\u3092\u307E\u3068\u3081\u3066\u300D\n- **\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u5207\u308A\u66FF\u3048\u524D** \u2014 \u30B3\u30FC\u30C9\u30D9\u30FC\u30B9\u306E\u307E\u3063\u305F\u304F\u5225\u306E\u9818\u57DF\u306B\u79FB\u308B\u524D\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u5C0F\u3055\u306A\u5909\u66F4\u3054\u3068\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u4E2D\u76E4\u2014\u2014\u30C7\u30D6\u30EA\u30FC\u30D5\u306F\u610F\u5473\u306E\u3042\u308B\u7BC0\u76EE\u306B\u884C\u3046\n- \u91CD\u8981\u306A\u3053\u3068\u304C\u4F55\u3082\u8D77\u304D\u306A\u304B\u3063\u305F\u3068\u304D\uFF08\u4E9B\u7D30\u306A\u7DE8\u96C6\u306E\u307F\uFF09\n\n## \u30C7\u30D6\u30EA\u30FC\u30D5\u65B9\u6CD5\uFF08MCP\u30C4\u30FC\u30EB\uFF09\n\n`capture_knowledge` \u3092\u4F7F\u3063\u3066\u30BB\u30C3\u30B7\u30E7\u30F3\u30B5\u30DE\u30EA\u30FC\u3092\u4FDD\u5B58\u3057\u307E\u3059\uFF1A\n\n```\ncapture_knowledge(\n  content: string,    // \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3092\u4F7F\u3063\u305F\u5B8C\u5168\u306A\u69CB\u9020\u5316\u30C7\u30D6\u30EA\u30FC\u30D5\n  title?: string,     // \"Session Debrief: <date> \u2014 <main topic>\"\n  tags?: string[],    // [\"debrief\", \"<primary-area>\", ...]\n  source?: string     // \u4EFB\u610F\uFF1A\u30BB\u30C3\u30B7\u30E7\u30F3\u8B58\u5225\u5B50\n)\n```\n\n## \u30C7\u30D6\u30EA\u30FC\u30D5\u65B9\u6CD5\uFF08CLI\u306E\u4EE3\u66FF\u624B\u6BB5\uFF09\n\n```bash\nknowledgine capture add \"<debrief content>\" --title \"Session Debrief: <date>\" --tags \"debrief,<area>\"\n```\n\n## \u30B9\u30C6\u30C3\u30D7\u30D0\u30A4\u30B9\u30C6\u30C3\u30D7\u306E\u624B\u9806\n\n1. **\u30BB\u30C3\u30B7\u30E7\u30F3\u3092\u632F\u308A\u8FD4\u308B** \u2014 \u4F55\u306B\u53D6\u308A\u7D44\u3093\u3060\u304B\u3092\u78BA\u8A8D\u3059\u308B\uFF08\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u30A6\u30A3\u30F3\u30C9\u30A6\u306B\u4F9D\u62E0\uFF09\n2. **\u91CD\u8981\u306A\u30A4\u30D9\u30F3\u30C8\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u89E3\u6C7A\u3057\u305F\u554F\u984C\u3001\u884C\u3063\u305F\u5224\u65AD\u3001\u767A\u898B\u3057\u305F\u30D1\u30BF\u30FC\u30F3\n3. **\u30C7\u30D6\u30EA\u30FC\u30D5\u3092\u4E0B\u66F8\u304D\u3059\u308B** \u2014 debrief-template.md \u306E\u69CB\u9020\u5316\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3092\u4F7F\u7528\n4. **\u4E3B\u8981\u306A\u5B66\u3073\u3092\u500B\u5225\u306B\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B** \u2014 \u30D0\u30B0\u4FEE\u6B63\u3084\u5224\u65AD\u304C\u5358\u72EC\u3067\u6210\u7ACB\u3059\u308B\u307B\u3069\u91CD\u8981\u3067\u3042\u308C\u3070\u3001\n   \u5148\u306B\u9069\u5207\u306A\u30B9\u30AD\u30EB\u3067\u500B\u5225\u306B\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B\n5. **\u30BB\u30C3\u30B7\u30E7\u30F3\u30B5\u30DE\u30EA\u30FC\u3092\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B** \u2014 \u307E\u3068\u3081\u305F\u30C7\u30D6\u30EA\u30FC\u30D5\u30CE\u30FC\u30C8\u3092\u4FDD\u5B58\u3059\u308B\n6. **\u5B8C\u4E86\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u4F55\u3092\u30AD\u30E3\u30D7\u30C1\u30E3\u3057\u305F\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u5831\u544A\u3059\u308B\n\n## \u30C7\u30D6\u30EA\u30FC\u30D5\u306E\u69CB\u6210\n\n\u512A\u308C\u305F\u30C7\u30D6\u30EA\u30FC\u30D5\u306B\u542B\u307E\u308C\u308B\u5185\u5BB9\uFF1A\n\n- **\u89E3\u6C7A\u3057\u305F\u554F\u984C** \u2014 \u4F55\u304C\u58CA\u308C\u3066\u3044\u3066\u3001\u3069\u3046\u4FEE\u6B63\u3057\u305F\u304B\n- **\u884C\u3063\u305F\u5224\u65AD** \u2014 \u4F55\u3092\u9078\u3073\u3001\u306A\u305C\u304B\n- **\u767A\u898B\u3057\u305F\u30D1\u30BF\u30FC\u30F3** \u2014 \u767A\u898B\u3057\u305F\u518D\u5229\u7528\u53EF\u80FD\u306A\u77E5\u898B\n- **\u5909\u66F4\u3057\u305F\u30B3\u30FC\u30C9** \u2014 \u5909\u66F4\u3057\u305F\u30D5\u30A1\u30A4\u30EB\u306E\u6982\u8981\u3068\u76EE\u7684\n- **\u672A\u89E3\u6C7A\u306E\u7591\u554F** \u2014 \u5C06\u6765\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306B\u5411\u3051\u305F\u672A\u89E3\u6C7A\u306E\u4E8B\u9805\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- \u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u6301\u305F\u306A\u3044\u5C06\u6765\u306E\u8AAD\u8005\u3092\u60F3\u5B9A\u3057\u3066\u66F8\u304F\n- \u4F55\u3092\u3057\u305F\u304B\u3060\u3051\u3067\u306A\u304F\u3001\u4F55\u304C\u5909\u308F\u3063\u305F\u304B\u3092\u5177\u4F53\u7684\u306B\u66F8\u304F\n- \u672A\u89E3\u6C7A\u306E\u7591\u554F\u306F\u7B54\u3048\u3068\u540C\u3058\u304F\u3089\u3044\u4FA1\u5024\u304C\u3042\u308B\u2014\u2014\u4E0D\u78BA\u5B9F\u6027\u3092\u8A18\u9332\u3059\u308B\n- \u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u9577\u304B\u3063\u305F\u5834\u5408\u306F\u3001\u30B5\u30DE\u30EA\u30FC\u306E\u524D\u306B\u4E3B\u8981\u306A\u30A4\u30D9\u30F3\u30C8\u3092\u500B\u5225\u306B\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- \u30BB\u30C3\u30B7\u30E7\u30F3\u30C7\u30D6\u30EA\u30FC\u30D5\u306E\u69CB\u9020\u5316\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306F `debrief-template.md` \u3092\u53C2\u7167\n- \u9069\u5207\u306B\u66F8\u304B\u308C\u305F\u30C7\u30D6\u30EA\u30FC\u30D5\u306E\u5177\u4F53\u7684\u306A\u4F8B\u306F `example-output.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,48OAgFpB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.js

@@ -0,0 +1,82 @@
+export const SKILL_MD = `---
+name: knowledgine-debrief
+version: "1.0.0"
+lang: ja
+description: >
+  セッション終了時に、現在のセッションで得たすべての学びを要約して記録します。
+  ユーザーがセッション完了を知らせたとき、大きなタスクを完了した後、またはセッションのレビューを
+  求められたときに呼び出してください。解決した問題、行った判断、発見したパターン、
+  未解決の疑問を網羅する構造化された知識キャプチャを生成します。
+---
+# knowledgine-debrief
+
+## 目的
+
+セッションで得たすべての学びをコンテキストが失われる前にナレッジベースへ集約します。
+デブリーフは、バグ修正・判断・コード変更といったセッションの生の出来事を、
+将来のセッションが積み上げられる耐久性のある構造化された知識へと変換します。
+
+## 使用するタイミング
+
+- **セッション終了時** — ユーザーが「完了」「以上です」「まとめましょう」などと言ったとき
+- **大きなタスク完了後** — 重要な機能、複雑なバグ修正、またはリファクタリングの後
+- **ユーザーがレビューを求めたとき** — 「今日何をしましたか？」「セッションをまとめて」
+- **コンテキスト切り替え前** — コードベースのまったく別の領域に移る前
+
+## 使用しないタイミング
+
+- 小さな変更ごとのセッション中盤——デブリーフは意味のある節目に行う
+- 重要なことが何も起きなかったとき（些細な編集のみ）
+
+## デブリーフ方法（MCPツール）
+
+\`capture_knowledge\` を使ってセッションサマリーを保存します：
+
+\`\`\`
+capture_knowledge(
+  content: string,    // テンプレートを使った完全な構造化デブリーフ
+  title?: string,     // "Session Debrief: <date> — <main topic>"
+  tags?: string[],    // ["debrief", "<primary-area>", ...]
+  source?: string     // 任意：セッション識別子
+)
+\`\`\`
+
+## デブリーフ方法（CLIの代替手段）
+
+\`\`\`bash
+knowledgine capture add "<debrief content>" --title "Session Debrief: <date>" --tags "debrief,<area>"
+\`\`\`
+
+## ステップバイステップの手順
+
+1. **セッションを振り返る** — 何に取り組んだかを確認する（コンテキストウィンドウに依拠）
+2. **重要なイベントを特定する** — 解決した問題、行った判断、発見したパターン
+3. **デブリーフを下書きする** — debrief-template.md の構造化テンプレートを使用
+4. **主要な学びを個別にキャプチャする** — バグ修正や判断が単独で成立するほど重要であれば、
+   先に適切なスキルで個別にキャプチャする
+5. **セッションサマリーをキャプチャする** — まとめたデブリーフノートを保存する
+6. **完了を確認する** — 何をキャプチャしたかをユーザーに報告する
+
+## デブリーフの構成
+
+優れたデブリーフに含まれる内容：
+
+- **解決した問題** — 何が壊れていて、どう修正したか
+- **行った判断** — 何を選び、なぜか
+- **発見したパターン** — 発見した再利用可能な知見
+- **変更したコード** — 変更したファイルの概要と目的
+- **未解決の疑問** — 将来のセッションに向けた未解決の事項
+
+## ベストプラクティス
+
+- このセッションのコンテキストを持たない将来の読者を想定して書く
+- 何をしたかだけでなく、何が変わったかを具体的に書く
+- 未解決の疑問は答えと同じくらい価値がある——不確実性を記録する
+- セッションが長かった場合は、サマリーの前に主要なイベントを個別にキャプチャする
+
+## 参照ファイル
+
+- セッションデブリーフの構造化テンプレートは \`debrief-template.md\` を参照
+- 適切に書かれたデブリーフの具体的な例は \`example-output.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFvB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.js

@@ -1,5 +1,7 @@
 export const SKILL_MD = `---
 name: knowledgine-debrief
+version: "1.0.0"
+lang: en
 description: >
   Summarize and record all learnings from the current session at its end. Invoke when
   the user signals the session is complete, after finishing a major task, or when asked
@@ -33,12 +35,18 @@ Use \`capture_knowledge\` to save the session summary:
 \`\`\`
 capture_knowledge(
   content: string,    // Full structured debrief using the template
-  title: string,      // "Session Debrief: <date> — <main topic>"
-  tags: string[],     // ["debrief", "<primary-area>", ...]
+  title?: string,     // "Session Debrief: <date> — <main topic>"
+  tags?: string[],    // ["debrief", "<primary-area>", ...]
   source?: string     // Optional: session identifier
 )
 \`\`\`
 
+## How to Debrief (CLI Alternative)
+
+\`\`\`bash
+knowledgine capture add "<debrief content>" --title "Session Debrief: <date>" --tags "debrief,<area>"
+\`\`\`
+
 ## Step-by-Step Instructions
 
 1. **Recall the session** — Review what was worked on (rely on your context window)

package/dist/templates/skills/knowledgine-debrief/skill-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEvB,CAAC"}
+{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFvB,CAAC"}

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explain/references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsL7C,CAAC"}
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsL7C,CAAC"}

package/dist/templates/skills/knowledgine-explore/references.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCES: Record<string, string>;
+//# sourceMappingURL=references.ja.d.ts.map

package/dist/templates/skills/knowledgine-explore/references.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqL7C,CAAC"}

package/dist/templates/skills/knowledgine-explore/references.ja.js

@@ -0,0 +1,182 @@
+export const REFERENCES = {
+    "entity-types.md": `# エンティティの種類
+
+knowledgine がナレッジベースのコンテンツから認識・抽出するエンティティの種類。
+
+---
+
+## コアエンティティの種類
+
+| 種類 | 説明 | 例 |
+|------|------|-----|
+| \`technology\` | ライブラリ、フレームワーク、ツール、言語 | \`SQLite\`, \`TypeScript\`, \`Node.js\`, \`Zod\` |
+| \`concept\` | 抽象的なアイデア、パターン、アーキテクチャの概念 | \`caching\`, \`ESM\`, \`FTS5\`, \`semantic search\` |
+| \`project\` | プロジェクト、リポジトリ、製品 | \`knowledgine\`, \`claude-code\` |
+| \`person\` | 著者、コントリビュータ、連絡先 | チームメンバー、外部コントリビュータ |
+| \`component\` | コードコンポーネント、クラス、モジュール | \`KnowledgeRepository\`, \`IngestEngine\` |
+| \`command\` | CLI コマンドまたは API オペレーション | \`knowledgine init\`, \`capture_knowledge\` |
+| \`file\` | ソースファイルとパス | \`packages/core/src/config/config-loader.ts\` |
+| \`error\` | 名前付きエラー型またはエラーメッセージ | \`SQLITE_CONSTRAINT\`, \`ENOENT\` |
+
+---
+
+## エンティティの検索
+
+### 正確な名前で
+\`\`\`
+search_entities(query: "SQLite")
+search_entities(query: "KnowledgeRepository")
+\`\`\`
+
+### 種類 + 名前で
+\`\`\`
+search_entities(query: "technology sqlite")
+search_entities(query: "concept caching")
+\`\`\`
+
+### 部分的な名前で
+\`\`\`
+search_entities(query: "Knowledge")  // KnowledgeRepository, knowledgine などに一致
+\`\`\`
+
+---
+
+## エンティティ抽出の品質
+
+エンティティはNLPを使用してノートのコンテンツから自動的に抽出されます。品質は
+ノートの明確さに依存します。欠落または不正確なエンティティに気づいた場合は、
+\`knowledgine-feedback\` を使用して報告してください。
+
+**よくある抽出の問題**:
+- 略語（TS → TypeScript がリンクされない場合がある）
+- クラス名と同じ一般的な単語（Table, Manager）
+- 一部のみが捕捉されるマルチワードエンティティ
+
+---
+
+## 探索のためのエンティティの活用
+
+エンティティはナレッジグラフのナビゲーションハブとして機能します。\`SQLite\` のような
+技術エンティティは SQLite に言及するすべてのノートに接続されており、エンティティから
+関連するすべてのバグ修正、設計上の決定、パターンへと移動できます。
+
+**探索パターン**:
+\`\`\`
+1. search_entities(query: "SQLite") → エンティティ ID（数値）を取得
+2. get_entity_graph(entityId: 123) → すべての接続を確認
+3. find_related(noteId: 456) → 外側に向かって走査
+\`\`\`
+`,
+    "graph-navigation.md": `# グラフナビゲーション
+
+\`get_entity_graph\` と \`find_related\` を使ってナレッジグラフを効果的に走査する方法。
+
+---
+
+## ナレッジグラフの構造
+
+ナレッジグラフには 2 種類のノードがあります:
+
+- **ノート** — 個々の知識エントリ（バグ修正、決定、パターンなど）
+- **エンティティ** — ノートから抽出された名前付きの事物（技術、概念、人物）
+
+**エッジの種類**:
+- ノート → エンティティ: 「このノートはこのエンティティに言及している」
+- エンティティ → ノート: 「このエンティティはこれらのノートに登場する」
+- ノート → ノート: 「これらのノートはエンティティを共有している」（エンティティの接続を通じた暗示的なもの）
+
+---
+
+## get_entity_graph
+
+エンティティと、それが登場するすべてのノート、さらに関連エンティティを返します。
+
+\`\`\`
+get_entity_graph(entityId: 123)
+// 戻り値: { entity, notes: [...], relatedEntities: [...] }
+
+get_entity_graph(entityName: "SQLite")
+// 名前でエンティティを検索してからグラフを返す
+\`\`\`
+
+**以下のときに使用**:
+- 特定の技術や概念に関するすべてのノートを確認したい
+- このエンティティと共に登場する他のエンティティを発見したい
+- より深い走査を行う前に概要を把握したい
+
+---
+
+## find_related
+
+共有エンティティを通じて、出発点（ノートまたはファイルパス）に関連するノートを返します。
+
+\`\`\`
+find_related(noteId: 456, limit: 10, maxHops: 2)
+find_related(filePath: "src/commands/setup.ts", limit: 10)
+\`\`\`
+
+**パラメータ**:
+- \`noteId\`（数値）または \`filePath\`: 走査の出発点
+- \`limit\`: 返すノートの最大数（デフォルト 5）
+- \`maxHops\`: 許可するエッジ走査のステップ数（1〜3、デフォルト 1）
+
+### maxHops ガイド
+
+| maxHops | 意味 | 使用するタイミング |
+|---------|------|-----------------|
+| 1 | 出発ノートと直接エンティティを共有するノートのみ | デフォルト、焦点を絞ったルックアップ |
+| 2 | 2 ホップ離れたノート（1 ホップのノートとエンティティを共有） | より広い探索 |
+| 3 | 3 ホップ離れたノート | オープンエンドの探索、大きなグラフ |
+
+**maxHops を大きくするほど結果が増えるが、平均的な関連性は低くなります。** 1 から始め、
+結果が疎すぎる場合にのみ増やしてください。
+
+---
+
+## ナビゲーションパターン
+
+### パターン 1: 技術の詳細調査
+
+\`\`\`
+// ナレッジベースにある TypeScript に関するすべてを理解する
+1. search_entities(query: "TypeScript") → { id: 42, name: "TypeScript" }
+2. get_entity_graph(entityId: 42)
+   → 15 件のノートが TypeScript に言及
+   → 関連エンティティ: ESM, tsconfig, type-safety
+3. find_related(noteId: <上位ノートの id>, maxHops: 2)
+   → 隣接するノートを提示
+\`\`\`
+
+### パターン 2: コンポーネントの歴史
+
+\`\`\`
+// セットアップコマンドの歴史を理解する
+1. search_entities(query: "setupCommand") → エンティティ
+2. get_entity_graph(entityId: <id>) → setupCommand に関するノート
+3. design-decision とリファクタリングのノートをフィルタリング
+4. 時系列順に読んで変遷を理解する
+\`\`\`
+
+### パターン 3: 領域をまたいだ接続
+
+\`\`\`
+// 2つのコンポーネント間の接続を見つける
+1. get_entity_graph(entityName: "IngestEngine") → ノート + エンティティのセット A
+2. get_entity_graph(entityName: "KnowledgeRepository") → セット B
+3. relatedEntities の重複を調べてブリッジを見つける
+\`\`\`
+
+---
+
+## 結果の解釈
+
+\`get_entity_graph\` が多くのノートを返す場合、タグで優先順位を付けます:
+
+| 優先度 | タグ |
+|--------|------|
+| 高 | \`design-decision\`, \`bug-fix\`, \`troubleshooting\` |
+| 中 | \`pattern\`, \`refactoring\`, \`external-knowledge\` |
+| 低 | タグなしのノート |
+`,
+};
+//# sourceMappingURL=references.ja.js.map

package/dist/templates/skills/knowledgine-explore/references.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEpB;IAEC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8GxB;CACA,CAAC"}

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.js

@@ -62,9 +62,9 @@ the entity to all related bug fixes, design decisions, and patterns.
 
 **Exploration pattern**:
 \`\`\`
-1. search_entities(query: "SQLite") → get entity ID
-2. get_entity_graph(entityId: "<id>") → see all connections
-3. find_related(noteId: "<connected note id>") → traverse outward
+1. search_entities(query: "SQLite") → get entity ID (number)
+2. get_entity_graph(entityId: 123) → see all connections
+3. find_related(noteId: 456) → traverse outward
 \`\`\`
 `,
     "graph-navigation.md": `# Graph Navigation
@@ -93,7 +93,7 @@ The knowledge graph has two node types:
 Returns the entity and all notes it appears in, plus related entities.
 
 \`\`\`
-get_entity_graph(entityId: "123")
+get_entity_graph(entityId: 123)
 // Returns: { entity, notes: [...], relatedEntities: [...] }
 
 get_entity_graph(entityName: "SQLite")
@@ -112,25 +112,25 @@ get_entity_graph(entityName: "SQLite")
 Returns notes related to a starting point (note or file path) via shared entities.
 
 \`\`\`
-find_related(noteId: "abc123", limit: 10, maxHops: 2)
+find_related(noteId: 456, limit: 10, maxHops: 2)
 find_related(filePath: "src/commands/setup.ts", limit: 10)
 \`\`\`
 
 **Parameters**:
-- \`noteId\` or \`filePath\`: Starting point for traversal
-- \`limit\`: Maximum notes to return
-- \`maxHops\`: How many edge-traversal steps to allow (1–3)
+- \`noteId\` (number) or \`filePath\`: Starting point for traversal
+- \`limit\`: Maximum notes to return (default 5)
+- \`maxHops\`: How many edge-traversal steps to allow (1–3, default 1)
 
 ### maxHops Guide
 
 | maxHops | Meaning | When to use |
 |---------|---------|-------------|
-| 1 | Only notes that share a direct entity with the starting note | Focused lookup |
-| 2 | Notes 2 hops away (share an entity with a 1-hop note) | Default, good balance |
+| 1 | Only notes that share a direct entity with the starting note | Default, focused lookup |
+| 2 | Notes 2 hops away (share an entity with a 1-hop note) | Broader exploration |
 | 3 | Notes 3 hops away | Open-ended exploration, large graph |
 
 **Higher maxHops returns more results but with lower average relevance.** Start at 1
-or 2 and increase only if the results are too sparse.
+and increase only if the results are too sparse.
 
 ---
 
@@ -140,11 +140,11 @@ or 2 and increase only if the results are too sparse.
 
 \`\`\`
 // Understand everything in the knowledge base about TypeScript
-1. search_entities(query: "TypeScript") → { id: "42", name: "TypeScript" }
-2. get_entity_graph(entityId: "42")
+1. search_entities(query: "TypeScript") → { id: 42, name: "TypeScript" }
+2. get_entity_graph(entityId: 42)
    → 15 notes mention TypeScript
    → related entities: ESM, tsconfig, type-safety
-3. find_related(noteId: "<top note id>", maxHops: 2)
+3. find_related(noteId: <top note id>, maxHops: 2)
    → Surface adjacent notes
 \`\`\`
 
@@ -153,7 +153,7 @@ or 2 and increase only if the results are too sparse.
 \`\`\`
 // Understand the history of the setup command
 1. search_entities(query: "setupCommand") → entity
-2. get_entity_graph(entityId: "<id>") → notes about setupCommand
+2. get_entity_graph(entityId: <id>) → notes about setupCommand
 3. Filter for design-decision and refactoring notes
 4. Read chronologically to understand evolution
 \`\`\`

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.js.map

@@ -1 +1 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explain/references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEpB;IAEC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GxB;CACA,CAAC"}
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEpB;IAEC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GxB;CACA,CAAC"}

package/dist/templates/skills/knowledgine-explore/skill-md.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-explore\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Explore entities, knowledge graph connections, and design history for unfamiliar\n  components. Invoke when exploring code you did not write, tracing the history of a\n  design decision, or understanding how a named entity (technology, library, project,\n  component) relates to other parts of the knowledge base.\n---\n# knowledgine-explore\n\n## Purpose\n\nTrace the knowledge graph to understand why things are the way they are. Explore uses\nentity search and graph traversal to surface the full context around a component or\nconcept \u2014 not just what exists, but how it connects to other parts of the system and\nwhat decisions shaped it.\n\n## When to Use\n\n- **Exploring unfamiliar code** \u2014 Who wrote what and why? What decisions shaped this?\n- **Understanding design rationale** \u2014 What alternatives were considered?\n- **Tracing knowledge provenance** \u2014 Where did this pattern or approach come from?\n- **Auditing a technology choice** \u2014 Why is this library used here?\n- **Understanding relationships** \u2014 How do components A and B relate?\n\n## When NOT to Use\n\n- When you just need to find a specific past solution (use knowledgine-search instead)\n- When the entity does not exist in the knowledge base yet\n- For trivial well-known concepts with no project-specific context\n\n## How to Explore (MCP Tools)\n\n### Step 1: Search for entities\n\n```\nsearch_entities(\n  query: string,   // Entity name, technology, concept, or person\n  limit?: number   // Max results (default 20)\n)\n```\n\n### Step 2: Explore entity graph\n\n```\nget_entity_graph(\n  entityId?: number,    // ID from search_entities result\n  entityName?: string   // Or search by name directly\n)\n```\n\n### Step 3: Find related notes\n\n```\nfind_related(\n  noteId?: number,    // A relevant note ID found in earlier steps\n  filePath?: string,  // Or a relevant file path\n  limit?: number,     // Max notes to return (default 5)\n  maxHops?: number    // 1\u20133, default 1\n)\n```\n\n## How to Explore (CLI Alternative)\n\n```bash\nknowledgine explain \"<entity name or concept>\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the subject** \u2014 What entity, component, or concept do you want to understand?\n2. **Search for the entity** \u2014 Call `search_entities` with the subject name\n3. **Inspect the entity graph** \u2014 Call `get_entity_graph` with the entity ID\n4. **Traverse related notes** \u2014 Call `find_related` for notes that mention this entity\n5. **Synthesize findings** \u2014 Summarize what you learned about the entity's history and connections\n\n## Best Practices\n\n- Start with `search_entities` to discover the exact entity name as stored in the knowledge base\n- Use `get_entity_graph` to map the neighborhood before diving into individual notes\n- Increase `maxHops` gradually \u2014 start at 1, go to 2 or 3 if the immediate neighborhood is sparse\n- Look specifically for notes tagged `design-decision` \u2014 they explain the \"why\"\n\n## Edge Cases\n\n- **If the knowledge base is empty** \u2014 No entities will be found. Run `knowledgine-ingest` first to populate the knowledge base before exploring.\n- **If semantic search is unavailable** \u2014 Fall back to keyword search by using specific technology or component names as the query string.\n\n## Reference Files\n\n- See `entity-types.md` for the entity taxonomy used in knowledgine\n- See `graph-navigation.md` for how to traverse the knowledge graph effectively\n";
+//# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skills/knowledgine-explore/skill-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,4/GA8FpB,CAAC"}

package/dist/templates/skills/knowledgine-explore/skill-md.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-explore\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u6163\u308C\u306A\u3044\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3001\u30CA\u30EC\u30C3\u30B8\u30B0\u30E9\u30D5\u306E\u63A5\u7D9A\u3001\u8A2D\u8A08\u306E\u6B74\u53F2\u3092\u63A2\u7D22\u3057\u307E\u3059\u3002\n  \u81EA\u5206\u304C\u66F8\u3044\u3066\u3044\u306A\u3044\u30B3\u30FC\u30C9\u3092\u63A2\u7D22\u3059\u308B\u3068\u304D\u3001\u8A2D\u8A08\u4E0A\u306E\u6C7A\u5B9A\u306E\u7D4C\u7DEF\u3092\u8FFD\u8DE1\u3059\u308B\u3068\u304D\u3001\n  \u307E\u305F\u306F\u540D\u524D\u4ED8\u304D\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\uFF08\u6280\u8853\u3001\u30E9\u30A4\u30D6\u30E9\u30EA\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\uFF09\u304C\n  \u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306E\u4ED6\u306E\u90E8\u5206\u3068\u3069\u306E\u3088\u3046\u306B\u95A2\u9023\u3057\u3066\u3044\u308B\u304B\u3092\u7406\u89E3\u3059\u308B\u3068\u304D\u306B\u547C\u3073\u51FA\u3057\u307E\u3059\u3002\n---\n# knowledgine-explore\n\n## \u76EE\u7684\n\n\u30CA\u30EC\u30C3\u30B8\u30B0\u30E9\u30D5\u3092\u8FFD\u8DE1\u3057\u3066\u3001\u306A\u305C\u7269\u4E8B\u304C\u73FE\u72B6\u306E\u3088\u3046\u306B\u306A\u3063\u3066\u3044\u308B\u304B\u3092\u7406\u89E3\u3057\u307E\u3059\u3002\nExplore \u306F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u691C\u7D22\u3068\u30B0\u30E9\u30D5\u8D70\u67FB\u3092\u4F7F\u7528\u3057\u3066\u3001\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3084\u6982\u5FF5\u3092\u53D6\u308A\u5DFB\u304F\n\u5B8C\u5168\u306A\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u63D0\u793A\u3057\u307E\u3059 \u2014 \u4F55\u304C\u5B58\u5728\u3059\u308B\u304B\u3060\u3051\u3067\u306A\u304F\u3001\u305D\u308C\u304C\u30B7\u30B9\u30C6\u30E0\u306E\u4ED6\u306E\u90E8\u5206\u3068\n\u3069\u306E\u3088\u3046\u306B\u63A5\u7D9A\u3055\u308C\u3066\u3044\u308B\u304B\u3001\u305D\u3057\u3066\u3069\u306E\u3088\u3046\u306A\u6C7A\u5B9A\u304C\u305D\u308C\u3092\u5F62\u6210\u3057\u305F\u304B\u3082\u542B\u3081\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u6163\u308C\u306A\u3044\u30B3\u30FC\u30C9\u3092\u63A2\u7D22\u3059\u308B\u3068\u304D** \u2014 \u8AB0\u304C\u4F55\u3092\u306A\u305C\u4F5C\u3063\u305F\u306E\u304B\uFF1F\u3069\u306E\u3088\u3046\u306A\u6C7A\u5B9A\u304C\u3053\u308C\u3092\u5F62\u6210\u3057\u305F\u306E\u304B\uFF1F\n- **\u8A2D\u8A08\u306E\u6839\u62E0\u3092\u7406\u89E3\u3059\u308B\u3068\u304D** \u2014 \u3069\u306E\u3088\u3046\u306A\u4EE3\u66FF\u6848\u304C\u691C\u8A0E\u3055\u308C\u305F\u306E\u304B\uFF1F\n- **\u77E5\u8B58\u306E\u51FA\u6240\u3092\u8FFD\u8DE1\u3059\u308B\u3068\u304D** \u2014 \u3053\u306E\u30D1\u30BF\u30FC\u30F3\u3084\u30A2\u30D7\u30ED\u30FC\u30C1\u306F\u3069\u3053\u304B\u3089\u6765\u305F\u306E\u304B\uFF1F\n- **\u6280\u8853\u9078\u629E\u306E\u76E3\u67FB** \u2014 \u306A\u305C\u3053\u3053\u3067\u3053\u306E\u30E9\u30A4\u30D6\u30E9\u30EA\u304C\u4F7F\u308F\u308C\u3066\u3044\u308B\u306E\u304B\uFF1F\n- **\u95A2\u4FC2\u6027\u3092\u7406\u89E3\u3059\u308B\u3068\u304D** \u2014 \u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8 A \u3068 B \u306F\u3069\u306E\u3088\u3046\u306B\u95A2\u9023\u3057\u3066\u3044\u308B\u306E\u304B\uFF1F\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u7279\u5B9A\u306E\u904E\u53BB\u306E\u89E3\u6C7A\u7B56\u3092\u898B\u3064\u3051\u305F\u3044\u3060\u3051\u306E\u3068\u304D\uFF08\u4EE3\u308F\u308A\u306B knowledgine-search \u3092\u4F7F\u7528\uFF09\n- \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\u307E\u3060\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306B\u5B58\u5728\u3057\u306A\u3044\u3068\u304D\n- \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u56FA\u6709\u306E\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u306A\u3044\u81EA\u660E\u306E\u5E83\u304F\u77E5\u3089\u308C\u305F\u6982\u5FF5\n\n## \u63A2\u7D22\u65B9\u6CD5 (MCP \u30C4\u30FC\u30EB)\n\n### Step 1: \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3092\u691C\u7D22\u3059\u308B\n\n```\nsearch_entities(\n  query: string,   // \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\u3001\u6280\u8853\u3001\u6982\u5FF5\u3001\u307E\u305F\u306F\u4EBA\u7269\n  limit?: number   // \u6700\u5927\u7D50\u679C\u6570\uFF08\u30C7\u30D5\u30A9\u30EB\u30C8 20\uFF09\n)\n```\n\n### Step 2: \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30B0\u30E9\u30D5\u3092\u63A2\u7D22\u3059\u308B\n\n```\nget_entity_graph(\n  entityId?: number,    // search_entities \u306E\u7D50\u679C\u304B\u3089\u306E ID\n  entityName?: string   // \u307E\u305F\u306F\u540D\u524D\u3067\u76F4\u63A5\u691C\u7D22\n)\n```\n\n### Step 3: \u95A2\u9023\u30CE\u30FC\u30C8\u3092\u898B\u3064\u3051\u308B\n\n```\nfind_related(\n  noteId?: number,    // \u524D\u306E\u30B9\u30C6\u30C3\u30D7\u3067\u898B\u3064\u3051\u305F\u95A2\u9023\u30CE\u30FC\u30C9\u306E ID\n  filePath?: string,  // \u307E\u305F\u306F\u95A2\u9023\u3059\u308B\u30D5\u30A1\u30A4\u30EB\u30D1\u30B9\n  limit?: number,     // \u8FD4\u3059\u30CE\u30FC\u30C8\u306E\u6700\u5927\u6570\uFF08\u30C7\u30D5\u30A9\u30EB\u30C8 5\uFF09\n  maxHops?: number    // 1\u301C3\u3001\u30C7\u30D5\u30A9\u30EB\u30C8 1\n)\n```\n\n## \u63A2\u7D22\u65B9\u6CD5 (CLI \u306E\u4EE3\u66FF\u624B\u6BB5)\n\n```bash\nknowledgine explain \"<entity name or concept>\"\n```\n\n## \u624B\u9806\n\n1. **\u5BFE\u8C61\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u7406\u89E3\u3057\u305F\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3001\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3001\u307E\u305F\u306F\u6982\u5FF5\u306F\u4F55\u304B\uFF1F\n2. **\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3092\u691C\u7D22\u3059\u308B** \u2014 \u5BFE\u8C61\u306E\u540D\u524D\u3067 `search_entities` \u3092\u547C\u3073\u51FA\u3059\n3. **\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30B0\u30E9\u30D5\u3092\u8ABF\u3079\u308B** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3 ID \u3067 `get_entity_graph` \u3092\u547C\u3073\u51FA\u3059\n4. **\u95A2\u9023\u30CE\u30FC\u30C8\u3092\u8D70\u67FB\u3059\u308B** \u2014 \u3053\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306B\u8A00\u53CA\u3059\u308B\u30CE\u30FC\u30C8\u306B\u5BFE\u3057\u3066 `find_related` \u3092\u547C\u3073\u51FA\u3059\n5. **\u767A\u898B\u5185\u5BB9\u3092\u7D71\u5408\u3059\u308B** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306E\u6B74\u53F2\u3068\u63A5\u7D9A\u306B\u3064\u3044\u3066\u5B66\u3093\u3060\u3053\u3068\u3092\u307E\u3068\u3081\u308B\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- `search_entities` \u304B\u3089\u59CB\u3081\u3066\u3001\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306B\u4FDD\u5B58\u3055\u308C\u3066\u3044\u308B\u6B63\u78BA\u306A\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\u3092\u767A\u898B\u3059\u308B\n- \u500B\u3005\u306E\u30CE\u30FC\u30C8\u3092\u8A73\u3057\u304F\u898B\u308B\u524D\u306B `get_entity_graph` \u3067\u8FD1\u96A3\u3092\u30DE\u30C3\u30D4\u30F3\u30B0\u3059\u308B\n- `maxHops` \u3092\u6BB5\u968E\u7684\u306B\u5897\u3084\u3059 \u2014 1 \u304B\u3089\u59CB\u3081\u3001\u8FD1\u96A3\u304C\u758E\u306A\u5834\u5408\u306F 2 \u307E\u305F\u306F 3 \u306B\u3059\u308B\n- `design-decision` \u30BF\u30B0\u304C\u4ED8\u3044\u305F\u30CE\u30FC\u30C8\u3092\u7279\u306B\u63A2\u3059 \u2014 \u305D\u308C\u3089\u304C\u300C\u306A\u305C\u300D\u3092\u8AAC\u660E\u3057\u3066\u3044\u308B\n\n## \u30A8\u30C3\u30B8\u30B1\u30FC\u30B9\n\n- **\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u304C\u7A7A\u306E\u5834\u5408** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306F\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u63A2\u7D22\u3059\u308B\u524D\u306B\n  `knowledgine-ingest` \u3092\u5B9F\u884C\u3057\u3066\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002\n- **\u30BB\u30DE\u30F3\u30C6\u30A3\u30C3\u30AF\u691C\u7D22\u304C\u5229\u7528\u3067\u304D\u306A\u3044\u5834\u5408** \u2014 \u7279\u5B9A\u306E\u6280\u8853\u307E\u305F\u306F\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u540D\u3092\n  \u30AF\u30A8\u30EA\u6587\u5B57\u5217\u3068\u3057\u3066\u4F7F\u7528\u3057\u3066\u30AD\u30FC\u30EF\u30FC\u30C9\u691C\u7D22\u306B\u30D5\u30A9\u30FC\u30EB\u30D0\u30C3\u30AF\u3057\u3066\u304F\u3060\u3055\u3044\u3002\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- knowledgine \u3067\u4F7F\u7528\u3055\u308C\u308B\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306E\u5206\u985E\u306B\u3064\u3044\u3066\u306F `entity-types.md` \u3092\u53C2\u7167\n- \u30CA\u30EC\u30C3\u30B8\u30B0\u30E9\u30D5\u3092\u52B9\u679C\u7684\u306B\u8D70\u67FB\u3059\u308B\u65B9\u6CD5\u306B\u3064\u3044\u3066\u306F `graph-navigation.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

package/dist/templates/skills/knowledgine-explore/skill-md.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,2sQAgGpB,CAAC"}