Communitygithub.com

Gentleman-Programming/gentle-ai-rdd-defect-workflow

트리거: RDD(영수증 기반 개발), 리뷰 권한, 영수증/계통, 수정/복구, 전달 게이트/킬 스위치, 제한적 리뷰 결함. 작업을 안내합니다.

gentle-ai-rdd-defect-workflow란 무엇인가요?

이 스킬은 RDD(Receipt-Driven Development) 워크플로우에서 결함 수정을 체계적으로 안내하는 AI 에이전트용 규칙입니다. 핵심 원칙은 리뷰 증거를 전달 권한으로 오용하지 않고, 모든 일반 커밋, 푸시, PR, 릴리스는 기존 저장소 정책을 따르도록 강제합니다. 승인된 이슈, 깨끗한 main 브랜치 재현, 원인 불변성 기준으로 그룹화, 400줄 예산 제한, 리드온리 검증, CodeGraph 기반 영향 매핑, 워크트리 격리 등 엄격한 게이트를 통해 품질과 규율을 보장합니다. 이 스킬은 주로 Claude Code, Cursor, Codex와 같은 터미널 기반 AI 에이전트에 적합하며, 이슈 및 PR 메타데이터를 활용해 충돌, 대체, 롤백 경계를 명확히 식별합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gentleman-Programming/gentle-shell/tree/main/skills/rdd-defect-workflow

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

활성화 계약

프론트매터 트리거 조건이 결함 워크플로우에 적용될 때 로드됩니다.

이 스킬은 공개 협업을 안내합니다. 이슈 승인, 레이블 지정, 리뷰, 예외 처리, 병합 권한을 부여하지 않습니다.

엄격 규칙

  • 리뷰 및 심판의 날 증거는 리뷰 전용입니다. Pi는 절대 전달 권한을 부여하지 않습니다. RDD 모드와 관계없이 일반 커밋, 푸시, PR, 릴리스는 항상 저장소 정책을 따릅니다.
  • 구현 전에 승인된 이슈(status:approved) 및 깨끗한 현재 main 재현이 필요합니다. 기존 PR에서 대체 또는 충돌 여부를 감사하고, 오래된 주장을 중지하거나 축소합니다.
  • 인과적 권한 불변성 기준으로 그룹화합니다. 독립적인 불변성 및 롤백 경계마다 하나의 이슈와 하나의 PR 또는 명시적 체인을 사용합니다. 독립적인 원인을 분할하고, 대체되거나 충돌하는 권한 라인을 절대 병합하지 않습니다.
  • 이슈나 PR이 주장하는 모든 운영자 흐름(진입점, 모드, 환경, 기대치, 음성 제어 포함)을 인벤토리로 작성합니다. CLI 또는 라이프사이클 흐름당 하나의 진실한 블랙박스 벤치 여정, 또는 코어 벤치가 이를 대표할 수 없을 때 실제 런타임 E2E 증명이 필요합니다. 합성 프록시 커버리지는 다른 런타임을 증명하지 않습니다.
  • CodeGraph 우선 영향 매핑, 전용 워크트리, 행동 우선 테스트를 사용합니다. 후보 군 전에 소스 변형 정규화를 실행합니다.
  • 편집 전에 변경 사항을 예측합니다. 추가 및 삭제의 합계가 400줄을 초과하면 체인 또는 명시적 유지관리자 승인 예외를 위해 중지합니다.
  • RDD가 활성화되면 리뷰 영수증, 계통, 수정, 복구 증거를 정확한 후보에 바인딩합니다. 제한적 리뷰 결함을 하나의 수정 트랜잭션으로 유지하고, 해당 증거를 전달 권한으로 취급하지 않습니다.
  • 게시 전에 독립적인 읽기 전용 후보 검증이 필요합니다. 검증은 소스나 권한을 편집할 수 없으며, 결과는 새 후보가 필요합니다.
  • 의사소통은 인간적이고 증거 기반으로 유지합니다. 저장소 레이블과 워크플로우 메타데이터는 유지관리자 소유이며, 기여자 비난의 증거가 아닙니다.

결정 게이트

조건조치
모든 RDD 모드리뷰 증거는 리뷰 전용으로 유지되며, 일반 커밋, 푸시, PR, 릴리스는 저장소 정책을 따르고 Pi 전달 권한 없음
이슈 게이트 또는 재현 실패증거를 가지고 대기, 중지 또는 축소
불변성 또는 롤백이 독립적분리된 이슈와 권한 있는 PR 라인
코어 벤치가 적합/부적합벤치 여정 / 실제 런타임 E2E, 프록시 금지
예측이 400줄 초과편집 전 체인 또는 승인된 예외

실행 단계

  1. 모드, 승인, PR 충돌, 현재-main 재현을 확인합니다.
  2. 불변성과 롤백 이름을 지정하고, 워크트리를 격리하며, 코드, 테스트, 증거, 문서, 배포, 등록을 CodeGraph로 매핑합니다.
  3. 흐름과 제어를 인벤토리로 작성하고, 실패 테스트와 최소 수정을 추가합니다.
  4. 정규화, 예산 적용, 테스트 실행, 각 흐름의 정확한 후보, 명령, 시나리오 및 결과를 기록합니다.
  5. 고정, 읽기 전용 검증, 평결과 증거 및 하나의 인간적인 다음 조치를 제공합니다.

출력 계약

rdd_mode, issue_pr, causal_invariant, operator_flows, journey_runtime_evidence, changed_line_budget, tests, rollback, unresolved_authority_decisions를 반환합니다.

승인된 권한 라인과 대체/충돌 권한 라인, 모든 흐름, 음성 제어, 후보 바운드 증명, 추가 및 삭제와 체인/예외, 테스트 결과, 독립적 롤백, 해결되지 않은 유지관리자 결정을 식별합니다.

참조

지원 파일이 없습니다. 현재 저장소 정책이 권위를 유지합니다.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

관련 스킬