작업 계획 문서

핵심 아이디어

작업 계획 문서는 앱을 만들기 전에 목표, 기능, 데이터, 화면을 정리한 문서입니다. AI에게 코드를 요청하기 전에 “무엇을 만들 것인지”를 사람의 말로 먼저 고정하는 역할을 합니다.

쉽게 말하면

작업 계획 문서는 “앱 만들기 전 설계 메모”입니다. 여행 전에 일정표를 만들듯, 앱을 만들기 전에 목적과 필요한 기능을 적어 둡니다.

예시

• 앱 이름: 학생 과제 제출 현황
• 목적: 제출한 사람과 미제출 사람을 쉽게 확인한다
• 기능: 학생 목록 보기, 제출 여부 저장, 미제출 학생 강조 표시
• 데이터: 이름, 반, 번호, 제출 여부

헷갈리기 쉬운 점

작업 계획 문서는 코드가 아닙니다. 하지만 이 문서가 구체적일수록 AI에게 요청할 때 방향이 흔들리지 않습니다.

실제 IT 용어와의 연결

• 현업에서는 requirements document, specification, design brief, product requirements document(PRD)와 연결됩니다.
• 요구사항 문서(requirements document)는 무엇을 만들지 정리하고, specification은 더 구체적인 동작 규칙을 적습니다.
• 이 시리즈의 작업 계획 문서는 IT 분야 비전공자가 이해하기 쉽게 줄인 PRD이자 간단한 개발 명세서에 가깝습니다.

이 블로그에서의 역할

이 시리즈에서는 코드를 쓰기 전에 작업 계획 문서를 먼저 만들고, 그다음 구조 설계와 agent.md로 이어 갑니다.