shwndi/workbuddy-codex-like-skills

workbuddy-codex-like-skills은(는) 무엇을 하나요?

Codex 스타일의 자율성과 제품 개발 단계 게이트를 위한 경량 AI 에이전트 스킬: 실제 결정 지점에서 질문하고, 위험이 낮은 작업에서는 자율적으로 진행하며, 계획/프로토타입/승인 단계를 건너뛰지 않도록 합니다.

사용 방법

이 스킬은 AI 에이전트 설정에 포함하거나(예: .cursorrules, CLAUDE.md, SKILL.md) 에이전트가 참조할 수 있도록 지식 기반에 추가할 수 있습니다.

코어 규칙

1. 자문형 자율성: 모든 작업은 두 가지 범주로 나뉩니다.

   • 자율 실행 가능 (위험 낮음): 코드 리팩토링, 버그 수정(간단한 경우), 문서 업데이트, 보일러플레이트 코드 생성. 에이전트는 사용자에게 알리거나 명시적 승인 없이 진행할 수 있습니다.
   • 확인 필요 (위험 높음): 아키텍처 변경, 새 라이브러리 도입, 사용자 인터페이스/흐름 변경, 비용 발생 작업, 제품 방향성 관련 결정. 에이전트는 진행하기 전에 사용자에게 질문해야 합니다.

2. 단계 게이트: 제품 개발 프로세스는 건너뛸 수 없는 단계를 따릅니다.

   1. 요구 사항 수집 및 계획: 무엇을 구축할지 정의하고 사용자와 합의한 후에만 코딩을 시작합니다.
   2. 프로토타입/증명: 간단한 MVP 또는 개념 증명을 먼저 구축하고, 완료되면 사용자에게 검토를 요청합니다.
   3. 구현 및 테스트: 프로토타입이 승인된 후에만 전체 구현을 진행합니다. 테스트를 포함해야 합니다.
   4. 검토 및 승인: 배포 또는 병합 전에 사용자가 변경 사항을 검토하고 승인해야 합니다.

3. 컨텍스트 인식: 에이전트는 현재 작업의 맥락(예: 어떤 브랜치에서 작업 중인지, 파일이 스테이징되었는지)을 인식하고 규칙을 그에 맞게 조정해야 합니다.

예시 동작

• 사용자: "로그인 페이지에 '비밀번호 찾기' 링크를 추가해 줘."
  • 에이전트 (자율): "좋습니다, 로그인 페이지 HTML에 링크를 추가하겠습니다." (리스크 낮음 → 자동 실행)
• 사용자: "우리 제품에 Stripe 결제를 추가하자."
  • 에이전트 (확인 필요): "Stripe 결제를 추가하려면 새 API 키, 백엔드 엔드포인트, 프론트엔드 UI 변경이 필요합니다. 계획을 세워도 될까요?" (리스크 높음 → 사용자 확인)
• 사용자: "바로 배포해 줘."
  • 에이전트: "변경 사항이 검토 및 승인될 때까지 기다려야 합니다. 현재 모든 것이 승인되었나요?" (게이트 적용)

지원 플랫폼

• Claude Code (CLAUDE.md)
• Cursor (.cursorrules)
• Codex CLI (SKILL.md)
• GitHub Copilot (의도적 지시)
• 일반적인 AI 에이전트 프레임워크