단계별 명령어를 통한 구조화된 AI 워크플로우로 재작업 감소

r/ClaudeAI의 한 개발자가 일상적인 개발에 AI를 사용할 때 발생하는 지속적인 문제를 해결하기 위해 설계된 반복 가능하고 프로그래밍 가능한 워크플로우를 설명합니다. 확인된 핵심 문제는 더 똑똑한 모델이 필요한 것이 아니라, 동일한 실수를 반복하지 않도록 하는 반복 가능한 프로세스가 필요하다는 것이었습니다. 주요 문제점으로는 AI가 세션 간 컨텍스트를 잃어버리는 것, 명명법 및 스타일과 같은 기본 사항에서 프로젝트 표준을 깨는 것, 계획과 실행을 혼합하는 것, 그리고 문서화를 사후 처리로 취급하는 것이 포함되었습니다.

단계별 명령어 워크플로우

이 솔루션은 단일한 거대한 프롬프트에 의존하는 대신 일련의 명확하고 단계별 명령어로 대체합니다:

• /pwf-brainstorm – 범위, 아키텍처 및 결정 사항을 정의합니다.
• /pwf-plan – 브레인스토밍을 실행 가능한 단계와 작업으로 전환합니다.
• 선택적 품질 게이트: /pwf-checklist, /pwf-clarify, /pwf-analyze.
• /pwf-work-plan – 계획을 단계별로 실행합니다.
• /pwf-review – 더 깊은 검토를 수행합니다.
• /pwf-commit-changes – 구조화된 커밋으로 작업을 종료합니다.

작은 작업의 경우 개발자는 /pwf-work를 사용하지만 검토 및 문서화 규칙을 유지합니다.

핵심 규칙

품질에 가장 큰 영향을 미친 규칙: /pwf-work 및 /pwf-work-plan은 구현 전에 문서를 읽고, 이후에 문서를 업데이트해야 합니다. 이는 AI가 "반맹" 상태가 아닌 "프로젝트 메모리"와 함께 작업하도록 보장하여 일관성을 크게 향상시키고 재작업을 줄입니다.

지원 프로젝트 구조

이 워크플로우는 AI 컨텍스트를 개선하기 위한 특정 프로젝트 구조로 지원됩니다:

• 코드 저장소용 폴더 하나.
• 작업 공간 자산(문서, 제어, 구성)용 폴더 하나.

두 폴더 모두 편집기(예: VS Code 또는 Cursor)에서 다중 루트로 열려, AI가 혼란 없이 전체 시스템을 볼 수 있도록 돕는 모노레포와 유사한 경험을 제공합니다.

결과 및 참고 자료

개발자는 직접적인 영향을 보고합니다: 반복 실수 감소, 재작업 감소, 세션 간 일관성 향상, 오류 감소와 함께 더 많은 산출물. 동일한 오류 루프를 피함으로써 하루에 25개의 작업(소형, 중형, 대형)을 종료한 사례를 언급했습니다. 이 접근법은 Compound Engineering, Superpowers, Spec Kit, Spec-Driven Development와 같은 개념을 연구하여 알게 되었지만, 프레임워크를 복사하기보다는 개인적인 사용을 통해 조정 및 개선되었습니다.