simonpokorny/knowledgebase

リポジトリの .knowledgebase/ に、スキーマに従った小規模なエントリを1つ作成します。リポジトリに .knowledgebase/ が存在しない場合は、処理を中断し、ユーザーに /setup-knowledgebase スキルを先に実行するよう伝えてください。

1. タイプを選択します：

   説明	タイプ	パス
   システムに関する主張で、真実であり、再発見する価値があるもの	finding	.knowledgebase/entries/finding-<トピック-ケバブ>.md
   通常はミスから生まれる行動のルール	learning	.knowledgebase/entries/learning-<トピック-ケバブ>.md
   トレードオフを伴う代替案間の選択	decision	.knowledgebase/entries/decision-NNNN-<トピック-ケバブ>.md

2. エントリを記述します。フロントマターのフィールド、ステータス、制限、および本文の規則は ENTRY-FORMAT.md に記載されています。記述する前に必ず読んでください。実例はこのプラグインの templates/ ディレクトリに同梱されています。

3. ステータスが正直であることを確認します。finding と learning の場合：自分自身がこのセッションで主張を証明した場合のみ verified とし、その際には verified-by: agent を設定し、エビデンスを本文に記載します（Source リンクまたは実行したチェック）。証明できなかったものは unverified のままにします。これらはレビューで人間に確認を依頼するエントリです。新しい決定は status: decided とし、次の2種類があります：

   • 実装決定：自分が構築中に行った基本的な選択。理由とトレードオフを記録し、decided-by: agent とします。
   • 計画決定：ユーザーと共同で行ったものであり、コードから推測できないもの。これも decided-by: agent と記録し、セッション終了レポートからユーザーに採用行を渡し、エントリが decided-by: human になるようにします。 自ら decided-by: human を設定しないでください。これは人間のみが行います。どちらの種類も、後で新しい決定によって superseded（置き換え）される可能性があります。

4. エントリがコマンドを禁止する learning である場合、ルールが自己執行されるように guard: 正規表現を追加します。正規表現の記述ルールは ENTRY-FORMAT.md にあります。コミット前に grep -E で正規表現をテストしてください。

5. エントリは、それを生成した変更と同じブランチにコミットし、同じコミットに含めてください。エントリを後でまとめて追加しないでください。