Task #1: 하이퍼-워터폴 자기 적용 (dogfooding)#2
Merged
Merged
Conversation
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- AGENTS.md: templates 본문에 {PROJECT_OVERVIEW},
{PROJECT_SPECIFIC_RULES}, {PROJECT_SPECIFIC_REQUIRED_DOCUMENTS},
{BASE_BRANCH} 치환 (메타 저장소 성격, dogfooding 자기 적용 규칙)
- CLAUDE.md: 치환 대상 없이 그대로
- .github/pull_request_template.md: {REPO_SLUG} 치환,
검증 항목을 본 저장소 검증 명령(grep/ls/git diff --check)으로 교체
- mydocs/working/task_m010_1_stage1.md: 단계 보고서
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- mydocs/ 자체 폴더 7개 추가 (.gitkeep으로 빈 폴더 보존): plans/archives, report, feedback, tech, troubleshootings, pr, pr/archives - 심볼릭 링크 4개: - mydocs/manual -> ../templates/mydocs/manual - mydocs/skills -> ../templates/mydocs/skills - .agents/skills -> ../mydocs/skills - .claude/skills -> ../mydocs/skills - 단계 보고서: mydocs/working/task_m010_1_stage2.md Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- 기존 단일 트리를 두 관점으로 분리:
(1) 적용 후 대상 저장소 구조 — 사용자가 템플릿 복사·치환 후 모습
(2) 본 저장소(자기 적용 후) 구조 — templates 진실 원천 보관 +
mydocs/manual·skills 심볼릭 링크 통합
- 매뉴얼/SKILL 수정 시 templates/mydocs/를 직접 수정한다는 운영 원칙 명시
- 단계 보고서: mydocs/working/task_m010_1_stage3.md
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- 수행계획서: 범위에 PR #115 동기화 항목 추가, 4단계로 변경 - 구현계획서: Stage 4 (templates 5개 + 자기 적용본 3개) 정의 - 오늘할일 20260502.md 신설 (#1 진행중 재개) scope 확장 사유: postmelee/alhangeul-macos#115 의 PR 규칙 강화 (Open PR 기본, 새 PR 템플릿 구조)를 본 저장소에도 반영하고 PR #2 본문도 새 템플릿으로 재작성하기 위함. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
templates 갱신 (5개)
- .github/pull_request_template.md: 8개 섹션 새 구조 (요약 4 bullet,
변경 내역 Stage·commit 이중 링크 + 영역 표 + 작업 문서, 핵심 리뷰
포인트, 검증, 스크린샷 Before/After, 관련 이슈 맥락 의미, 후속
이슈 제안, 남은 리스크). Closes # 폐지
- mydocs/skills/task-final-report/SKILL.md: draft → Open PR 기본,
--body-file 우선, PR 본문 작성 가이드 + 검증 항목 갱신
- mydocs/manual/pr_process_guide.md: 섹션 구성 8개, 대상 타스크 vs
관련 이슈 의미 분리, 작성 예시 새 형식, --draft 제거
- mydocs/manual/git_workflow_guide.md: draft PR 정의 → Open PR,
메인테이너 워크플로우 --body-file, Stage 이중 링크 예시 추가
- mydocs/manual/task_workflow_guide.md: 11번 항목 draft → Open
자기 적용본 갱신 (3개)
- .github/pull_request_template.md: 새 본문으로 사본 재생성
({REPO_SLUG} → postmelee/hyper-waterfall 치환)
- README.md: 도입 후 작업 흐름 표 5번, 핵심 SKILL 표
task-final-report 행의 draft → Open PR
- AGENTS.md: draft 표현 잔존 없음 확인 (변경 없음)
단계 보고서: mydocs/working/task_m010_1_stage4.md
scope 확장 사유: postmelee/alhangeul-macos#115 동기화
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- 수행계획서: 범위에 본 저장소 자체 디자인 결정 항목 추가, 5단계로 변경 - 구현계획서: Stage 5 (영향 영역·작업 문서를 ### 하위 목차로 분리) 정의 - 오늘할일 #1 행을 진행중으로 되돌리고 비고에 재확장 사유 명시 scope 재확장 사유: PR #2 본문에서 변경 내역 섹션이 Stage timeline + 표 + 작업 문서가 한 섹션에 섞여 산만함. 대형 저장소(kubernetes, rust, llvm) 패턴 검토 결과 하위 목차 분리가 가독성·리뷰 효율에 유리. upstream 참조 없는 본 저장소 자체 결정. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- templates/.github/pull_request_template.md: 변경 내역 본문 = Stage timeline만, ### 영향 영역(옵션) + ### 작업 문서 하위 섹션 추가 - .github/pull_request_template.md: 자기 적용본도 동일 구조 - templates/mydocs/manual/pr_process_guide.md: - 섹션 구성에 하위 섹션 트리 추가 - 섹션별 작성 기준을 변경 내역/영향 영역/작업 문서로 분할 - 작성 예시도 ### 하위 섹션 형식으로 보정 - 단계 보고서: mydocs/working/task_m010_1_stage5.md scope 재확장 사유: PR #2 본문에서 변경 내역이 Stage + 표 + 문서 링크가 섞여 산만함. 대형 저장소(kubernetes, rust, llvm) 패턴 검토 결과 하위 목차 분리가 가독성에 유리. upstream 참조 없이 본 저장소 자체 결정. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
postmelee
added a commit
that referenced
this pull request
May 2, 2026
구조 변경: - 저장소 구조: (1) 적용 후 대상 저장소만 유지, (2) 자기 적용본 트리는 제거 - 도입 후 작업 흐름: 단계×역할×SKILL 격자 표 제거, SKILL 호출 순서 다이어그램 + 핵심 SKILL 표를 같은 섹션의 하위로 통합 - 새 저장소에 빠르게 적용하기: 6단계 절차를 docs/agent-entrypoint.md 로 위임하고 프롬프트 1줄 + 한 줄 안내로 단순화 - 살아있는 예시 섹션 신설: 이슈 #1, PR #2, mydocs 산출물, commit log를 번호 매긴 튜토리얼 식으로 안내 본문 변경: - 4열 비교 표(폭포수·애자일·바이브·하이퍼워터폴)를 2열 비교 (바이브 코딩 vs Hyper-Waterfall)로 단순화 — edwardkim/rhwp의 7행 비교 형식 차용 - 왜 강력한가: 5개 bullet → 3축으로 강력하게 명시 (1) 어디서든 추적·재개 (운영) (2) 게이트에서 방향 오류 조기 발견 (리스크) (3) 인간 통제권 + AI 가속 (역할 분담) - edwardkim/rhwp의 핵심 표현 3개를 짧은 인용 + 출처 링크로 보존 (거시적 워터폴 + 미시적 애자일 / 바이브 코딩 함정 / AI 배율기) - 설계 원칙: 기존 5개 중 issue-checkpoint 폐지에 맞춰 2번째 항목 갱신 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
요약
postmelee/alhangeul-macos#115에서 정리된 PR 본문 규칙·Open PR 기본을 본 저장소에도 동기화해야 함. 또한 동기화 직후 PR변경 내역섹션이 산만함이 드러나 본 저장소 자체 디자인 결정으로 하위 목차 분리도 필요했음mydocs/자기 적용 구조·README 저장소 구조 두 갈래·PR 규칙 강화(templates 5개 + 자기 적용본 3개)·PR 변경 내역 구조 개선(템플릿 2개 + 가이드)templates/와mydocs/의 심볼릭 링크 통합 패턴, (2) PR #115 동기화 범위가 본 저장소 컨텍스트(메타 저장소, 단일main)에 맞게 옮겨졌는지, (3)### 영향 영역·### 작업 문서하위 목차 분리가 가독성·리뷰 효율에 도움 되는지변경 내역
AGENTS.mdplaceholder 4개 치환,CLAUDE.md,.github/pull_request_template.md)mydocs/자체 폴더 7개 + 심볼릭 링크 4개 (mydocs/manual,mydocs/skills,.agents/skills,.claude/skills)변경 내역섹션 본문 = Stage timeline만,### 영향 영역(옵션) +### 작업 문서하위 목차로 분리.pr_process_guide.md섹션 기준·작성 예시도 보정영향 영역
AGENTS.md,CLAUDE.md,.github/)templates/사본에 placeholder 치환 + Stage 5 새 구조mydocs/+.agents/.claudemydocs/manual·mydocs/skills가templates/mydocs/로 통합되는 단일 진실 원천templates/.github/pull_request_template.md+ 자기 적용본Closes #폐지,### 영향 영역·### 작업 문서하위 목차templates/mydocs/skills/task-final-report/SKILL.md+ manual 3개--body-file우선, 변경 내역 작성 기준 분할{BASE_BRANCH}placeholder) 보존작업 문서
핵심 리뷰 포인트
mydocs/manual·mydocs/skills를templates/mydocs/로 가는 심볼릭 링크로 통합한 패턴이 의도와 일치하는지. 이로써 SKILL/매뉴얼 본문 변경 시 단일 진실 원천만 고치면 됩니다.main브랜치 정책에 맞게 옮긴 것이 적절한지. (alhangeul-macos 특유 항목 — copilot-instructions, AppKit 검증 — 은 제외했습니다.)### 영향 영역·### 작업 문서하위 목차 분리가 PR 가독성을 실제로 개선하는지. (이 PR 본문 자체로 직접 확인 가능합니다.)검증
git diff --checkgrep -nE 'draft PR|--draft' templates/mydocs/skills/task-final-report/SKILL.md templates/mydocs/manual/{git_workflow_guide,task_workflow_guide,pr_process_guide}.md→ 출력 없음grep -nE '^## (요약|변경 내역|핵심 리뷰 포인트|검증|스크린샷|관련 이슈|후속 이슈 제안|남은 리스크)' templates/.github/pull_request_template.md .github/pull_request_template.md→ 각 8건grep -nE '^### (영향 영역|작업 문서)' templates/.github/pull_request_template.md .github/pull_request_template.md→ 각 2건grep -nE '^### (영향 영역|작업 문서)' templates/mydocs/manual/pr_process_guide.md→ 2건 (작성 예시)grep -nE '\{REPO_SLUG\}' .github/pull_request_template.md→ 출력 없음 (자기 적용본 치환 확인)grep -nE 'draft PR' README.md AGENTS.md→ 출력 없음ls -la .agents/skills .claude/skills mydocs/manual mydocs/skills→ 4개 심볼릭 링크 정상 대상diff -q <(ls -1 templates/mydocs/skills) <(ls -1 mydocs/skills/)→ 본문 일치docs/agent-entrypoint.md의 "If The Target Repository Is Installed" 체크리스트 6개 항목 모두 충족 확인코드 빌드가 없는 메타 저장소이므로 빌드/테스트 검증은 수행하지 않았습니다.
관련 이슈
후속 이슈 제안
templates/mydocs/skills/issue-checkpoint/SKILL.md의 예시 본문으로 추가### 영향 영역·### 작업 문서하위 목차 분리를 upstream 동기화로 제안할지 검토남은 리스크
templates/mydocs/manual/*.md는{REPO_SLUG},{BASE_BRANCH}등을 본문 그대로 노출. 진실 원천 보호 + dogfooding 일관성을 위한 의도된 설계로AGENTS.md강제 규칙에 명시.예: {REPO_SLUG})로 우회.변경 내역안에 하위 목차를 도입했지만 alhangeul-macos는 아직 평면 배치. upstream 후속 동기화에서 정렬되거나 의도된 차이로 유지될 수 있음.