architect について
architect は、実装ファイルを編集せずに構造上の方針を決め、アーキテクチャを記録するリポジトリ向けスキルです。機会の発見から証拠の確認、記録の確定までを案内します。
主な機能
- 01対象選定前の機会発見
- 02アーキテクチャ手順に沿った証拠確認
- 03構造上の決定と影響の記録
- 04リポジトリ内での記録確定
活用シーン
- 01変更に構造の再設計が必要か判断
- 02責任範囲とアーキテクチャ制約の記録
- 03blueprint の計画前に未知事項と証拠を整理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ akshay-diwadkar/ first-four-hours --skill architectインストール後、Claude Code で/architectを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdskill-protocol.jsonagents/openai.yamlreferences/architecture-protocol.mdarchitecture-template.mdcalibration-examples.mddelegation-protocol.mdopportunity-discovery.mdstructural-techniques.mdworked-examples.mdscripts/_diagnostic_contract.py_skill_protocol_runtime.pyarchitecture_contract.pyarchitecture_handoff.pyarchitecture_workspace.pycli.pyseal_assessment.py詳細
アーキテクト
権限
アーキテクチャを決定します。対象が指定されていない場合は、対象、no-design-change、またはブロッカーを選ぶ前に機会の発見を実行します。blueprint 用に、無視対象の .first-four-hours/architectures/<slug>/architecture.md を確定します。実装ファイルは編集しません。
アーキテクチャの段階で止めます。実装の階層を分類したり、全体への波及を網羅的に調査したり、ファイル単位の編集を指示したり、テストや実行のブループリントを書いたり、移行や展開の順序を決めたり、実装に着手したりしてはいけません。これらは blueprint の責務です。パスや任意のビューは判断材料であり、編集指示ではありません。
ワークフロー
- アーキテクチャプロトコルに従います。アプローチを確定する前、失敗または方向転換の後、確定前に
reasonを参照します。構造的手法は、プロトコルまたは発見プロセスで参照された場合に限り読み込みます。 - 任意の証拠収集担当者または必要性が認められた専門家レビューに限り、範囲限定委任プロトコルを使用します。
- 引き継ぎテンプレートから草案を作成します。
- 実例は任意の代替案、ユーザーポリシー、またはビューの調整に限り使用します。対象を単一のモジュールまたはクラス内に設定する場合や、
no-design-change以外の構造を選ぶ場合は、調整例を先に確認します。 - 一度だけ確定します。
python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
--input draft=/absolute/architecture-draft.md \
--input slug=<architecture-slug> --format json run
確定した構造上の事実を記録します。これには、変更の必要性または変更なしという判断、責任範囲と境界、制約、選択したアーキテクチャ、影響、証拠、信頼に関わる未解決事項、およびユーザーが決定するポリシーが含まれます。
完了
コマンドが .first-four-hours/architectures/<slug>/architecture.md を result.path とする status: complete を返した場合にのみ完了です。result.git_ignored を報告します。確定に失敗した場合は、指定された草案またはワークスペースの競合を修正して再実行します。証拠に変化があった場合は、新しいスナップショットに基づいて更新し、確定します。最終報告と停止報告では、「Checkpoint trace」に従って reason のチェックポイントを記録します。この結果に合った任意の次のステップを一つ提示して終了します。必要なリポジトリ、issue、PR、または成果物を明記した、フェンス付きの自己完結型プロンプトを示すか、次のステップは不要と伝えます。「yes」の場合に限り、指定されたスキルを使って次のステップを開始します。ただし、ユーザーが charter、diagnose、または ticket のステップを、その /<skill> コマンドとして実行します。