sodalive-android/docs/plan-task/20260527_작업계획커밋규칙분리.md

20260527 작업 계획 커밋 규칙 분리

개요

• docs/agent-guides/workflow-docs-commits.md에 혼재된 작업 계획 문서 규칙과 커밋 메시지 규칙을 분리한다.
• PRD: docs/prd/20260527_작업계획커밋규칙분리_prd.md

작업 체크리스트

• 기존 workflow-docs-commits.md와 AGENTS.md 참조를 확인한다.
• 작업 계획 문서 규칙을 docs/agent-guides/work-plan-docs.md로 분리한다.
• 커밋 메시지 규칙을 docs/agent-guides/commit-message-rules.md로 분리한다.
• 기존 workflow-docs-commits.md를 삭제한다.
• AGENTS.md 상세 참조 문서를 분리된 문서 기준으로 갱신한다.
• rg와 git diff로 참조와 변경 범위를 검증한다.

구현 범위

• Add: docs/prd/20260527_작업계획커밋규칙분리_prd.md
• Add: docs/plan-task/20260527_작업계획커밋규칙분리.md
• Add: docs/agent-guides/work-plan-docs.md
• Add: docs/agent-guides/commit-message-rules.md
• Delete: docs/agent-guides/workflow-docs-commits.md
• Modify: AGENTS.md

검증 기록

• 2026-05-27

  • 무엇/왜/어떻게: 사용자 요청에 따라 혼재된 작업 계획 문서 규칙과 커밋 메시지 규칙을 분리하기 위해 기존 문서와 AGENTS.md 참조를 확인하고, 기존 경로는 과거 참조 호환을 위해 처음에는 인덱스로 유지했다.
  • 실행 명령/도구:
    • read(docs/agent-guides/workflow-docs-commits.md)
    • read(AGENTS.md)
    • rg -n "workflow-docs-commits|커밋 메시지|작업 계획 문서|plan-task|docs/prd" .
    • task(subagent_type="plan")
  • 결과:
    • workflow-docs-commits.md가 작업 계획 문서 규칙과 커밋 메시지 규칙을 함께 담고 있음을 확인했다.
    • AGENTS.md의 상세 참조 문서 항목이 통합 문서 하나만 가리키고 있음을 확인했다.

• 2026-05-27

  • 무엇/왜/어떻게: 분리된 문서 경로와 헤딩이 의도대로 배치됐는지 확인하고, 기존 workflow-docs-commits.md가 상세 규칙 대신 인덱스로만 남았는지 검증했다.
  • 실행 명령/도구:
    • rg -n "workflow-docs-commits.md|work-plan-docs.md|commit-message-rules.md" AGENTS.md docs/agent-guides docs/plan-task/20260527_작업계획커밋규칙분리.md
    • rg -n "커밋 메시지 규칙|작업 계획 문서 규칙|작업 절차 체크리스트|문서 유지보수 규칙" docs/agent-guides
    • git diff -- AGENTS.md docs/agent-guides/workflow-docs-commits.md
    • read(docs/agent-guides/work-plan-docs.md)
    • read(docs/agent-guides/commit-message-rules.md)
    • read(docs/agent-guides/workflow-docs-commits.md)
    • read(AGENTS.md)
  • 결과:
    • AGENTS.md가 docs/agent-guides/work-plan-docs.md와 docs/agent-guides/commit-message-rules.md를 직접 참조함을 확인했다.
    • workflow-docs-commits.md는 두 분리 문서 링크만 담은 호환용 인덱스로 축소됐음을 확인했다.
    • 과거 docs/plan-task 로그는 일괄 수정하지 않았다.

• 2026-05-27

  • 무엇/왜/어떻게: 사용자가 호환용 인덱스 제거를 승인해 workflow-docs-commits.md를 삭제 대상으로 변경하고 PRD/계획 문서의 목표와 구현 범위를 삭제 기준으로 갱신했다.
  • 실행 명령/도구:
    • read(docs/prd/20260527_작업계획커밋규칙분리_prd.md)
    • read(docs/plan-task/20260527_작업계획커밋규칙분리.md)
  • 결과:
    • 신규 canonical 문서는 work-plan-docs.md, commit-message-rules.md 두 개로 고정했다.
    • 기존 workflow-docs-commits.md는 삭제하기로 결정했다.