Skip to content

各生成ピースに閉ループを内蔵し、validate-*ピースを廃止する #37

@j5ik2o

Description

@j5ik2o

概要

現在、SDD パイプラインでは「生成ピース」と「検証ピース」が分離されているが、各生成ピースに閉ループ(レビュー→修正→再レビュー)を内蔵し、ピース単体で品質を担保する設計に統一する。

背景

現状の問題

  1. 2つのパターンが混在している

    • cc-sdd-impl / opsx-apply はピース内部に閉ループを持っている(plan↔implement, ai_review↔ai_fix, reviewers↔fix, supervise)
    • cc-sdd-requirements / cc-sdd-design / cc-sdd-tasks は閉ループなしで、外部の validate-* ピースに検証を委ねている
  2. cc-sdd-full はすでに閉ループを内蔵している

    • full ピース内では generate-designvalidate-design → NO-GO → generate-design のループが組まれている
    • つまり full が takt 的に正しい設計で、個別ピースの方がその原則に追いついていない
  3. 外部 validate の弊害

    • ピースの完結性が崩れる(品質未保証のまま出力)
    • パイプラインが冗長(generate + validate で2ピース)
    • 個別実行時に validate を忘れると品質が落ちる

対象ピースと作業

完了済み

  • cc-sdd-requirementsreview-requirementsfix-requirements ループ追加済み
    • 作成済みファセット:
      • facets/instructions/cc-sdd-review-requirements.md
      • facets/instructions/cc-sdd-fix-requirements.md
      • facets/output-contracts/cc-sdd-requirements-review.md
      • facets/policies/cc-sdd-requirements-review.md

TODO

  • cc-sdd-designreview-designfix-design ループ内蔵

    • cc-sdd-validate-design のムーブメントを cc-sdd-design に統合
    • 既存ファセット(cc-sdd-validate-design.md, cc-sdd-fix-design.md, cc-sdd-design-review.md)を再利用可能
  • cc-sdd-tasksreview-tasksfix-tasks ループ内蔵

    • タスク分解の品質レビュー(要件カバレッジ、タスク粒度、依存関係の妥当性)
    • 新規ファセット作成が必要
  • cc-sdd-full の更新 — 個別ピースと同じ閉ループ構造に統一

    • 現在の validate-design ムーブメント名を review-design に統一するなど
  • validate-* ピースの廃止検討

    • cc-sdd-validate-designcc-sdd-design に統合後、廃止
    • cc-sdd-validate-implcc-sdd-impl に統合後、廃止(※cc-sdd-impl にはすでに supervise があるので、並列レビューの追加を検討)
    • cc-sdd-validate-gap — ギャップ分析は「レビュー」ではなく「分析」なので、別ピースとして残す方が妥当

設計方針

  • cc-sdd-validate-design のパターン(validate→fix→validate ループ + loop_monitors)を各ピースに踏襲
  • レビュー側は edit: false(読み取り専用)、修正側は edit: true
  • レビューには生成者と異なるペルソナ(supervisor 等)を使う
  • loop_monitors の閾値は 3(非生産的ならABORT)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions