メニュー
プロジェクトを分析してARCHITECTURE.mdを自動生成するスキル。 以下の場合に使用: (1) プロジェクトのアーキテクチャを文書化したい時 (2) システム構成図(Mermaidダイアグラム)を作成したい時 (3) コードマップやディレクトリ構造を整理したい時
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | architecture-md-generator |
| description | プロジェクトを分析してARCHITECTURE.mdを自動生成するスキル。 以下の場合に使用: (1) プロジェクトのアーキテクチャを文書化したい時 (2) システム構成図(Mermaidダイアグラム)を作成したい時 (3) コードマップやディレクトリ構造を整理したい時 |
| disable-model-invocation | true |
プロジェクトを分析してARCHITECTURE.mdを自動生成します。既存のプロジェクトメタデータ(CLAUDE.md、AGENTS.md)を参照しながら、システム図、外部依存関係、コードマップを含む包括的なアーキテクチャドキュメントを作成します。
目的: 既存のプロジェクトメタデータを収集
手順:
注意:
目的: プロジェクトの構造と依存関係を把握
ディレクトリスキャン:
- Glob/Grepツールを使用
- 主要なディレクトリとファイルを特定
- 設定ファイル(package.json, requirements.txt, Cargo.tomlなど)を検出
外部依存検出:
- API呼び出しやHTTPクライアント使用箇所を検索
- 環境変数(.env, .env.example)をチェック
- データベース接続やサードパーティサービスを特定
目的: 収集した情報をARCHITECTURE.mdにまとめる
生成する内容:
基本原則:
例:
flowchart TD
Client[クライアント]
API[API Server]
DB[(Database)]
Cache[(Redis)]
Client --> API
API --> DB
API --> Cache
推奨事項:
生成されるARCHITECTURE.mdは以下の構造に従います:
# Architecture
## Overview
> **Note:** プロジェクトの詳細な概要については CLAUDE.md または AGENTS.md を参照してください。
[1-2文の簡潔なプロジェクト説明]
## System Diagram
```mermaid
[Mermaidダイアグラム]
| Service | Purpose | Configuration |
|---|---|---|
| [name] | [desc] | [env var] |
[ディレクトリ構造ツリー]
[各ディレクトリの説明]
## References
詳細なテンプレートと例については以下を参照:
- `references/TEMPLATE.md`
- `references/EXAMPLES.md`
TerraformプロジェクトのAWSインフラにおけるネットワーク接続性と権限設定を分析します。セキュリティグループ、IAMポリシー、NACLなどを解析し、リソース間の通信可否、不要な接続、権限の過不足を検出します。Terraformファイルやtfstateがあるプロジェクトで、インフラのセキュリティレビューやネットワーク接続の検証が必要な場合に使用します。
要求定義書のレビューを行うスキル。品質チェック・矛盾検出・抜け漏れ検出・曖昧性分析を実施し、 構造化レポートを出力する。以下の場合に使用: (1) 要求定義書・要件定義書をレビューしたい時、 (2) 要求の品質や完全性を確認したい時、 (3) 矛盾・抜け漏れ・曖昧な表現を検出したい時
言語非依存のプログラミングベストプラクティスとガイドライン。コードを書く・関数/クラス/モジュールを実装する・プログラムを新規作成するあらゆる場面でPROACTIVELYに使用すること。コーディング開始前に必ずこのスキルを読み込む。コードレビュー・設計レビューにも使用する。
言語非依存の単体テストベストプラクティスとガイドライン。テストコードを書く・テストケースを追加する・テストスイートを作成するあらゆる場面でPROACTIVELYに使用すること。テストコーディング開始前に必ずこのスキルを読み込む。既存テストのレビューにも使用する。
仕様からテストケースを体系的に生成するスキル。状態機械・自然言語・Mermaid・シーケンス図など多様な入力形式に対応し、CSP安定失敗モデルに基づいて受理テストケース（トレース集合内）と拒否テストケース（トレース集合外）を網羅的に導出する。活性・到達可能性・安全性の3性質を検証するテストスイートを生成する。要求定義・仕様記述・設計成果物からのテストケース生成、テスト設計レビュー、テストカバレッジ分析に使用する。
CSPの安定失敗モデルに基づく状態機械ベースの形式仕様書を作成するスキル。 機能要求（活性・到達可能性・安全性）を入力として、 状態変数・遷移（イベント[ガード]/事後条件）・失敗集合を定義する トップレベル仕様およびコンポーネント仕様を生成する。 画面表示を持つシステムでは画面表示関数も定義する。