architecture-expert
アーキテクチャ設計（境界/依存/データフロー/非機能/運用）を、制約とトレードオフで言語化し、ADR-liteで合意形成しながら段階的に形にする。doc/input/rdd.md にアーキテクチャ/非機能/運用の要求がある、または設計判断（分割/責務/インタフェース/データ整合/観測性/スケール）相談で使う。
Best use case
architecture-expert is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
アーキテクチャ設計（境界/依存/データフロー/非機能/運用）を、制約とトレードオフで言語化し、ADR-liteで合意形成しながら段階的に形にする。doc/input/rdd.md にアーキテクチャ/非機能/運用の要求がある、または設計判断（分割/責務/インタフェース/データ整合/観測性/スケール）相談で使う。
Teams using architecture-expert should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/architecture-expert/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How architecture-expert Compares
| Feature / Agent | architecture-expert | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
アーキテクチャ設計（境界/依存/データフロー/非機能/運用）を、制約とトレードオフで言語化し、ADR-liteで合意形成しながら段階的に形にする。doc/input/rdd.md にアーキテクチャ/非機能/運用の要求がある、または設計判断（分割/責務/インタフェース/データ整合/観測性/スケール）相談で使う。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Architecture Expert Skill ## 発火条件（リポジトリ判定） - まず `doc/input/rdd.md` を確認し、非機能要件/制約/運用要件/参照が存在する場合、このSkillを優先適用する。 - 記載が薄くても、依頼が「構造」「責務分離」「データフロー」「境界」「スケール」「運用」「観測性」「ADR」なら適用する。 ## このSkillの基本方針（整理軸） - 基本方針: 正解を断言しない。制約→選択肢→トレードオフ→決定→検証、の順で合意形成する。 - 設計対象: コンポーネント境界/依存方向/インタフェース/データ所有権/失敗時の振る舞い/運用（監視・ログ・復旧）までを含める。 - 進め方: まず最小の全体像（1枚の図）を作り、次に「一番危険な不確実性」を潰す。 ## 思想（判断ルール） 1. アーキテクチャは図ではなく「制約の設計」。制約が変われば最適解も変わる。 2. 境界を先に決める（責務・所有・依存方向）。境界が曖昧だと実装が必ず溶ける。 3. 非機能は後付けしない（性能/可用性/セキュリティ/運用）。要求が不明なら短問で確認する。 4. 失敗は必ず起きる前提で、検知→切り分け→復旧の導線を設計に含める。 5. 決定は記録する（ADR-lite）。将来の「なぜ？」に答えられる形にする。 ## 進め方（最初に確認する問い） - 目的は何？（誰の、どの課題を、どこまで解くか） - 非機能の優先順位は？（性能/可用性/セキュリティ/コスト/速度） - 制約は？（納期/チーム/既存資産/運用体制/外部依存） - 失敗時はどうあるべき？（許容停止時間、データ損失許容、リトライ方針） - 変更頻度が高いのはどこ？（境界を置く候補） ## 出力フォーマット（必ずこの順） 1. 推奨アーキテクチャ方針（1〜3行） 2. 前提（制約/優先順位） 3. 選択肢（2〜3案）とトレードオフ 4. 決定（採用案）と理由（ADR-lite） 5. データフロー/境界（簡易図 or 箇条書き） 6. 失敗時の振る舞い（検知/復旧/ロールバック） 7. 次アクション（最小検証順） ## チェックリスト（設計レビュー用） ### 境界と依存 - [ ] 責務が「1つの理由」で変更される単位になっているか（SRP） - [ ] 依存方向が一貫しているか（内側が外側に依存していないか） - [ ] データの所有者が明確か（どこが真実の源か） ### 非機能 - [ ] 重要な非機能（性能/可用性/セキュリティ/運用）が明文化されているか - [ ] ボトルネック仮説と計測方法があるか（根拠なき最適化になっていないか） ### 運用・観測性 - [ ] ログの粒度が切り分けに足りるか（相関ID/主要イベント） - [ ] 監視すべき指標が定義されているか（SLI/SLOの仮置きでも可） - [ ] ロールバック/移行手順が用意されているか ## よくある落とし穴 - 図だけ綺麗で、非機能/運用が未定義のまま実装に入る - 早すぎるマイクロサービス化で、運用コストが爆増する - 境界が曖昧で、責務が横断し続ける（結局「巨大モジュール」に戻る）
Related Skills
awesome-copilot-root-typescript-mcp-expert
Expert assistant for developing Model Context Protocol (MCP) servers in TypeScript Use when: the task directly matches typescript mcp expert responsibilities within plugin awesome-copilot-root. Do not use when: a more specific framework or task-focused skill is clearly a better match.
awesome-copilot-root-rust-mcp-expert
Expert assistant for Rust MCP server development using the rmcp SDK with tokio async runtime Use when: the task directly matches rust mcp expert responsibilities within plugin awesome-copilot-root. Do not use when: a more specific framework or task-focused skill is clearly a better match.
awesome-copilot-root-php-mcp-expert
Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery Use when: the task directly matches php mcp expert responsibilities within plugin awesome-copilot-root. Do not use when: a more specific framework or task-focused skill is clearly a better match.
awesome-copilot-root-laravel-expert-agent
Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices Use when: the task directly matches laravel expert agent responsibilities within plugin awesome-copilot-root. Do not use when: a more specific framework or task-focused skill is clearly a better match.
awesome-copilot-root-kotlin-mcp-expert
Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK. Use when: the task directly matches kotlin mcp expert responsibilities within plugin awesome-copilot-root. Do not use when: a more specific framework or task-focused skill is clearly a better match.
awesome-copilot-root-drupal-expert
Expert assistant for Drupal development, architecture, and best practices using PHP 8.3+ and modern Drupal patterns Use when: the task directly matches drupal expert responsibilities within plugin awesome-copilot-root. Do not use when: a more specific framework or task-focused skill is clearly a better match.
automation_expert
自动化流程与脚本专家，擅长使用 Python, PowerShell, Shell 及各类工具实现任务自动化。
async-expert
Expert in asynchronous programming patterns across languages (Python asyncio, JavaScript/TypeScript promises, C# async/await, Rust futures). Use for concurrent programming, event loops, async patterns, error handling, backpressure, cancellation, and performance optimization in async systems.
astro-architecture
Technical architecture for Astro lead generation websites. Use when setting up new projects, configuring build tools, or establishing project foundations. For images use astro-images skill. For SEO use astro-seo skill.
assessing-architecture-quality
Use when assessing codebase architecture and you feel pressure to soften critique, lead with strengths, or frame problems diplomatically - provides evidence-based critical assessment resisting relationship and economic pressures
ask-expert
Creates expert consultation documents with code extraction, git diffs, and size tracking (125KB limit). Use when user asks to "create an expert consultation document", "prepare code for expert review", "gather architecture context", or needs comprehensive technical documentation for external analysis. Requires Node.js 18+.
arm-cortex-expert
Senior embedded software engineer specializing in firmware and driver development for ARM Cortex-M microcontrollers (Teensy, STM32, nRF52, SAMD).