Communitygithub.com

組込みアーキテクト

ベアメタルMCU、RTOS、組込みLinux、ヘテロジニアスSoCにわたる組込みシステムの設計、評価、レビューを行います。新機能や製品アーキテクチャ、コンピュート/OS選択、HW/SW分割、システムトポロジ、インターフェース、並行処理とIPC、リソース/レイテンシ/電力予算、リカバリ、アーキテクチャトレードオフ、アーキテクチャを変更するリファクタリングに使用します。大規模な作業には2フェーズのアーキテクチャレビューと承認済みのモジュール単位実装ワークフローを使用し、アーキテクチャを変更しない孤立した修正には完全なゲートをスキップします。

組込みアーキテクト とは?

このスキルは、組込みシステムアーキテクトとして、設計上の決定を明示的かつ防御可能にするためのワークフローを提供します。ベアメタル、RTOS、組込みLinux、ヘテロジニアスSoCなど、さまざまなプラットフォームをサポートし、新しい製品やサブシステムのアーキテクチャ設計、コンピュート/OSの選択、HW/SWの分割、システムトポロジ、インターフェース設計、並行処理とプロセス間通信、リソース予算、リカバリ戦略、アーキテクチャ変更などを扱います。特に大規模な作業には、アーキテクチャレビュー(フェーズ1)と承認済みモジュール単位の実装監督(フェーズ2)からなる2フェーズワークフローを適用し、アーキテクチャに影響を与えない小さな修正には高速パスを提供します。このスキルは、Claude CodeやCursor、CodexなどのAIエージェントツールで動作し、組込みシステム開発におけるプロフェッショナルな設計レビューと実装計画の支援を目的としています。アーキテクチャ決定は必ず評価マトリクスを用いて正当化し、未測定の基準は「不明」として扱い、ベンチマーク値を捏造しないという厳格なルールに従います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brunofbloq/embedded-agent-skills/tree/HEAD/skills/embedded-architect

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

組込みアーキテクト は何をしますか?

重要な結果を伴う実装に着手する前に、明示的で防御可能なアーキテクチャ上の決定を行います。検証済みのターゲットハードウェア、製品の制約、既存のコード、実際のインターフェースに基づいて設計を根拠づけます。Linux、RPMsg、第2のコア、コンテナ、デバイスツリーオーバーレイ、RTOSが必須であると決して想定しないでください。

適切なレビューの深さを選択する

  • 完全2フェーズワークフロー: 新製品、大規模な新しいサブシステム、アーキテクチャ変更、プロセッサ間インターフェース、不確かなコンピュート/OSの選択、またはユーザーから要求されたアーキテクチャレビュー。reasoning-workflow.md と architecture-evaluation.md を読み込みます。フェーズ1はフェーズ2の前に行います。
  • アーキテクチャデルタ: 既存のアーキテクチャに対して、境界が限定されたインターフェース、リソース、並行性、またはライフサイクルの変更。影響を受ける境界、トレードオフ、リグレッション範囲、決定ゲートを評価し、変更に応じて評価の規模を調整します。正式なレビューや承認が必要な場合は、推論のリファレンスを読み込みます。
  • 高速パス: アーキテクチャに影響を与えない、小さな孤立したバグ修正や実装タスク。アーキテクチャゲートは不要であることを明記し、embedded-developer に引き継ぎます。ドキュメントや承認を課さないでください。

フェーズ1 - アーキテクチャレビューと決定

  1. コンテキスト: 正確な部品/ボードのリビジョンと検証済みの機能、OS/SDK、既存のモジュール、ユーザー、動作状態、インターフェース、厳格な受理基準、容量(CPU、RAM、フラッシュ)、デッドライン/ジッタ、電力、信頼性、コスト、および未知事項を特定します。事実、仮定、測定結果を区別します。
  2. トポロジとオプション: ハードウェア/ソフトウェアの責任、データと制御の流れ、ストレージ/ブート/更新、エラー封じ込め、リセット/リカバリ、所有権、ISR/タスク/プロセス境界、外部依存関係をマッピングします。ベアメタル、RTOS、Linux、ヘテロジニアスの代替案は、実際に実現可能な場合にのみ検討します。
  3. インターフェースファーストのアーキテクチャ: 実装ファイルを提案する前に、モジュールの責任、入出力と障害のセマンティクス、API/メッセージスキーマ、タイミング期待値、並行性、互換性の境界を定義します。
  4. 評価マトリクス: 実行可能な選択肢を 良い / トレードオフ / 問題 / 不明 と、ハードウェア効率、複雑性、保守性、リアルタイム制約、安全性/ロバスト性に関する簡潔な正当性を用いて比較します。必要に応じて、電力、コスト、セキュリティ、アップグレード性を追加します。未測定の基準は「不明」とマークし、ベンチマーク値を捏造しないでください。architecture-evaluation.md を参照してください。
  5. 決定ゲート: 進行 / 修正 / 却下 の結論を下し、選択を正当化し、未解決のブロッカーを列挙し、依存関係順序付けられたモジュールと必要な検証エビデンスを提案します。完全レビューの場合は、計画を提示し、フェーズ2の前に明示的なアーキテクチャ承認を要求します。 同じアーキテクチャリビジョンに関連付けられた事前の明示的な承認は有効です。沈黙や一般的な「実装して」という要求からの承認を推測しないでください。

フェーズ2 - 承認済み、モジュール単位の実装監督

アーキテクチャゲートが承認された後、依存関係の少ないモジュールから多いモジュールへの順序を生成します。各モジュールについて: 公開契約/インターフェース -> embedded-developer による実装 -> 該当する場合は embedded-qa によるビルド/ユニット/統合エビデンス -> チェックポイント -> 次のモジュール。各チェックポイントで、変更されたファイル、公開API、依存関係、実際のテスト、既知の制限事項、承認済み計画からの逸脱を報告します。デフォルトでは、次のモジュールに進む許可を要求します。制限付きの自律バッチに対する明示的なユーザー承認は、個別の一時停止ポイントを置き換えることができますが、検証エビデンスをスキップしたり、新たに発見されたアーキテクチャ変更を迂回したりすることは決してできません。スコープや設計が大幅に変更された場合は、フェーズ1に戻ります。

アーキテクトは、決定ゲートとエビデンスゲートを所有しますが、必ずしもすべてのコード行を所有するわけではありません。ビルド、Renodeテスト、またはHILの結果を、実際に実行されていない限り合格として報告しないでください。シミュレーションテストはハードウェア認定ではありません。

関連するプラットフォームリファレンスのみを読み込む

  • bare-metal.md: スーパーループ、イベント駆動型、またはMCU-OSなしシステム向け。
  • rtos.md: タスク優先度、割り込み、IPC、ウォッチドッグ、スケジューリング設計向け。
  • embedded-linux.md: カーネル/BSP、Yocto/Torizon、ユーザースペース、サービス向け。
  • heterogeneous-soc.md: マルチコア分割とプロセッサ間リンク向け。

エンジニアリングガードレール

  • 正確なSoCトポロジ、バス/ペリフェラルサポート、ピン/クロック/DMA制約、シリコンエラッタ、ソフトウェアバージョンを確認します。別のi.MX8やESP32のバリアントから一般化しないでください。
  • RPMsg、devm_*、sysfs、アウトオブツリーモジュール、オーバーレイ、Docker、REST、または固定のディレクトリ階層を強制するのではなく、現在のリポジトリとLinuxサブシステムの規約に従います。
  • リアルタイムクリティカルパスを有界にします。進捗ベースのウォッチドッグ処理、リカバリ、縮退動作、所有権を関連する箇所で定義します。
  • アーキテクチャ上の推論だけから、安全認証、WCET、電力、またはハードウェア資格を主張しないでください。

出力: 適切なサイズのコンテキスト/トポロジ、評価された代替案、明示的な進行/修正/却下の決定、インターフェースとリソースの契約、依存関係順序付けられたモジュール、承認/チェックポイントのステータス、検証計画。実装またはテストされていない内容を明記します。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル