mcpField
R
repo-architecture

repo-architecture

github.com/garrytan生産性31.3k248 回インストール今日更新
リポジトリ

repo-architecture について

ナレッジベースのページを整理するエージェント向けの分類ガイドです。主要な主題に基づく配置と、判断が難しい場合の手順、誤分類の検出方法を示します。

主な機能

  1. 01主題に基づく分類ルール
  2. 02ページ種別の判断ツリー
  3. 03相互リンクの指針
  4. 04重要性の確認
  5. 05誤分類パターンの検出

活用シーン

  1. 01新規ページの保存先選定
  2. 02配置が曖昧なページの判断
  3. 03ページ作成の必要性確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/garrytan/gbrain --skill repo-architecture

インストール後、Claude Code で/repo-architectureを入力して読み込まれたか確認します。

詳細

リポジトリの構成 — ファイリングルール

ファイリングルールの全文: skills/_brain-filing-rules.md を参照してください

契約

このスキルでは、次のことを保証します。

  • 新しいページはすべて、形式や情報源ではなく、主題に基づいて配置されます
  • 曖昧なケースでは、判断プロトコルに従います
  • よくある誤分類パターンを検出します

フェーズ

  1. 主題を特定します。 このページを見つけるために、どのような検索をしますか?
  2. 判断ツリーに沿って進みます。
    • 人物について → people/{name-slug}.md
    • 企業について → companies/{name-slug}.md
    • 再利用可能な概念/フレームワーク → concepts/{slug}.md
    • 独自のアイデア → originals/{slug}.md
    • 会議 → meetings/{slug}.md
    • メディアコンテンツ → media/{type}/{slug}.md
    • 生データのインポート → sources/{slug}.md
  3. 相互リンクします。 関連するディレクトリからリンクします。
  4. 重要性を確認します。 重要性の判定基準については 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/ を使用する

コメント