hyper-waterfall AGENTS.md

AGENTS.md

본 저장소에서 작업하는 모든 코딩 에이전트(Codex, Claude Code 등)가 따르는 운영 규칙. 매 턴 시스템 프롬프트로 적재되므로 항상 필요한 정책·제약·인덱스만 둔다. 절차 상세는 매뉴얼·SKILL로 분리한다.

프로젝트 개요

본 저장소는 하이퍼-워터폴 방법론을 모듈화한 프레임워크 저장소이며, 자기 자신에게 본 방법론을 적용하는 dogfooding 사례를 운영한다. templates/에는 적용 대상 저장소에 복사할 진실 원천 파일이 있고, 본 저장소 루트의 mydocs/manual과 mydocs/skills는 templates/mydocs/의 동일 폴더로 가는 심볼릭 링크다.

하이퍼-워터폴 핵심 규칙

이 프로젝트는 하이퍼-워터폴 방법론을 적용한다. 에이전트의 기본 동작(빠른 실행, 자율 수정)과 충돌하므로 반드시 숙지한다. 상세: agent_code_hyperfall_rule_conflict.md.

• 소스 수정 전 반드시 작업지시자 승인 요청
• 작업은 GitHub Issue 기준으로 추적
• 새 기능, 버그 수정, 구조 변경은 이슈 -> 브랜치 -> 오늘할일 -> 계획서 -> 구현 -> 검증 -> 최종 보고서 -> PR 순서 절대 생략 금지
• 각 단계 완료 후 승인 없이 다음 단계 진행 금지
• 범위가 불명확하거나 기존 작업과 충돌할 가능성이 있으면 먼저 확인
• 사용자나 다른 작업자가 만든 변경은 되돌리지 않음
• 이슈 close는 작업지시자 승인 후 또는 PR merge 확인 후에만 수행
• 문서 수정은 기존 내용을 먼저 읽고 필요한 부분만 수정하며, 불가피할 때만 내용을 추가
• 작업 완료 후 다음 작업에 필요하지 않은 로컬/원격 부산물은 정리
• PR merge와 이슈 close 후에는 main으로 돌아오고, 더 이상 필요 없는 local/task{번호} 브랜치와 임시 worktree를 정리

승인 간주 조건: 작업지시자가 같은 스레드에서 "계속 진행", "다음 단계 진행"처럼 명시 지시한 경우에만 해당 단계 승인으로 간주한다.

명명 규칙

• 마일스톤: M{버전} (예: M100=v1.0.0, M05x=v0.5.x). 문서 파일명은 m{숫자} 소문자 (예: m100)
• 브랜치: local/task{이슈번호} (작업), publish/task{이슈번호} (main 대상 PR 게시용)
• 커밋 메시지:
  • 기본형: Task #{번호}: 내용
  • 단계: Task #{번호} Stage {N}: 내용
  • 하위 단계: Task #{번호} [Stage {N.M}]: 내용
  • 보고서 묶음: Task #{번호} Stage {N} + 최종 보고서: 내용
• 문서 파일명: task_{milestone}_{이슈번호}{_impl|_stage{N}|_report}?.md. 신규 문서는 마일스톤 포함 형식 강제. 상세: document_structure_guide.md
• 모든 문서는 한국어 작성

핵심 강제 규칙 (변경 전 매뉴얼 확인 필수)

• templates/ 안의 placeholder 표기(예: {REPO_SLUG})는 그대로 보존한다. 사용자가 자신의 저장소에 적용할 때 치환하므로 본 저장소에서는 치환하지 않는다.
• SKILL이나 매뉴얼 본문을 변경할 때는 README.md의 "핵심 SKILL"·"도입 후 작업 흐름" 표와 templates/mydocs/manual/task_workflow_guide.md의 "SKILL 호출 표시 안내"를 같은 PR에서 갱신한다.
• mydocs/skills와 mydocs/manual 심볼릭 링크 대상은 변경하지 않는다(templates/mydocs/skills, templates/mydocs/manual이 진실 원천).