knowledge-plugin

アーキテクチャレビューの分析・報告エージェント。architecture-reviewerで3種類分析・矛盾検出・優先順位付けを行い、review-report-generatorでレポート生成する。

アーキテクチャレビューのための知識構築エージェント（Phase 1-3）。 システムマップ収集、不変条件抽出、コンポーネントカード作成を順次実行し、 RAGベースの分析基盤を構築する。 使用タイミング: (1) 「アーキテクチャの知識を構築して」、(2) 「システムマップを作成して」、 (3) 「コンポーネントカードを作成して」、(4) アーキテクチャレビューの準備段階

3種類のアーキテクチャ分析（ノード/エッジ/縦串）を並行実行し、矛盾検出・優先順位付けまで一貫して行う。「アーキテクチャレビューして」「設計をチェックして」「矛盾を検出して」「優先順位を付けて」「トレードオフを分析して」と言われた時、またはcomponent-dossiers/*.yamlが存在する時に使用。

コードベースから開発者向けドキュメントを生成する。3パス読み取りアプローチで根拠に基づく信頼性の高いドキュメントを作成。「ドキュメント生成」「コードからドキュメント」「codebase map作成」「代表フロー抽出」「変更ガイド作成」と言われた時に使用。生成するのはコードベースマップ、代表フロー（成功+失敗）、変更プレイブック、設定/外部I/F台帳、検証レポート。継続的開発の属人化を防ぎ、変更の安全性を高めるドキュメントを目指す。

一般的な情報収集・調査を体系的に行うスキル。学術・ビジネス・ジャーナリズム・問題解決・デジタル調査など多分野の手法を網羅。Use when: 「〇〇を調査したい」「情報収集の方法を知りたい」「リサーチの進め方」「調べ方を教えて」「事実確認したい」「市場調査」「競合調査」「文献調査」と言われた時。

一般・技術の両分野に対応した体系的情報収集スキル。調査設計→手法選定→実行→検証の4フェーズで進める。Use when: 調査・リサーチ・情報収集を依頼された時、バグ調査・API調査・市場調査・競合調査・文献調査・ファクトチェック等を行う時。

アーキテクチャレビュー結果を意思決定用レポートに整形する。チャット報告・ファイル出力・GitHub Issue作成から出力形式を選択可能。「レビューレポートを作成して」「報告書を生成して」「意思決定用にまとめて」「Issueにして」と言われた時に使用。

コードからspecを生成するスキル。As-Is spec（現状仕様）を根拠付きで抽出し、3層構造（インターフェース/振る舞い/業務意味）で整理。 使用タイミング: (1)「コードからspecを生成」(2)「仕様書を作成」(3)「APIドキュメント生成」(4)「現状の振る舞いを文書化」(5)「変更で壊れたspecを検出」(6)「コードと仕様の乖離を確認」と言われた時。 生成するのはAs-Is spec（現状仕様）であり、To-Be spec（あるべき仕様）は人間の判断が必要。

アーキテクチャレビューの結果を再統合し、矛盾の検出と優先順位付けを行うスキル。 改善案の大量生成よりも「矛盾の検出」に価値を置き、プロジェクト特性に応じた優先順位を決定する。 使用タイミング: - 「矛盾を検出して」「優先順位を付けて」 - 「レビュー結果を統合して」「トレードオフを分析して」 - architecture-review/*/findings.yaml が存在する時 - 複数の改善案の中から優先順位を決めたい時

システムマップ収集・不変条件抽出・コンポーネントカード作成を統合したスキル。コードベースを調査しアーキテクチャ知識をYAMLで構造化する。「システムマップを作成して」「不変条件を抽出して」「コンポーネントカードを作って」と指示された時、またはプロジェクトの全体像を把握したい時に使う。

技術情報（バグ・ライブラリ・サービス利用方法）を体系的に収集するスキル。事前調査→リサーチ方法選定→情報収集実行の3フェーズで進める。Use when: 「〇〇のバグを調査したい」「ライブラリXのAPIを調べたい」「サービスYの使い方を調べたい」「エラーの原因を調査したい」「最新の情報を収集したい」「技術調査して」「リサーチして」と言われた時。

Comprehensive guide for writing technical books in Markdown format. Use this skill when creating new chapters, managing code examples, reviewing content for technical accuracy and consistency, or organizing book structure (TOC, cross-references). Provides templates, validation scripts, and best practices for technical writing workflows.