npx claudepluginhub takemi-ohama/ai-plugins --plugin ndfThis skill is limited to using the following tools:
AGENTS.md・Skills・docsを「AI Agent Knowledge Architecture Policy」に基づいて分析・整理する。
Creates and refactors minimal AGENTS.md files using progressive disclosure. Manages CLAUDE.md symlinks, assesses bloat, and proactively activates for missing files.
Refactors bloated AGENTS.md, CLAUDE.md, or similar agent instruction files into organized, linked documentation via progressive disclosure. Resolves contradictions, extracts essentials, categorizes and prunes content.
Guides bootstrapping, updating, and reviewing AGENTS.md for effective agent memory: structure sections, signal vs noise filtering, prune stale entries.
Share bugs, ideas, or general feedback.
AGENTS.md・Skills・docsを「AI Agent Knowledge Architecture Policy」に基づいて分析・整理する。
$ARGUMENTS
知識を以下の3層に分離する。実際のパスはリポジトリやAIエージェントごとに異なる。
| 層 | 役割 |
|---|---|
| エントリポイント | ナビゲーション + ポリシー（軽量、300行以下推奨） |
| ドキュメント | リポジトリ知識（アーキテクチャ、モジュール説明、依存関係） |
| スキル | 実行可能なワークフロー（手順、コマンド、チェックリスト） |
推奨: AGENTS.mdを共通エントリポイントとし、各エージェント固有ファイルからインポートで参照する。
AGENTS.md ← 共通エントリポイント（本体）
.claude/CLAUDE.md ← @../AGENTS.md でインポート
.gemini/GEMINI.md ← @../AGENTS.md でインポート
（Codex CLI） ← AGENTS.md を直接読込（設定不要）
（Kiro CLI） ← AGENTS.md を直接読込（設定不要）
Claude Code (.claude/CLAUDE.md):
@../AGENTS.md
Gemini CLI (.gemini/GEMINI.md):
@../AGENTS.md
または.gemini/settings.jsonで:
{ "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } }
Codex CLI / Kiro CLI: AGENTS.mdをネイティブに読込。追加設定不要。
| エージェント | 固有ファイル | グローバル | AGENTS.md |
|---|---|---|---|
| Claude Code | .claude/CLAUDE.md | ~/.claude/CLAUDE.md | @../AGENTS.mdでインポート |
| Kiro CLI | .kiro/steering/*.md | ~/.kiro/steering/*.md | 直接読込 |
| Codex CLI | なし（AGENTS.md標準） | ~/.codex/AGENTS.md | 直接読込 |
| Gemini CLI | .gemini/GEMINI.md | ~/.gemini/GEMINI.md | @../AGENTS.mdでインポート or settings.json |
補足:
product.md/tech.md/structure.md）で構造化指示を管理AGENTS.override.mdによる上書き機構あり@構文でネストインポート対応（循環検出あり、最大深度5）| エージェント | プロジェクト | ユーザー |
|---|---|---|
| Claude Code | .claude/skills/<name>/SKILL.md | ~/.claude/skills/<name>/SKILL.md |
| Kiro CLI | .kiro/skills/<name>/SKILL.md | なし（エージェント経由） |
| Codex CLI | .agents/skills/<name>/SKILL.md | ~/.agents/skills/<name>/SKILL.md |
| Gemini CLI | .agents/skills/<name>/SKILL.md or .gemini/skills/<name>/SKILL.md | ~/.agents/skills/<name>/SKILL.md or ~/.gemini/skills/<name>/SKILL.md |
共通: 全エージェントがSKILL.mdファイルを採用（Agent Skillsオープンスタンダードに収束傾向）。
ドキュメントディレクトリはエージェント標準では規定されていない。docs/が一般的な慣例。
整理を始める前に、対象リポジトリで以下を検出する:
docs/が存在するか、なければ作成先を提案検出結果をAskUserQuestionでユーザーに確認し、以降の作業で使用する。
まず「0) パス検出」でエントリポイント・ドキュメントディレクトリ・スキルディレクトリを特定した上で、以下を分析する:
エントリポイントの行数とトークン概算を計測
ドキュメントディレクトリの状態を確認
スキルディレクトリの状態を確認
Serena memoryの状態を確認（--migrate-memory指定時）
.serena/memories/の内容を一覧以下の形式でユーザーに報告する:
## 現状分析レポート
### エントリポイント（{検出したファイル名}）
- 行数: X行（目標: 300行以下）
- 状態: 適正 / 肥大化
- 含まれる情報の内訳:
- ナビゲーション: X行
- 知識（ドキュメント移動候補）: X行
- 手順（スキル移動候補）: X行
- ポリシー: X行
### ドキュメント（{検出したパス}）
- 状態: 未作成 / 不足 / 適正
- 不足している知識: [リスト]
### スキル（{検出したパス}）
- 状態: 適正 / 知識混入あり
- 問題のあるスキル: [リスト]
### Serena Memory（該当時）
- 移行対象: X件
- ドキュメント移動: X件
- スキル移動: X件
- 削除候補: X件
AskUserQuestionで以下を確認:
以下のルールで再配置:
| Memory種別 | 移行先 |
|---|---|
| リポジトリ構造 | ドキュメント |
| アーキテクチャ説明 | ドキュメント |
| モジュール説明 | ドキュメント |
| 依存関係 | ドキュメント |
| エージェント手順 | スキル |
| 一時的な調査結果 | 削除 |
| タスク履歴 | 削除 |
整理後に以下を検証:
## 整理完了レポート
### 変更サマリー
- エントリポイント: X行 → Y行（Z行削減）
- ドキュメント: X件のファイルを追加/更新
- スキル: X件のスキルを整理
- Serena memory: X件を移行、Y件を削除候補
### 作成/変更したファイル
- [ファイル一覧]
### 次のステップ
- [ ] 変更内容のレビュー
- [ ] 不要なSerena memoryの削除（手動確認推奨）
- [ ] コミット＆PR作成（`/ndf:pr`）
整理時は以下を遵守:
--dry-run指定時はレポートのみ出力し、ファイルを変更しない