software-factory

Software Factory

Software Factory は、製品の意図、技術的な意図、実装作業を、追跡可能な 1 つのワークフローで結び付ける AI ネイティブな SDLC 手法です。

このスキルは、Software Factory MCP を効果的に活用できるようにし、このリポジトリで信頼性と追跡可能性を確保しながら Work Order を実行する手順を案内します。

レコード

• ナレッジベースには、調査資料、会議メモ、設計成果物など、プロジェクトのドキュメントやファイルが格納されます。
• Requirements は外部の視点からシステムを記述します。つまり、ユーザーのために何を実現する必要があるのか、そしてその理由を示します。
• Blueprints は内部の視点からシステムを記述します。つまり、コンポーネント、契約、アーキテクチャを示します。
• Work Orders はデリバリー内容を記述します。変更の実装可能な範囲、その対象外となるもの、関連付けられる Requirements と Blueprints を示します。
• Feedback は、製品のユーザーから寄せられた要望や報告です。
• Themes は、共通の根本原因を持つ Feedback 項目をまとめたものです。これにより、まとめてトリアージし、1 つの Work Order で対処できます。

レコードの作成

ナレッジベースのドキュメント、Requirement、Blueprint、Work Order、Feedback 項目、Theme を作成または変更する前に、Software Factory MCP を通じて、その種類のレコードに関するプロジェクトの現行の執筆ルールを確認してください。list_skills を呼び出して該当するレコードの執筆ルールを見つけ、次にそのスキルで read_skill を呼び出し、参照されている子スキルもすべて読んでください。ルールに記載されているとおりにレコードを作成してください。Software Factory MCP を利用できない場合は、作業を中止してユーザーに伝えてください。

実装時は、コーディングを始める前に、@… による言及とリンクを含め、参照されているすべての Blueprint を Software Factory MCP を通じて読んでください。

ルーティング

タスク	読むもの
1 つの Work Order を実行する	execution/execute-work-order.md
複数の Work Order を実行する	execution/execute-work-order.md
実行中に実装計画を作成する	execution/writing-implementation-plans.md
レビューを実施する	execution/review.md
実行ディレクトリを初期化する	execution/scripts/init-wo-execution.sh
実行コンテキストを更新する	execution/scripts/update-context-index.sh
Software Factory のレコードを作成または変更する	Software Factory MCP を通じたプロジェクトスキル

Work Order の実行

すべての Work Order で実行プロセスに従ってください。チェックリストのすべての項目を、完了として [x] を付けるか、スキップ理由を添えて [SKIP] と記すかの、いずれかの状態にしてください。未チェックの項目がある場合、実行は失敗です。

単一の Work Order と複数の Work Order のキューには、execution/execute-work-order.md に従ってください。また、そのガイドで参照されている場合は、execution/ 内の関連ファイルを読んでください。実行ファイルには作業の進め方が記録され、Software Factory MCP の執筆ルールはレコードそのものを規定します。

チェックリストは、継続的に改善するハーネスエンジニアリングの成果物です。チームは、エージェント型プログラミングの信頼性を高めるために、コードベースに合わせた正確なコマンド、チェック、スクリーンショット、マイグレーション、フィクスチャ、シードデータ、CI ゲート、レビュー手順を加えて、チェックリストを進化させていきます。

ユーザーまたはリポジトリのワークフローから求められた場合に限り、コミット、プッシュ、プルリクエストの作成、またはマージを行ってください。