sodalive-android/docs/20260601_계획문서규칙수정/plan-task.md

20260601 계획 문서 규칙 수정

개요

• 작업 절차와 PRD/계획/TASK 문서 작성 규칙을 사용자 요청 기준으로 수정한다.
• PRD: docs/20260601_계획문서규칙수정/prd.md

구현 범위

• Create: docs/20260601_계획문서규칙수정/prd.md
• Create: docs/20260601_계획문서규칙수정/plan-task.md
• Modify: AGENTS.md
• Modify: docs/agent-guides/work-plan-docs.md

작업 체크리스트

Phase 1: 작업 문서 준비

• Task 1.1: PRD 문서 작성
  • 파일 경로: docs/20260601_계획문서규칙수정/prd.md, docs/prd/sample-prd.md
  • 검증 기준: sample-prd.md의 필요한 섹션만 사용하고, 이번 작업의 목표/범위/제약을 명시한다.
• Task 1.2: 계획/TASK 문서 작성
  • 파일 경로: docs/20260601_계획문서규칙수정/plan-task.md
  • 검증 기준: phase heading, 체크박스 task, 파일 경로, 검증 기준을 포함한다.

Phase 2: 규칙 문서 수정

• Task 2.1: AGENTS.md 작업 절차 핵심 규칙 수정
  • 파일 경로: AGENTS.md
  • 실행 명령: sed -n '1,220p' AGENTS.md
  • 기대 결과: 작업 시작 전 PRD와 계획/TASK 문서 준비, 새 문서 경로, 인터뷰/연속 작업/검증 기록 누적 규칙이 반영된다.
• Task 2.2: work-plan-docs.md 작업 계획 문서 규칙 수정
  • 파일 경로: docs/agent-guides/work-plan-docs.md
  • 실행 명령: sed -n '1,260p' docs/agent-guides/work-plan-docs.md
  • 기대 결과: 사용자 요청의 문서 구조, 작성 순서, sample PRD, phase/task, 범위 변경, 검증 기록 규칙이 반영된다.
• Task 2.3: 신규 문서에만 새 규칙 적용 명시
  • 파일 경로: AGENTS.md, docs/agent-guides/work-plan-docs.md, docs/20260601_계획문서규칙수정/prd.md
  • 검증 기준: 기존에 생성된 docs/prd/, docs/plan-task/ 문서는 유지하고, 신규 생성 문서부터 새 docs/[날짜]_구현할내용한글/ 구조를 적용한다고 명시한다.

Phase 3: 검증 및 기록

• Task 3.1: 변경 범위와 규칙 문구 검증
  • 파일 경로: AGENTS.md, docs/agent-guides/work-plan-docs.md, docs/20260601_계획문서규칙수정/prd.md, docs/20260601_계획문서규칙수정/plan-task.md
  • 실행 명령: rg -n "docs/\\[날짜\\]_구현할내용한글|docs/prd/|docs/plan-task/|sample-prd|Phase 1|검증 기록" AGENTS.md docs/agent-guides/work-plan-docs.md docs/20260601_계획문서규칙수정
  • 기대 결과: 새 규칙은 반영되고, canonical 안내에서 기존 docs/prd/, docs/plan-task/ 생성 규칙은 제거된다.
• Task 3.2: 검증 기록 누적
  • 파일 경로: docs/20260601_계획문서규칙수정/plan-task.md
  • 검증 기준: 문서 하단에 무엇/왜/어떻게, 실행 명령, 결과를 한국어로 누적 기록한다.

검증 기록

• 2026-06-01

  • 무엇/왜/어떻게: 계획 문서 규칙 수정 요청에 따라 기존 작업 절차 문서와 sample-prd.md 위치를 확인하고, 신규 작업 문서부터 docs/[날짜]_구현할내용한글/prd.md, docs/[날짜]_구현할내용한글/plan-task.md 구조를 적용하도록 규칙을 수정했다.
  • 실행 명령:
    • rg --files -g 'AGENTS.md' -g 'sample-prd.md' -g 'docs/**'
    • sed -n '1,240p' AGENTS.md
    • sed -n '1,260p' docs/agent-guides/work-plan-docs.md
    • sed -n '1,240p' docs/prd/sample-prd.md
  • 결과:
    • sample-prd.md가 docs/prd/sample-prd.md에 있음을 확인했다.
    • 기존 규칙이 docs/prd/, docs/plan-task/ 분리 저장을 안내하고 있음을 확인했다.
    • 새 PRD/계획 문서는 docs/20260601_계획문서규칙수정/ 아래에 생성했다.

• 2026-06-01

  • 무엇/왜/어떻게: 사용자가 기존에 생성된 문서는 두고 신규 생성 문서만 새 규칙을 적용하면 된다고 정정해, 해당 범위 조건을 PRD와 규칙 문서에 추가로 명시했다.
  • 실행 명령:
    • rg -n "docs/\\[날짜\\]_구현할내용한글|docs/prd/|docs/plan-task/|sample-prd|Phase 1|검증 기록|신규 생성 문서|기존에 생성된" AGENTS.md docs/agent-guides/work-plan-docs.md docs/20260601_계획문서규칙수정
    • git diff -- AGENTS.md docs/agent-guides/work-plan-docs.md docs/20260601_계획문서규칙수정/prd.md docs/20260601_계획문서규칙수정/plan-task.md
    • git status --short
  • 결과:
    • AGENTS.md와 docs/agent-guides/work-plan-docs.md에 신규 문서 경로와 기존 문서 유지 조건이 반영됐음을 확인했다.
    • 변경 범위가 AGENTS.md, docs/agent-guides/work-plan-docs.md, docs/20260601_계획문서규칙수정/prd.md, docs/20260601_계획문서규칙수정/plan-task.md로 제한됐음을 확인했다.