Skip to content

INCEPTION 산출물 셀프리뷰 체크리스트 도입 (superpowers v5.0.6 참조) #143

@bluejayA

Description

@bluejayA

BL-079: INCEPTION 산출물 셀프리뷰 체크리스트 도입

배경

superpowers v5.0.6에서 brainstorming, writing-plans 스킬의 서브에이전트 리뷰 루프를 인라인 셀프리뷰 체크리스트로 교체. 결과: 25분 → 30초, 품질 유사.

분석

superpowers가 변경한 것:

  • brainstorming Spec Review Loop → Self-Review checklist (30s vs 25min)
  • writing-plans Plan Review Loop → Self-Review checklist
  • "3-5 real bugs caught per run with comparable quality to subagent approach but 50x faster"

brainstorming 셀프리뷰 체크리스트 항목:

  1. Placeholder scan — TBD, TODO, 불완전 섹션, 모호한 요구사항?
  2. Internal consistency — 섹션간 모순? 아키텍처와 기능 설명 일치?
  3. Scope check — 단일 구현 계획으로 분해 가능? 아니면 추가 분해 필요?
  4. Ambiguity check — 두 가지 해석이 가능한 요구사항?

writing-plans 셀프리뷰 체크리스트 항목:

  1. Spec coverage — 스펙의 각 섹션/요구사항에 대응하는 구현 태스크가 있는가? 갭 나열
  2. Placeholder scan — TBD, TODO, 모호한 단계, 누락된 코드 블록 등 red flag 검색
  3. Type consistency — 타입, 메서드 시그니처, 속성명이 태스크 간 일관적인가?

핵심 인사이트:

  • 셀프리뷰 ≠ 외부 리뷰 대체. superpowers도 구현 단계에서는 여전히 서브에이전트 리뷰 사용
  • 설계 산출물(INCEPTION 단계)에만 셀프리뷰로 전환한 것
  • "Fix any issues inline. No need to re-review — just fix and move on."

적용 대상

  • aidlc-brainstorming — 설계 산출물 작성 후 인라인 셀프리뷰 체크리스트 추가
  • aidlc-writing-plans — 구현 계획 작성 후 인라인 셀프리뷰 체크리스트 추가
  • 기존 5개 리뷰 에이전트 디스패치 전에 셀프리뷰를 먼저 실행하여, 리뷰어에게 넘어가는 산출물 품질 향상

기대 효과

  • INCEPTION 단계 토큰/시간 절감 (서브에이전트 왕복 제거)
  • 리뷰 에이전트 부하 감소 (기본적인 품질 이슈는 셀프리뷰에서 처리)
  • 난이도 낮음 — SKILL.md에 체크리스트 섹션 추가만으로 구현 가능

참조

  • superpowers v5.0.6 릴리스 노트
  • superpowers/skills/brainstorming/SKILL.md (lines 116-124)
  • superpowers/skills/writing-plans/SKILL.md (lines 122-133)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions