mcpField
E
eng-architect

eng-architect

github.com/timlai666開発050 回インストール1 日前に更新
リポジトリ

eng-architect について

eng-architectは、エンジニアリングのアーキテクチャ設計、チケット計画、UIレビューを支援するスキルです。目的に応じてワークフローを使い分け、根拠に基づく分析、トレードオフの明示、検証可能な引き継ぎを重視します。

主な機能

  1. 01アーキテクチャとチケット計画
  2. 02UI批評とデザインレビュー
  3. 03目的に応じたワークフロー選択
  4. 04判断とリスクの記録
  5. 05プロジェクト記録の指針

活用シーン

  1. 01モジュール境界と技術作業の計画
  2. 02機能を検証可能なチケットに分割
  3. 03デザイン基準に照らした実際のUIレビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/timlai666/skills --skill eng-architect

インストール後、Claude Code で/eng-architectを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent-context-files.md
delivery-status-guidelines.md
design-review-workflow.md
engineering-workflow.md
handoff-and-feedback-loop.md
legacy-status-migration.md
ticket-breakdown-guidelines.md

詳細

概要

アーキテクチャと検証可能なチケットを設計するか、既存の UI をレビューします。依頼された範囲と既存のプロジェクト上の決定を維持してください。

コマンドの振り分け

依頼された成果からモードを判断します。

  • アーキテクチャ、モジュールの境界、技術計画、またはチケットの場合：機能ごとの分析を始める前に、例も含めて エンジニアリングワークフロー を最後まで読んでください。
  • UI の批評、デザインレビュー、または AI スロップの検査の場合：レビューを始める前に、例も含めて デザインレビューワークフロー を最後まで読んでください。
  • 両方が依頼された場合は、それぞれの成果物に対応するワークフローを使用してください。意図された成果がなお実質的に曖昧な場合に限り、どちらのモードかを尋ねてください。

ワークフローの各ステップで必要になった時点で、ほかの参考資料を読んでください。

共通の意思決定ルール

プロジェクトの情報と過去のユーザーの決定を根拠として使用します。アーキテクチャをまとめる前に、各機能のフロー、失敗時の経路、境界、テスト方針を分析してください。

ユーザーの選択が必要な未解決の決定事項を集め、関連する選択肢を推奨案とその影響とともに提示してください。合意済みの範囲、アーキテクチャ、ワークフロー、または許可されていないその他の重要な選択を変更する前に、確認してください。回答を待つ間も、独立して進められる分析は続けてください。決着済みの決定については、再度尋ねずに再利用してください。

レビューや議論の依頼には、それに対応する分析を提示してください。実装またはチケット作成の依頼が許可されている場合は、合意した境界内で通常の作業を進めてください。

プロジェクトの記録

以下の目的に使われている既存の文書やタスクシステムを使用してください。既存の運用方法がなく、完全な開発の引き継ぎが必要な場合は、ENG.md、delivery-status.md、チケットファイル、AGENTS.md、および CLAUDE.md のポインターを作成してください。範囲が限定されたアーキテクチャ上の決定や UI レビューでは、依頼された成果に必要な記録を選んでください。

ファイルまたは場所目的作成または更新する場合読む場合
ENG.mdチケット間で共有するアーキテクチャ、テスト戦略、前提条件、移行順序共有する技術的な決定を保持する必要がある場合関連するアーキテクチャ、テスト戦略、または移行を変更する前
delivery-status.md現在の進捗、ブロッカー、次に検証可能な成果、次のチケット継続的な進捗管理や引き継ぎが必要な場合。関連する状態の変化に応じて更新作業を引き継ぐ際
docs/tickets/ または既存のチケットシステム各チケットの成果物、受け入れ基準、作業を妨げる依存関係作業の分割または開発への引き継ぎを依頼された場合実装前に、割り当てられたチケットとその依存関係を読む
AGENTS.mdプロジェクトの作業ルール、および補助記録の場所と参照するタイミング調整体制を確立するとき、または作業ルールを変更するときプロジェクト作業を開始する前
CLAUDE.mdエージェントを AGENTS.md に案内するエントリーポイント標準の調整体制を確立するとき。実際のルールは AGENTS.md に記載プロジェクトルールへのエントリーポイントとして
DESIGN.mdUI レビューの視覚的な基準このスキルでは読み取りますが、作成または上書きはしませんデザイン基準に照らして UI をレビューする前
DESIGN-REVIEW.mdUI の評価、未解決の指摘事項、コンポーネントのレビュー結果永続的なレビュー記録が必要で、既存の運用方法で対応できない場合。以降のレビュー時にも更新UI を再レビューする前

既存の内容を更新する前に読み、無関係なセクションは保持してください。実際に作成した成果物のパスと、参照が必要となるタイミングを記録してください。共有する技術的な決定はアーキテクチャの記録に保持し、チケットごとの受け入れ基準は該当するチケットに記載してください。

完了チェック

  • 結果が、依頼されたアーキテクチャ、チケット管理、または UI レビューのニーズに応えています。
  • エンジニアリング分析では、機能フロー、障害、インタラクションの境界、テスト、および該当する移行リスクを扱っています。チケット管理では、分析した各受け入れ項目に担当者を割り当て、実際のブロッカーを記録しています。
  • UI レビューの指摘は、実際にレンダリングされた画面と関連するインタラクションに基づいています。許可された修正は、レンダリング結果で再確認されています。視覚的な証拠が不足している場合は、その旨が報告されています。
  • 未解決の前提と決定が明示されています。プロジェクトで求められる検証および納品のルールに従っています。
  • 更新された記録には、無関係な内容も保持され、実際の情報源へのリンクがあり、引き継ぎ時に次に検証可能なアクションが示されています。

コメント

Markdown 対応