vaibhav-space/my-ai-coding-workflow
Production-grade AI coding instructions, curated skills, and a 3-stage review pipeline (Planning → Critical Review → Diff Audit) built after 4,500+ hours with AI agents. Agent-agnostic.
해결하는 문제
AI 코딩 에이전트는 종종 비용이 많이 드는 실수를 저지릅니다. 간단한 작업을 과도하게 설계하고, API를 환각하며, 파일을 조용히 다시 포맷하고, 테스트를 실제로 실행하지 않고 통과했다고 주장합니다. 이 프로젝트는 에이전트가 먼저 계획을 세우고, 계획에 대한 비판을 받고, 병합 전에 실제 diff와 테스트 출력으로 작업을 증명하도록 강제하는 일련의 글로벌 규칙과 검토 프롬프트를 제공합니다.
작동 방식
저장소에는 하나의 글로벌 규칙 파일(CLAUDE.md)과 세 가지 프롬프트(planning.md, critical-plan-review.md, production-readiness-review.md)가 포함되어 있습니다. 워크플로우는 다음과 같습니다.
/plan(또는 계획 프롬프트 붙여넣기)을 입력하고 작업을 설명합니다. 에이전트는 코드베이스를 검사하고 체크 가능한 단계가 있는 대화형 계획 페이지를 생성합니다. 아직 아무것도 구축되지 않습니다.- 계획을 승인하면 새 채팅을 열고
/review-plan(또는 중요 계획 검토 프롬프트 붙여넣기)을 실행합니다. 새로운 컨텍스트는 작성자의 편향 없이 계획을 봐야 하므로 가정을 레드팀하고 결함을 찾을 수 있습니다. - 에이전트가 승인된 계획을 구현한 후 또 다른 새 채팅을 열고
/review-prod(또는 프로덕션 준비 검토 프롬프트 붙여넣기)를 실행합니다. 이는 실제git diff를 읽고 테스트를 실행하며 증거로 문자 그대로의 명령 출력을 요구합니다. 증명할 수 없는 항목에 대해 "검증할 수 없음" 목록으로 끝납니다.
CLAUDE.md의 규칙은 YAGNI(투기적 추상화 금지), 대화 요약보다 diff 검사, 결정적 산술(돈에 대한 암산 금지), 위험한 변경에 대한 명시적 승인과 같은 원칙도 내장합니다. 선택적 헬퍼 파일은 하드 잠금을 추가합니다. 테스트 실패 시 커밋을 차단하는 pre-commit 훅과 강제 푸시 또는 .env 읽기와 같은 위험한 명령에 대한 거부 규칙입니다.
대상 사용자
AI 에이전트가 실제 코드를 작성하게 하고 변경 사항이 안전하다는 약속이 아닌 증거를 원하는 개인 개발자와 소규모 팀을 위한 것입니다. 이 설정은 Linux의 Claude Code에서 테스트되었지만 프롬프트는 일반 텍스트이며 prompts/ 폴더에서 복사하면 Gemini CLI나 Cursor에 붙여넣을 수 있습니다.
주요 특징
- 3단계 검토 워크플로우: 계획, 계획 비판, 결과 감사. 각각 새로운 컨텍스트에서 수행하여 자기 확인 편향을 피합니다.
- 개별 저장소를 오염시키지 않고 모든 프로젝트에 적용되는 글로벌
CLAUDE.md규칙. - 선별된 오픈소스 스킬 팩: Superpowers(프로세스 규율), Ponytail(최소 코드), I Have ADHD(명확한 커뮤니케이션 선호).
- 선택적 강제 파일: 위험한 셸 명령에 대한 거부 규칙과 손상된 커밋을 차단하는 pre-commit 게이트.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트