수행계획서: task_m010_1.md
GitHub Issue: #1
| Stage | 제목 | 주요 산출 | 검증 |
|---|---|---|---|
| 1 | 루트 운영 파일 | AGENTS.md, CLAUDE.md, .github/pull_request_template.md |
placeholder 잔존 grep, git diff --check |
| 2 | mydocs 구조 + 심볼릭 링크 | mydocs/ 8개 폴더, 4개 심볼릭 링크 |
ls -la, diff -q |
| 3 | README "저장소 구조" 재작성 | README.md 패치 |
두 갈래 섹션 존재 grep |
| 4 (2026-05-02 추가) | PR 규칙 강화 (PR #115 동기화) | templates 5개 파일 + 자기 적용본 3개 파일 갱신 | draft/Closes 표현 잔존 grep, 새 섹션 grep |
| 5 (2026-05-02 재추가) | PR 변경 내역 구조 개선 | PR 템플릿 2개(templates/자기 적용본) + pr_process_guide.md |
### 영향 영역 ### 작업 문서 하위 섹션 grep |
AGENTS.md:templates/AGENTS.md를 루트로 복사 + placeholder 치환CLAUDE.md:templates/CLAUDE.md를 루트로 복사 (치환 대상 없음, 그대로).github/pull_request_template.md:templates/.github/pull_request_template.md복사 + placeholder 치환
AGENTS.md 치환 항목:
{PROJECT_OVERVIEW}→ 다음 문단으로 치환:본 저장소는 하이퍼-워터폴 방법론을 모듈화한 프레임워크 저장소이며, 자기 자신에게 본 방법론을 적용하는 dogfooding 사례를 운영한다.
templates/에는 적용 대상 저장소에 복사할 진실 원천 파일이 있고, 본 저장소 루트의mydocs/manual과mydocs/skills는templates/mydocs/의 동일 폴더로 가는 심볼릭 링크다.{PROJECT_SPECIFIC_RULES}→ 다음 3개 항목으로 치환:templates/안의 placeholder({REPO_SLUG},{BASE_BRANCH}등)는 그대로 보존한다. 사용자가 자신의 저장소에 적용할 때 치환하므로 본 저장소에서는 치환하지 않는다.- SKILL이나 매뉴얼 본문을 변경할 때는
README.md의 "핵심 SKILL"·"도입 후 작업 흐름" 표와templates/mydocs/manual/task_workflow_guide.md의 "SKILL 호출 표시 안내"를 같은 PR에서 갱신한다. mydocs/skills와mydocs/manual심볼릭 링크 대상은 변경하지 않는다 (templates/mydocs/skills,templates/mydocs/manual이 진실 원천).
{PROJECT_SPECIFIC_REQUIRED_DOCUMENTS}→[docs/agent-entrypoint.md](docs/agent-entrypoint.md) — 외부 저장소 적용 진입 절차{BASE_BRANCH}→main{RELEASE_BRANCH}→main(이 저장소는 단일 브랜치 운영)
.github/pull_request_template.md 치환 항목:
{REPO_SLUG}→postmelee/hyper-waterfall- 본문 안의
{head_sha},{milestone},{issue}는 PR 작성 시점에 채우는 동적 값이므로 그대로 보존(템플릿 일부) - 검증 항목 placeholder(
{프로젝트별 검증 명령 1}등)는 본 저장소에 코드 빌드가 없으므로 다음 항목으로 치환:[ ] grep -RnE '\{[A-Z_]+\}' AGENTS.md CLAUDE.md(placeholder 잔존 없음)[ ] ls -la .agents/skills .claude/skills mydocs/manual mydocs/skills(심볼릭 링크 정상)[ ] git diff --check
CLAUDE.md는 치환 대상이 없다(본문은 @AGENTS.md 한 줄).
git diff --check
# 치환 대상 placeholder 잔존이 0이어야 함 (PR 템플릿 안의 예시 {head_sha}/{milestone}/{issue}/{REPO_SLUG}는 사용자 안내용으로 보존)
grep -nE '\{(PROJECT_OVERVIEW|PROJECT_SPECIFIC_RULES|PROJECT_SPECIFIC_REQUIRED_DOCUMENTS|PROJECT_VALIDATION_GUIDE|BASE_BRANCH|RELEASE_BRANCH|PR_TEMPLATE_PATH|REPO_NAME)\}' AGENTS.md CLAUDE.md .github/pull_request_template.md || echo "OK: 치환 대상 placeholder 잔존 없음"Task #1 Stage 1: 루트 운영 파일 추가 (AGENTS, CLAUDE, PR 템플릿)
자체 폴더 (.gitkeep으로 빈 폴더 보존):
mydocs/plans/archives/mydocs/working/mydocs/report/mydocs/feedback/mydocs/tech/mydocs/troubleshootings/mydocs/pr/mydocs/pr/archives/
(mydocs/orders/, mydocs/plans/는 Stage 0 task-start 단계에서 이미 생성됨.)
심볼릭 링크 4개:
mydocs/manual→../templates/mydocs/manualmydocs/skills→../templates/mydocs/skills.agents/skills→../mydocs/skills.claude/skills→../mydocs/skills
ls -la .agents/skills .claude/skills mydocs/manual mydocs/skills
diff -q <(ls -1 templates/mydocs/skills) <(ls -1 mydocs/skills/)
diff -q <(ls -1 templates/mydocs/manual) <(ls -1 mydocs/manual/)
git diff --checkdiff -q 두 줄 모두 빈 출력(차이 없음)이어야 한다.
Task #1 Stage 2: mydocs 구조와 심볼릭 링크 구성
README.md의 "저장소 구조" 섹션을 두 갈래로 나눈다.
- A. 적용 후 대상 저장소 구조: 사용자가 자신의 프로젝트에
templates/를 복사한 결과 모습. 트리 형식. - B. 본 저장소(자기 적용 후) 구조:
templates/보관 + 자기 적용 산출물 + 심볼릭 링크 통합 구조.
A는 tree 형식이 보기 좋다. B는 핵심 차이만 짚는 짧은 트리 + 심볼릭 링크 안내.
grep -nE "^## 저장소 구조" README.md
grep -nE "(적용 후 대상 저장소|자기 적용)" README.md
git diff --check각 grep 1건 이상.
Task #1 Stage 3: README 저장소 구조 두 갈래 재작성
2026-05-02 scope 확장으로 추가.
templates 갱신:
templates/.github/pull_request_template.md: PR #115 본문을 베이스로, alhangeul-macos URL을{REPO_SLUG}placeholder로 일반화. 새 섹션 구조 적용.templates/mydocs/skills/task-final-report/SKILL.md: draft → Open PR 기본,--body-file우선, Stage report+commit 이중 링크 가이드.gh pr create명령에서--draft제거. PR 본문 작성 가이드 5개 항목 추가. 검증 항목 4개 갱신.templates/mydocs/manual/pr_process_guide.md: 새 섹션 구조 (요약/변경 내역/핵심 리뷰 포인트/검증/스크린샷/관련 이슈/후속 이슈 제안/남은 리스크), "대상 타스크 vs 관련 이슈" 의미 분리, 작성 예시 갱신.templates/mydocs/manual/git_workflow_guide.md: draft PR → Open PR (정의·설명·메인테이너 워크플로우 명령). Stage 이중 링크 예시 추가.templates/mydocs/manual/task_workflow_guide.md: 11번 항목 draft → Open PR (1줄).
자기 적용본 갱신:
- 루트
.github/pull_request_template.md: templates 갱신본 기준으로{REPO_SLUG}→postmelee/hyper-waterfall치환한 사본 재생성. - 루트
AGENTS.md: draft 표현 잔존 검사. 본문에는 직접 등장하지 않으므로 변경 없을 가능성이 높지만 grep으로 확인. - 루트
README.md: "도입 후 작업 흐름" 표 6번 단계의 "draft PR" → "Open PR" 보정.
제외 (alhangeul-macos 특유): copilot-instructions.md, AppKit/render 검증 명령
# templates: draft 표현이 없어야 (예시 텍스트로 남겨도 되는 위치는 git diff에서 의도 확인)
grep -nE 'draft PR|--draft' templates/mydocs/skills/task-final-report/SKILL.md templates/mydocs/manual/git_workflow_guide.md templates/mydocs/manual/task_workflow_guide.md templates/mydocs/manual/pr_process_guide.md
# templates PR 템플릿: 새 섹션 grep
grep -nE '^## (요약|변경 내역|핵심 리뷰 포인트|검증|스크린샷|관련 이슈|후속 이슈 제안|남은 리스크)' templates/.github/pull_request_template.md
# 자기 적용본 PR 템플릿: placeholder 치환 + 새 섹션
grep -nE '\{REPO_SLUG\}' .github/pull_request_template.md && echo "FAIL: {REPO_SLUG} 잔존" || echo "OK"
grep -nE '^## (요약|변경 내역|핵심 리뷰 포인트|검증|스크린샷|관련 이슈|후속 이슈 제안|남은 리스크)' .github/pull_request_template.md
# 자기 적용본 README: draft 표현 잔존 없음
grep -nE 'draft PR' README.md && echo "FAIL: draft 잔존" || echo "OK"
# git diff --check
git diff --checkTask #1 Stage 4: PR 규칙 강화 (PR #115 동기화)
2026-05-02 scope 재확장으로 추가. 본 저장소 자체 디자인 결정 (upstream 참조 없음).
Stage 4 동기화로 PR #2 본문에서 변경 내역 섹션이 Stage timeline + 영역 표 + 작업 문서 링크가 한 섹션에 섞여 산만함이 드러났다. 대형 저장소(kubernetes, rust, llvm) 패턴을 검토한 결과, 변경 내역은 한 줄 timeline만, 영역 정보·작업 문서는 하위 목차나 별도 섹션으로 분리하는 편이 가독성·리뷰 효율에 유리하다.
templates/.github/pull_request_template.md:## 변경 내역본문을 Stage timeline만으로 줄이고,### 영향 영역(옵션, 표)과### 작업 문서를 하위 목차로 분리- 자기 적용본
.github/pull_request_template.md: 동일 구조 templates/mydocs/manual/pr_process_guide.md: "섹션별 작성 기준"의변경 내역항목을 새 구조에 맞춰 분할 (변경 내역 / 영향 영역 / 작업 문서). 작성 예시도 새 구조로 갱신
# templates·자기 적용본에 새 하위 섹션이 모두 있어야 함
grep -nE '^### (영향 영역|작업 문서)' templates/.github/pull_request_template.md .github/pull_request_template.md
# pr_process_guide의 작성 예시가 새 구조 반영
grep -nE '^### (영향 영역|작업 문서)' templates/mydocs/manual/pr_process_guide.md
# git diff --check
git diff --check각 grep은 templates/자기 적용본 PR 템플릿에서 2건씩, 가이드에서 2건 이상 나와야 한다.
Task #1 Stage 5: PR 변경 내역 섹션 구조 개선 (영향 영역·작업 문서 하위 분리)
- Stage 1 → Stage 2: 직접 의존 없음. 단, 운영 파일 → 데이터 폴더 순서가 자연스러움
- Stage 2 → Stage 3: README가 mydocs 구조를 설명하므로 Stage 2 결과가 확정된 뒤 작성
- Stage 3 → Stage 4: Stage 4의 자기 적용본 갱신은 Stage 1·3의 산출물(
AGENTS.md,README.md)을 수정하므로 그 뒤에 진행 - Stage 4 → Stage 5: Stage 5는 Stage 4에서 도입한 PR 템플릿 본문을 다시 손보므로 Stage 4 이후에 진행
- placeholder 치환 누락 → Stage 1 grep으로 잡힘
- 심볼릭 링크 깨짐(상대 경로 오류) → Stage 2 ls/diff로 확인
- README 두 갈래로 늘어 가독성 저하 → 표 + 짧은 트리로 압축
- 위 3단계 분할과 placeholder 치환 본문에 동의?
AGENTS.md의{PROJECT_SPECIFIC_RULES}3개 항목이 적절?- PR 템플릿의 검증 항목(grep, ls, git diff --check)이 본 저장소 검증으로 적합?
승인되면 Stage 1부터 순차 진행한다. 단계마다 task-stage-report + issue-checkpoint로 보고하고 다음 단계 승인을 요청한다.