xop01/ai_goodpractice

ai_goodpractice는 개발자 xop01이 직접 작성한 가이드(AI 생성 아님)로, AI를 코딩 작업의 관리자로 사용하는 방법을 공유합니다. 직접 코딩하지 않고 말이죠.

이것이 무엇인가

저자의 일상 경험(수개월 동안 매일 8시간 이상 AI 사용)에 기반한 길고 의견이 강한 가이드입니다. 에이전트형 워크플로우(AI 어시스턴트가 코드를 작성, 테스트, 수정하고 인간이 지시)를 통해 생산성을 10~20배 높이고 야심찬 소프트웨어 프로젝트를 수년이 아닌 수개월 만에 완료할 수 있다고 주장합니다.

저자는 의도적으로 가이드를 수동으로 작성했습니다: AI가 자신의 생각과 생활 방식을 자신만큼 잘 표현할 수 없다고 믿기 때문입니다. X(Twitter) 계정에서 피드백과 토론을 환영합니다.

핵심 아이디어

코드를 입력하는 프로그래머 대신, 당신은 '리더/관리자'가 됩니다:

• 소프트웨어와 구축 방법을 구상합니다
• 그 비전을 AI가 실행할 수 있는 상세한 프롬프트로 공식화합니다
• AI의 작업을 검토하고 조종합니다, 팀을 지휘하는 관리자처럼

저자는 이 워크플로우를 채택한 이후 수동으로 코드를 한 줄도 작성하지 않았다고 말합니다.

대상 독자

이 가이드는 완전한 초보자부터 경험 많은 코더까지 유용하다고 주장합니다. AI 구독에서 실제적이고 지속적인 작업을 얻고 싶은 모든 사람을 위한 것입니다.

가이드 구조: 3단계

1단계 — 설정

• AI 통합 IDE 선택(Cursor, VS Code, Claude Code, ChatGPT 등)
• AI를 명확한 지시가 필요한 유능한 파트너로 대우하세요. 프롬프트가 추가 컨텍스트 없는 똑똑한 사람에게 의미가 있을지 생각하세요
• 규칙, 스킬, MCP(AI를 다른 소프트웨어에 연결하는 작은 도구)로 환경을 설정하세요. 저자는 이를 가장 과소평가된 단계라고 부릅니다.

핵심 실천: 규칙을 AI 자체를 통해 구축하세요. 규칙을 수동으로 작성하는 대신, AI에게 코드 스타일을 분석하고 저장소에 대한 규칙을 생성하도록 프롬프트하세요. 저자는 예시 프롬프트를 제공하고 상세함을 강조합니다. 예: "코드 스타일을 깊이 분석하고 이 저장소의 규칙으로 적용하세요", 테스트, 헬퍼, 단순성에 대한 특별 규칙도 포함.

2단계 — '슬롭'(저품질 AI 출력) 피하기

저자는 많은 'AI 슬롭'이 약한 기반과 부주의한 프롬프트에서 비롯된다고 경고합니다. 그들의 권장 사항:

• 자체 규칙/스킬/MCP를 만드는 것을 선호하세요. 웹에서 다운로드하는 것보다, 기성품은 종종 워크플로우에 맞지 않기 때문입니다
• 저자 자신의 MCP: project-progress-mcp — 프로젝트 진행 상황을 추적하는 도구(Zig로 작성, 저자는 Zig를 사용해 본 적이 없다고 말함). AI가 문서화된 로드맵을 유지하고 원래 목표에서 벗어나지 않도록 합니다
• 문서화는 중요합니다: 주요 기능과 인프라에 대한 가벼운 문서를 유지하여 AI가 전체 파일을 다시 읽지 않고도 코드베이스를 빠르게 이해할 수 있게 합니다. 그러나 문서를 최신 상태로 유지하세요. 그렇지 않으면 낡고 오해를 불러일으킵니다
• 테스트는 가장 중요한 단계입니다: 적절한 테스트 스위트를 통해 AI는 자신의 작업을 검증하고 인간이 모든 것을 확인하지 않고도 오랫동안 자율적으로 작업할 수 있습니다
• 큰 작업의 경우: IDE의 '플랜 모드'를 사용하고, 매우 상세한 계획을 작성하고, 모든 주요 변경에 테스트 케이스가 필요하다고 지정하고, AI에게 시간이 제약이 아니라고 말하세요("계획에 시간 제한이 없습니다"), 시작 전에 전체 계획을 주의 깊게 검토하세요
• 마지막에 감사: 계획이 완료된 후, AI에게 '장수, 확장성, 안정성'을 위해 모든 것이 구현되었는지 확인하도록 프롬프트하고 원래 계획을 참조하세요

3단계 — AI로 삶을 개선하기

저자는 7가지 원칙을 나열합니다. 가이드는 처음 두 가지를 자세히 설명합니다:

1. 시간을 사용하여 프롬프트를 극대화하세요 — 프롬프트를 AI가 걸릴 시간에 맞추세요. 저녁을 만들러 간다면, AI가 자리 비운 동안 바쁘게 유지할 만큼 큰 프롬프트를 시작하세요. 이를 통해 휴식하면서 여러 시간 '일'할 수 있습니다 — 그러나 저자는 AI의 진행 상황을 계속 확인하지 말라고 경고합니다("절제가 핵심").
2. 다루는 스택이나 주제를 배우세요 — AI는 속도를 높이는 도구이지, 이해를 대체하는 것이 아닙니다. AI를 잘 지시하고 실수를 잡으려면 최소한 기본적인 이해가 필요합니다.

가이드는 나머지 다섯 가지를 나열하지만 자세히 설명하지 않습니다: 떠날 때를 알기, 파트너 신뢰, 생각 번역, 멀티태스킹, 올바른 작업에 올바른 모델 사용.

가이드의 예시 프롬프트

• "(폴더 경로/URL)의 코드 스타일을 깊이 분석하고 이 저장소의 규칙으로 적용해야 합니다"
• "MySQL을 작업하는 에이전트가 사용할 스킬을 만들어야 합니다... MySQL의 가능성을 깊이 탐구하세요"
• "이 프로젝트는 (목적)에 사용될 것입니다... 제 필요에 기반하여 어떤 스택이 가장 좋을지 추천이 필요합니다: 장수, 안정성, 확장성, 성능"

결론

이 프로젝트는 본질적으로 의견이 강한 에세이이며 코드가 아닙니다. 규율 있는 설정, 상세한 프롬프트, 문서화, 테스트를 통해 한 사람이 AI로 진지한 소프트웨어를 구축할 수 있으며, 같은 습관이 더 나은 업무-생활 균형으로 이어져 AI가 부담을 지는 동안 더 적은 집중 시간으로 일할 수 있다고 주장합니다.