Skip to content

상위 AGENTS 지침 선행 읽기 순서 명시 - #71

Merged
debop merged 1 commit into
mainfrom
docs/agents-scope-hierarchy
Aug 14, 2026
Merged

상위 AGENTS 지침 선행 읽기 순서 명시#71
debop merged 1 commit into
mainfrom
docs/agents-scope-hierarchy

Conversation

@debop

@debop debop commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Summary

이번 PR은 모든 저장소 작업이 user-scope 및 workspace-scope 운영 지침을 먼저 읽도록 기준을 통일합니다.

Background

저장소별 AGENTS.md가 workspace 상속만 명시하거나 scope 순서를 직접 고정하지 않아, broader guidance가 누락될 수 있는 운영 공백이 있었습니다.

What This Solves

  • user-scope와 workspace-scope AGENTS.md의 선행 읽기 순서를 workspace 기준 문서에 고정합니다.
  • repo-local overlay가 broader guidance를 생략하지 않도록 공통 계층을 명확히 합니다.

Work Done

  • .github/docs/workspace/AGENTS.md: user → workspace → repository/worktree 계층을 명시했습니다.
  • .github/AGENTS.md: 저장소 overlay의 선행 읽기 규칙을 추가했습니다.

Validation

  • git diff --check: PASS
  • python3 .github/scripts/sync_workspace_docs.py --check: PASS
  • cmp -s .github/docs/workspace/AGENTS.md AGENTS.md: PASS

Review Notes

  • P0/P1: 0
  • P2/P3: 없음
  • Review evidence: 문서-only 로컬 diff 및 parity 검증

Metadata

DoD Status

Required checks: 6/6; N/A: 8; Blocked: 0

Check Action Status Evidence Failure / Next Action
WF-00/WF-01/WF-02 Guidance hierarchy read, Type E classification, approved plan PASS Current user/workspace/repo guidance and user approval none
E-02/E-03 Discover and preserve current guidance/ownership PASS 26 tracked AGENTS.md inventory; no unrelated tracked changes none
E-05 Maintenance verification PASS diff check, exact phrase inventory, workspace sync/parity none
CG-12A Refresh guidance before PR creation PASS Current hierarchy, maintenance skill, common gates, and PR template reread none
CG-14 CI and live review PENDING Exact head 8215bdd; waiting for required checks/review wait, then reread checks and threads
CG-15/CG-16/CG-17/CG-18 Merge-ready report, fresh merge approval, merge, sync/cleanup PENDING Depends on CG-14 and fresh approval do not merge before approval

Final status: PENDING (CI/review and fresh merge approval remain)
Unchecked required items: CG-14, CG-15, CG-16, CG-17, CG-18

각 저장소와 중첩 모듈이 user-scope 및 workspace-scope AGENTS.md를 먼저 읽도록 명시해 지침 계층 누락을 방지한다.

Constraint: 저장소별 AGENTS.md는 독립된 GitHub 저장소에서 관리된다.\nRejected: workspace 문서만 수정 | repo-local overlay가 직접 계층을 명시해야 한다.\nConfidence: high\nScope-risk: broad\nDirective: 새 repo 또는 worktree AGENTS.md에도 동일한 선행 읽기 순서를 유지한다.\nTested: git diff --check, 대상 문구 전수 검색, workspace sync parity\nNot-tested: 문서-only 변경이므로 제품 코드 테스트는 실행하지 않았다.
@debop debop self-assigned this Aug 14, 2026
@debop
debop merged commit 069ba85 into main Aug 14, 2026
1 check passed
@debop
debop deleted the docs/agents-scope-hierarchy branch August 14, 2026 02:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant