Skip to content

feat(decisions): 결정 로그 분리 + D11 범위 헌장 - #121

Merged
hsleedevelop merged 4 commits into
mainfrom
hslee/decision-log-split
Oct 5, 2026
Merged

hsleedevelop merged 4 commits into
mainfrom
hslee/decision-log-split

Conversation

@hsleedevelop

Copy link
Copy Markdown
Contributor

요약

2026-10-05 재검토로 다시 정한 하네스의 정체성·범위를 D11로 기록하고, 이를 위해 결정 로그를 둘로 나눕니다.
사이클 정의와 단계별 결정 전문은 새 문서 docs/harness-cycle.md에 있습니다.

D11 요지: 팀원에게 개발 사이클(S0–S8, 검토 지점 R1–R3)을 제공하고, 강제하는 것은 하나뿐 —
PR에 그 task의 spec·plan·handoff·artifact·다이어그램(구조 변화가 없으면 생략 사유)을 담는 것.
소유하지 않는 것: 코드 안의 언어별 로직(프리셋 데이터로만), 구현 방식 강제, 사이클 밖 편의 기능, 개인 도구·서드파티 오케스트레이터 의존.

결정 로그 분리

소비자 템플릿 templates/docs/decisions.md 저장소 docs/decisions.md
담는 결정 팀 운영 결정 D2·D4·D5·D6 D2–D11 전부
이유 소비자 팀이 매 세션 지킬 규범의 근거 D7 이후는 플러그인을 어떻게 만들지에 대한 결정
  • doctor DECISION_HEADINGS → D2·D4·D5·D6. 확인 대상이 줄어드는 방향이라 소비자에게 새 경고 없음. 이미 설치된 D7–D10 사본은 seed라 그대로(D8).
  • 소비자 쪽에서 끊길 참조 정리: templates/AGENTS.md.hbs·루트 AGENTS.md의 D7 줄 제거(드리프트 테스트로 둘이 같아야 함),
    commands/harness-migrate.md·harness-review.md·doctor 경고 문구는 "플러그인 저장소 docs/decisions.md"로 명시.

테스트

  • 바이트 동일성 → "템플릿은 팀 운영 결정만 + 공유 절은 레포와 글자 그대로 같음 + 레포에 D7–D11 존재".
  • fence 계약: 감시자를 D8 → D6으로 이동, "closer 뒤 공백 허용 / 다른 글자 불허"를 두 행으로 나눠 각각 판별력 유지.

검증

$ npm run test       → tests 1081 · pass 1080 · fail 0 (skip 1), perf 1/1
$ npm run docs:check → harness overview 생성 상태가 최신입니다.
  • 리뷰: codex read-only(scope diff) PASS, P3 1건(doctor 경고의 D8 참조) 반영 — 기록은 docs/hslee/decision-log-split/decision-log-split-artifact.md ## Reviews.
  • 미검증: fence 케이스의 판별력은 추론으로만 확인(소스 변형 mutation 검증 안 함).

소비자 영향

  • 소비자 AGENTS.md 결정 규범 절이 바뀌었다(D7 줄 제거). 원하는 프로젝트에서 init --yes로 받는다(doctor는 "관리 절 낡음"으로 알림).

머지 주의

  • #120과 같은 CHANGELOG [Unreleased] 절에 항목을 더합니다. 나중에 머지하는 쪽에서 충돌하면 두 항목을 모두 남기면 됩니다.

🤖 Generated with Claude Code

hsleedevelop and others added 3 commits October 5, 2026 17:54
- templates/docs/decisions.md에는 팀 운영 결정(D2·D4·D5·D6)만 남긴다. D7–D10과 새 D11은 저장소 docs/decisions.md에만.
- doctor DECISION_HEADINGS를 D2·D4·D5·D6으로 줄인다(확인 대상 축소 — 소비자 새 경고 없음).
- 바이트 동일성 테스트를 "템플릿은 팀 운영 결정만 + 공유 절은 레포와 글자 그대로 같음"으로 바꾸고,
  fence 계약 테스트의 감시자를 D8 → D6으로 옮긴다(closer 공백 허용/다른 글자 불허를 두 행으로 분리해 판별력 유지).
- 소비자 쪽에서 끊길 D7·D8 참조 정리: AGENTS 템플릿·루트의 D7 줄 제거, migrate·review 명령은 "플러그인 저장소" 명시.
- D11: 강제는 PR의 task 문서(spec·plan·handoff·artifact·다이어그램)뿐, 사이클은 제공.
- docs/harness-cycle.md: 사이클 정의·결정 전문과 구현 순서.

검증: npm run test 1081 중 pass 1080 · fail 0, npm run docs:check 최신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hsleedevelop
hsleedevelop merged commit 723e85d into main Oct 5, 2026
1 check passed
hsleedevelop added a commit that referenced this pull request Oct 5, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hsleedevelop
hsleedevelop deleted the hslee/decision-log-split branch October 5, 2026 11:21
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