eyupcanbodur/agent-knowledge-hub

agent-knowledge-hub は何をしますか？

コーディングエージェントが読み取り、書き込み、維持管理を行うためのエージェント非依存型個人ナレッジモノレポテンプレートです。チャーターでルーティングされたサブハブ、プライム/キャプチャ/メンテナンススキル、決定論的なハイジーンループを備えています。AGENTS.md契約書とプレーンなCLIは任意のエージェントと連携します。

概要

このテンプレートは、個人の知識を構造化されたモノレポとして管理し、AIコーディングエージェントが効率的にアクセス・更新できるように設計されています。チャーター（責務範囲）に基づいて知識をサブハブに分割し、各サブハブ内で知識のライフサイクル（プライム、キャプチャ、メンテナンス）を管理します。

特徴

• エージェント非依存: AGENTS.md 契約書とプレーンCLIにより、特定のエージェントに依存しません。
• チャータールーティング: 各サブハブは明確なチャーターを持ち、エージェントが適切な知識領域にアクセスできます。
• 3つのコアスキル:
  • プライム: エージェントの作業開始前に知識ベースを準備します。
  • キャプチャ: 新しい情報を効率的に取得・構造化します。
  • メンテナンス: 知識ベースの整理、重複排除、古い情報のクリーンアップを自動化します。
• 決定論的ハイジーンループ: 定期的なメンテナンススキームにより、知識ベースの品質を維持します。

クイックスタート

1. このリポジトリをテンプレートとして新しいリポジトリを作成します。
2. AGENTS.md ファイルを編集して、エージェントとの契約を定義します。
3. サブハブを作成し、それぞれにチャーターを定義します。
4. 各サブハブに prime.md, capture.md, maintain.md スキルファイルを配置します。
5. CLIツールを使用して知識ベースを管理します。

プロジェクト構造

.
├── AGENTS.md          # エージェント契約書
├── cli/               # CLIツール
│   ├── prime.sh
│   ├── capture.sh
│   └── maintain.sh
├── hubs/              # サブハブ
│   ├── project-alpha/
│   │   ├── CHARTER.md
│   │   ├── prime.md
│   │   ├── capture.md
│   │   └── maintain.md
│   ├── learning-goals/
│   │   ├── CHARTER.md
│   │   ├── prime.md
│   │   ├── capture.md
│   │   └── maintain.md
│   └── infra-notes/
│       ├── CHARTER.md
│       ├── prime.md
│       ├── capture.md
│       └── maintain.md
└── README.md

使用方法

プライム（Prime）

エージェントが作業を開始する前に、関連するサブハブのプライムスキルを実行して知識ベースを準備します。

./cli/prime.sh --hub project-alpha

キャプチャ（Capture）

新しい情報を取得し、適切なサブハブに構造化して保存します。

./cli/capture.sh --hub learning-goals --title "New Concept" --content "..."

メンテナンス（Maintain）

知識ベース全体または特定のサブハブのメンテナンスを実行します。

./cli/maintain.sh --hub all

詳細

各サブハブの CHARTER.md には、そのサブハブの責務範囲、対象とする知識タイプ、エージェントが使用すべきルールが定義されています。AGENTS.md はトップレベルの契約書であり、全エージェントに共通の動作ルールを指定します。

詳細な使用方法とカスタマイズ方法については、各スキルファイルのドキュメントを参照してください。