lorgen

Lorgen — リポジトリ知識キュレーター

ソースコードだけでは語れない**「なぜそうなっているか」**(設計判断、 経緯、トレードオフ、教訓) を捕捉・蓄積する。すべてをリポジトリ内の Markdown として保存するので、人間と AI エージェントの双方が同じ知識 ベースを読み、育てていける。

生体コンピュータ Lorgen。記憶と知識の集積体 としてヒトの叡智を蓄え、必要なときに引き出す ── そんな役割を本 プラグインがリポジトリに対して果たす、というイメージ。

Lorgen は Claude Code プラグインとして配布される。一度インストール すれば、「なぜ」を捕捉・取得したい全リポジトリで使える。

アーキテクチャ

このリポジトリ (lorgen) ── プラグインソース + 自身のデータ

lorgen/
├── .claude-plugin/
│   └── plugin.json                          # プラグインマニフェスト (name, version, ...)
├── agents/
│   └── lorgen.md                             # subagent 定義
├── skills/
│   ├── lorgen/                               # 操作マニュアル (multi-file skill)
│   │   ├── SKILL.md
│   │   ├── schema.md
│   │   ├── retrieval.md
│   │   ├── accumulation.md
│   │   ├── sources.md
│   │   ├── onboard.md
│   │   ├── logging.md
│   │   └── metrics.md                       # logs → metrics の compile contract
│   └── review/
│       └── SKILL.md                         # 4-role multi-agent code review (main-agent skill)
├── commands/
│   └── review.md                            # slash command エントリ (/lorgen:review)
├── hooks/
│   └── hooks.json                           # PreToolUse: Write|Edit redaction guard
├── bin/
│   ├── lorgen-pretool-guard                  # hooks/hooks.json から呼ばれる
│   ├── lorgen-redact-check                   # secret パターンスキャナ (exit 1 = ブロック)
│   ├── lorgen-redact                         # redact ラッパー (stdout)
│   └── lorgen-compile-metrics                # jq のみで動く決定論的 compile
├── .lorgen/                                  # データストア (このリポ自身。dogfood)
│   ├── config.yaml                          (tracked)
│   ├── .gitignore                           (tracked) cache/ + state.json + logs/ を除外
│   ├── knowledge/                           (tracked)
│   │   ├── conventions/
│   │   └── decisions/
│   ├── wiki/                                (tracked)
│   │   ├── overview.md
│   │   └── architecture.md
│   ├── adr/                                 (tracked) outputs.write_adr=true 時にのみ生成
│   │   └── 0001-<slug>.md
│   ├── metrics/                             (tracked) per-session 集計 JSON
│   │   └── 20260429-102345-a3f9c2.json
│   ├── logs/                                (gitignored) raw per-session JSONL
│   ├── cache/                               (gitignored)
│   └── state.json                           (gitignored)
├── docs/
│   └── architecture.md                      # 長文アーキ概要 (living doc)
└── README.md

あなたのアプリリポジトリ (/plugin install lorgen 後)

your-app-repo/
├── .claude/
│   └── plugins/
│       └── lorgen/                           # インストール済みプラグイン (project scope)
│           ├── .claude-plugin/plugin.json
│           ├── agents/lorgen.md
│           ├── skills/lorgen/...
│           ├── hooks/hooks.json
│           └── bin/lorgen-*                  # redact-check, compile-metrics ほか
├── .lorgen/                                  # Lorgen のデータストア (初回利用時に生成)
│   ├── config.yaml                          (tracked) チーム共有設定
│   ├── .gitignore                           (tracked) cache/ + state.json + logs/ を除外
│   ├── knowledge/                           (tracked) Knowledge アイテム
│   │   ├── conventions/
│   │   ├── decisions/
│   │   ├── runbooks/
│   │   ├── facts/
│   │   └── lessons/
│   ├── wiki/                                (tracked) Wiki ページ
│   ├── adr/                                 (tracked) outputs.write_adr=true 時に生成
│   │   ├── 0001-decimal-money.md            #   Lorgen が生成した ADR
│   │   └── 0002-aurora-migration.md
│   ├── metrics/                             (tracked) per-session compile 済み集計
│   │   ├── 20260429-102345-a3f9c2.json     #   path / count / timestamp のみ
│   │   ├── 20260429-110512-c8f2d4.json     #   集約による privacy 担保
│   │   └── 20260430-091205-b1e3a7.json
│   ├── logs/                                (gitignored) raw per-session JSONL
│   │   └── 20260429-102345-a3f9c2.jsonl    #   セッション末で metrics/ に compile
│   ├── cache/                               (gitignored) PR/issue/LLM の生キャッシュ
│   └── state.json                           (gitignored) onboard カーソル, indexing state
└── (アプリケーションコード)

3 つの構成要素:

• プラグインソース (agents/, skills/lorgen/, hooks/, bin/, .claude-plugin/plugin.json) はこのリポジトリにのみ存在する。 /plugin install 時に .claude/plugins/lorgen/ (プロジェクト) または ~/.claude/plugins/lorgen/ (ユーザー) へコピーされる。
• データストア (.lorgen/) は各ユーザーリポジトリで初回利用時に 作成される。Knowledge / Wiki / Metrics は tracked、raw logs は gitignored。
• ADR ミラー (.lorgen/adr/) は outputs.write_adr が true、または per-record で opt-in したときにのみ書き出される。デフォルトはオフ。 リポジトリ慣習に合わせて出力先を outputs.adr_dir で docs/adr/ などへ上書き可能。