構造化されたAIワークフロー：段階ベースのコマンドによる手戻りの削減

r/ClaudeAIで、ある開発者が、AIを日常的な開発に使用する際の持続的な問題に対処するために設計された、繰り返し可能でプログラム可能なワークフローについて説明しています。特定された核心的な問題は、より賢いモデルが必要なのではなく、同じ間違いを繰り返さないための繰り返し可能なプロセスが必要だということでした。主な課題点には、AIがセッション間でコンテキストを失うこと、命名やスタイルなどの基本事項でプロジェクト標準を破ること、計画と実行を混同すること、ドキュメントを後回しにすることが含まれていました。

フェーズベースのコマンドワークフロー

この解決策は、単一の巨大なプロンプトへの依存を、明確なフェーズ固有のコマンドのシリーズに置き換えます：

• /pwf-brainstorm – スコープ、アーキテクチャ、決定事項を定義します。
• /pwf-plan – ブレインストーミングを実行可能なフェーズとタスクに変換します。
• オプションの品質ゲート: /pwf-checklist, /pwf-clarify, /pwf-analyze。
• /pwf-work-plan – 計画をフェーズごとに実行します。
• /pwf-review – より深いレビューを実行します。
• /pwf-commit-changes – 構造化されたコミットでタスクを完了します。

小さなタスクの場合、開発者は/pwf-workを使用しますが、レビューとドキュメントの規律は維持します。

重要なルール

品質に最も大きな影響を与えたルール：/pwf-workと/pwf-work-planは、実装前にドキュメントを読み、その後で更新することが必須です。これにより、AIが「半盲状態」ではなく「プロジェクトの記憶」で作業するようになり、一貫性が劇的に向上し、再作業が減少します。

サポートするプロジェクト構造

このワークフローは、AIのコンテキストを改善するための特定のプロジェクト構造によってサポートされています：

• コードリポジトリ用のフォルダー1つ。
• ワークスペースアセット（ドキュメント、コントロール、設定）用のフォルダー1つ。

両方のフォルダーは、エディター（VS CodeやCursorなど）でマルチルートとして開かれ、AIが混乱なく完全なシステムを見られるモノレポのような体験を提供します。

結果と参考文献

開発者は、直接的な影響を報告しています：繰り返される間違いの減少、再作業の減少、セッション間での一貫性の向上、エラーが少なくより多くのアウトプット。彼らは、同じエラーループを避けることで、1日で25のタスク（小、中、大）を完了したと述べています。このアプローチは、Compound Engineering、Superpowers、Spec Kit、Spec-Driven Developmentなどの概念を研究することで得られましたが、フレームワークをコピーするのではなく、個人的な使用を通じて適応・改良されました。