simplify-work

作業の簡素化

意図した動作を維持しながら、選択した領域を理解、変更、検証しやすくします。

engineering-discipline.md を使用してください。直接指定されたスコープ、引き継ぎ、レビューでの指摘、または Plan を入力として受け付けます。

境界

• リポジトリの指示と関連する最新のドキュメントを読み、ワークスペースを調べて、既存の変更をタスクの作業と取り違えないようにします。
• 編集前に、対象範囲、意図した動作、呼び出し元、制約、検証方法を確認します。
• デフォルトでは、リポジトリ全体を調査したり、Plan や引き継ぎを作成したり、聞き取りを行ったり、HTML を生成したりしないでください。
• 行数を目標にしないでください。読者の負担を減らせる場合は、概念、分岐、レイヤー、可変状態、重複したルールを減らすことを優先します。
• 無関係な未コミット作業や、既存のドラフト、プロトタイプはそのまま残します。処置が明確な、タスクで作成した成果物だけを整理します。
• 変更に新しいプロダクト動作、宣言済みの互換性契約の変更、または未解決のアーキテクチャ配置が必要な場合は、作業を止めてオーナーの判断を仰ぐか、探索を improve-architecture に引き継ぎます。

簡素化

1. 対象を絞った動作確認を用意します。既存の証拠では重要な動作を保護できない場合に限り、特性テストを追加します。
2. 関連する呼び出し元、データ、コンポーネント、制御フローをたどり、負担の原因となっている偶発的な構造を特定します。
3. 読者の負担を減らせる場合は、削除、直接的なデータフロー、正規の所有関係、無効な状態や散在する分岐をなくす型やデータモデルを優先します。
4. 各変更は、推論と検証ができる程度に小さく保ちます。無関係な整理や、推測に基づく抽象化は避けます。
5. 作業を進めながら対象を絞ったチェックを実行し、その後、関連する回帰テストまたは受け入れ基準を実行します。結果も確認します。

Plan に基づく作業では、指定されたフェーズ、または次の未チェックのフェーズを選び、そのチェックポイントに従います。証拠で裏付けられた場合に限り、Tasks または受け入れ基準を更新します。そのフェーズの Doc Delta と参照先のドラフト作業だけを適用し、新たなレビューと修正を経てから、Plan やドキュメントを更新し、完了としてマークします。Plan や Roadmap の整理は最終レビューまで残します。Plan がない場合は、Plan の手順を独自に作らないでください。

対象範囲を締めくくる

動作が維持されていることと、結果によって読者の負担が実質的に軽減されていることを自己確認します。最新のパッチだけでなく、対象範囲全体を review-work を通じて独立した新しいコンテキストのレビュアーに送り、認められた指摘を一次証拠と照合して検証し、許可されたブロッキング指摘を修正して、影響を受けるチェックを再実行します。簡素化の内容、動作を裏付ける証拠、残るリスクを簡潔に報告します。