repo-architecture について
ナレッジベースのページを整理するエージェント向けの分類ガイドです。主要な主題に基づく配置と、判断が難しい場合の手順、誤分類の検出方法を示します。
主な機能
- 01主題に基づく分類ルール
- 02ページ種別の判断ツリー
- 03相互リンクの指針
- 04重要性の確認
- 05誤分類パターンの検出
活用シーン
- 01新規ページの保存先選定
- 02配置が曖昧なページの判断
- 03ページ作成の必要性確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ garrytan/ gbrain --skill repo-architectureインストール後、Claude Code で/repo-architectureを入力して読み込まれたか確認します。
詳細
リポジトリの構成 — ファイリングルール
ファイリングルールの全文:
skills/_brain-filing-rules.mdを参照してください
契約
このスキルでは、次のことを保証します。
- 新しいページはすべて、形式や情報源ではなく、主題に基づいて配置されます
- 曖昧なケースでは、判断プロトコルに従います
- よくある誤分類パターンを検出します
フェーズ
- 主題を特定します。 このページを見つけるために、どのような検索をしますか?
- 判断ツリーに沿って進みます。
- 人物について →
people/{name-slug}.md - 企業について →
companies/{name-slug}.md - 再利用可能な概念/フレームワーク →
concepts/{slug}.md - 独自のアイデア →
originals/{slug}.md - 会議 →
meetings/{slug}.md - メディアコンテンツ →
media/{type}/{slug}.md - 生データのインポート →
sources/{slug}.md
- 人物について →
- 相互リンクします。 関連するディレクトリからリンクします。
- 重要性を確認します。 重要性の判定基準については
skills/conventions/quality.mdを参照してください。
出力形式
助言:「主題が {reason} であるため、{type}/{slug}.md に保存してください。」
失敗した場合
gbrain のエラー code、終了コード、[AGENT] ブロック、または通知ブロックが発生した場合は、エージェントオペレータープロトコルに従ってください。このスキル固有の対応は次のとおりです。
list_pages/searchで一致するディレクトリが見つからない場合、またはブレインに接続できない場合:skills/_brain-filing-rules.mdに従い、配置先はライブブレインではなくルールに基づいて決めたことを伝えます。get_pageが、ファイリング対象のページに対してpage_not_foundを返した場合:ディレクトリを選ぶ前に、スラッグをユーザーに確認します。
アンチパターン
- 形式でファイリングする(「PDF なので
sources/に入れる」) - 情報源でファイリングする(「メール由来なので
sources/に入れる」) - 既存ページの有無を確認せずにページを作成する
- 生データのダンプ以外に
sources/を使用する
コメント
Markdown 対応