Claude 목표 지시를 작업 파일로 나누어 쓰는 방식
기업 환경에서 소프트웨어 개발 경험이 있어도 Claude의 /goal 지시를 넓은 개발 작업에 어떻게 써야 할지 막막할 수 있다. 한 가지 실전 방식은 프로젝트 안에 ./tasks 폴더를 만들고, 해야 할 일, 끝난 일, 진행 중인 일을 각각 별도 마크다운 파일로 관리하는 것이다. 모든 변경은 새 작업 파일로 만들고, AI 에이전트가 현재 작업을 처리하는 동안 다음 작업을 준비한다.
이렇게 하면 처음부터 모든 기능을 자세히 정하지 않아도, 작은 단위로 방향을 잡아가며 기능을 쌓을 수 있다. 작업 하나가 끝날 때마다 git add와 git commit을 실행해 변경 내용을 끊어서 저장한다. ./AGENTS.md에 프로젝트 지침을 두고, Claude용 ./CLAUDE.md는 ./AGENTS.md를 읽으라는 안내만 담는다.
프로젝트가 커질수록 ./docs/SCHEMA.md, ./docs/DESIGN.md, ./docs/API.md, ./docs/ARCHITECTURE.md, ./docs/NAVIGATION.md, ./docs/SECURITY.md처럼 주요 설계 주제별 문서를 추가한다. 이 중에서는 전체 구조를 설명하는 ./docs/ARCHITECTURE.md가 특히 중요하다.
핵심 포인트
- 작업을 ./tasks 폴더의 작은 마크다운 파일로 나누어 관리한다.
- 해야 할 일, 진행 중인 일, 끝난 일을 파일 이름으로 구분한다.
- AI 에이전트가 한 작업을 하는 동안 사람이 다음 작업을 준비한다.
- 작업 하나가 끝날 때마다 git add와 git commit으로 변경을 저장한다.
- AGENTS.md와 설계 문서를 나누어 프로젝트 문맥을 관리한다.
용어 한 줄 설명
- AI 에이전트
- 사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
- git add
- Git에서 저장할 변경 파일을 고르는 명령이다.
- git commit
- 코드 변경 내역을 저장하는 단위로, 버전 관리 시스템에서 '저장 지점'을 만드는 행위입니다.
- AGENTS.md
- AI 코딩 도구에게 프로젝트 규칙이나 작업 방식을 알려주는 안내 파일입니다.
- CLAUDE.md
- Claude Code에게 프로젝트 규칙과 작업 방식을 알려주는 안내 파일입니다.
- schema
- 데이터베이스 안의 표와 칸이 어떻게 구성되어 있는지 보여 주는 구조입니다.
- architecture
- 여러 부분이 어떻게 연결되고 움직이는지 보여주는 전체 설계입니다.
- security
- 사이트가 해킹이나 악성 접근에 얼마나 안전한지 보는 항목입니다.