Communitygithub.com

candycong2001-ui/agent-project-playbook

설치, 마이그레이션 및 지속적 개선이 가능한 인간-AI 프로젝트 협업을 위한 규약 세트

agent-project-playbook란 무엇인가요?

이 스킬은 AI 에이전트가 인간 개발자와 함께 프로젝트를 진행할 때 따라야 할 명확한 작업 규약을 제공합니다. 주로 Claude Code, Cursor, Codex와 같은 터미널 기반 AI 코딩 도구에서 사용되며, 프로젝트 문서의 일관성과 신뢰성을 유지하는 데 목적이 있습니다. 스킬은 `CURRENT_HANDOFF.md`, `BLUEPRINT.md`, `ARCHITECTURE.md` 등 핵심 문서를 언제 어떻게 업데이트해야 하는지 정확히 정의합니다. 또한 작업 시작 시 현재 목표와 다음 행동을 갱신하고, 마일스톤 달성 후 검증 증거를 기록하며, 핸드오프 전에는 완료된 프로세스 세부 사항을 제거하고 연속 가능한 상태만 남기도록 규정합니다. 문서의 최대 라인 수 제한(예: BLUEPRINT 160줄, CURRENT_HANDOFF 80줄)을 통해 문서가 너무 방대해지는 것을 방지하며, 코드, 테스트, 명령어 출력 등 실제 증거가 문서보다 우선한다는 경계 원칙을 포함합니다. 배포 전에는 `python3 docs_lint.py` 스크립트를 실행하여 문서 무결성을 검증하도록 요구합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add candycong2001-ui/agent-project-playbook

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

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

문서

프로젝트 문서

워크플로우

  1. 본격적인 구현 또는 진단을 시작할 때 docs/CURRENT_HANDOFF.md와 안정적인 문서 중 관련 섹션만 읽습니다.
  2. 문서 내용을 현재 저장소의 증거와 대조하여 검증합니다.
  3. 탐색 또는 읽기 전용 검토 중에는 사용자가 변경을 승인하지 않는 한 문서 편집 없이 차이(drift)만 보고합니다.
  4. 작업 시작 시 CURRENT_HANDOFF.md의 현재 목표와 다음 행동을 교체합니다.
  5. 검증된 마일스톤 이후에는 현재 상태와 검증 증거를 교체하며, 타임라인을 추가하지 않습니다.
  6. 핸드오프 전에 완료된 프로세스 세부 사항을 제거하고 하나의 연속 준비 상태만 남깁니다.
  7. BLUEPRINT.md는 제품 의도, 사용자, 범위, 제약 사항 또는 수용 조건이 변경될 때만 업데이트합니다.
  8. ARCHITECTURE.md는 컴포넌트, 경계, 데이터 흐름, 검증된 명령어, 배포, 롤백 또는 위험이 변경될 때만 업데이트합니다.
  9. 본격적인 전달 전에 python3 .agents/skills/project-docs/scripts/docs_lint.py를 실행합니다.

경계

  • 현재 코드, 테스트, 설정, 명령어 출력 및 사용자 지시가 이 문서들보다 우선합니다.
  • BLUEPRINT는 160줄 이하로 유지합니다.
  • ARCHITECTURE는 160줄 이하로 유지합니다.
  • CURRENT_HANDOFF는 80줄 이하로 유지합니다.
  • AGENTS는 90줄 이하로 유지합니다.
  • Git이 히스토리를 저장합니다. CURRENT_HANDOFF는 최신 작업 상태만 저장합니다.

관련 스킬