Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,17 @@ modified: 2026-09-13
같은 커밋이면 통과, 다른 커밋·`origin/HEAD` 없음은 종전처럼 거부한다. git 실패는 계속 fail-closed이고 `done` 가드는
브랜치를 조회하지 않아 영향이 없다.

### Docs
- **`docs/harness-workflow-simulation.html` 본문을 현행 동작에 맞추고 `docs:check` 현행 문서로 등록했다** (task `simulation-doc-refresh`).
0.40.1~0.44.4 CHANGELOG를 시나리오별로 대조해(대조표는 task artifact) 워크스루 단계를 고쳤다 — user handoff는 gitignore된
워크트리 로컬이고 `task` 활성화가 쓴다(구조·S2·S5·S6), handoff 갱신분은 다음 작업 커밋에 담고 단독 sweep은 푸시 직전만(S3),
머지 후 종결은 기본 브랜치에서 체크→`done`→`summary --write`→커밋 하나(S4), `--member` 우선·거부되는 이름(S2),
관리 절은 `init`이 렌더하고 `doctor`가 낡은 절을 경고(S1), `init --stack` 고정과 `harness-team stack`의 `pin:` 줄(S1·명령 카드),
`list --remote`·`--area`(명령 카드). handoff 항목·user handoff 예시도 실제 렌더 형식으로 바로잡았다.
표지 셋(hero·🆕 배너·footer)을 package.json 버전에 맞추고 `excludedCurrentDocuments`에서 `currentVersionDocuments`로 옮겼다 —
이제 표지가 밀리면 `npm run docs:check`가 실패한다 — `MAINTAINING.md` 릴리스 5단계에 이 문서의 표지 3곳 갱신을 추가했다.
`docs/followups.md` 10번을 지웠다.

## [0.44.4] - 2026-09-27

### Fixed
Expand Down
8 changes: 6 additions & 2 deletions MAINTAINING.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,12 +194,16 @@ grep -rn 'origin/main' commands/ skills/ templates/
이고 이 셋은 템플릿에 하드코딩돼 있습니다. `docs:check`는 이 셋의 **버전 번호**가 `package.json`과
같은지만 대조합니다(`scripts/docs-version-drift.mjs`) — 배너 **산문**이 이번 릴리스를 제대로 설명하는지는
사람이 봐야 합니다. 생성물을 직접 고치면 다음 `docs:generate`가 되돌립니다. 템플릿을 고치고 재생성하세요.
- **`docs/harness-workflow-simulation.html`의 버전 표지 3곳(hero 배지·최신 🆕 배너·footer)도 손으로 올립니다** —
overview 템플릿과 같은 모양이고 `docs:check`가 같은 방식으로 대조합니다. 새 릴리스가 워크스루 단계를 바꿨으면
표지만 올리지 말고 해당 시나리오 본문을 먼저 고칩니다 — 표지는 본문이 현행이라는 도장입니다.
- **`docs/index.html`의 what-changes 목록에 새 버전을 등재합니다** — 등재하지 않으면 방금 쓴
릴리스 노트가 문서 허브에서 도달 불가입니다. `docs:check`가 목록의 첫 항목이 현행 버전인지 대조합니다.
- **왜 이 두 줄이 절차에 있나:** 0.22.0과 0.23.0이 **연속으로** overview 템플릿을 놓쳐 배지가
- **왜 이 줄들이 절차에 있나:** 0.22.0과 0.23.0이 **연속으로** overview 템플릿을 놓쳐 배지가
두 세대(v0.21.0) 밀린 채 발행됐습니다. 가드 없는 표면은 절차에 적히지 않으면 반드시 밀립니다.
결합 강도 순서를 기억하세요: `what-changes-*`(3방향 강제) > `harness-overview`·`index.html`(생성+pin·버전 표지 대조,
**산문은 무방비**) > `prerequisites.md`(doctor 양방향) > simulation·guide류(**가드 0** — "X 기준" 라벨 문서와
**산문은 무방비**) > `harness-workflow-simulation.html`(버전 표지 대조만, **본문은 무방비**) >
`prerequisites.md`(doctor 양방향) > guide류(**가드 0** — "X 기준" 라벨 문서와
명시 제외 문서는 표지 대조 대상이 아닙니다. 분류 규칙은 `scripts/docs-version-drift.mjs` 머리 주석).
6. `CHANGELOG.md`의 `## [Unreleased]`를 새 버전 헤딩(`## [X.Y.Z] - YYYY-MM-DD`)으로 이동
7. main에서 4~6단계의 결과를 **한 커밋**으로 만들어 push합니다. 기능 변경은 PR로 들어오지만, 릴리스 준비 커밋 자체는 그 PR들이 이미 병합된 main 위에 얹는 범프·문서 커밋입니다.
Expand Down
15 changes: 3 additions & 12 deletions docs/followups.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,9 @@

## 우선순위

**남은 것: 10번 하나.**

10. **`docs/harness-workflow-simulation.html` 본문 현행화 → 버전 드리프트 검사 등록** (2026-09-27, task `docs-version-drift-check`)
- 문제: hero 배지·🆕 배너·footer가 v0.40.0에 머물러 있다(현행과 16릴리스 차이). 그러나 본문 시나리오가
0.40.0 기준이라 표지만 고치면 틀린 문서에 현행 도장을 찍는다 — 적어도 0.42.1(handoff 단독 커밋 중단)·
0.44.0(머지 후 종결은 커밋 하나)이 워크스루 단계에 걸린다. 0.40.1–0.44.2 CHANGELOG 전체를 대조해야 한다.
- 현재 상태: `scripts/docs-version-drift.mjs`의 `excludedCurrentDocuments`에 사유와 함께 올라 있다 —
조용히 빠진 것이 아니라 **명시 제외**다. 분류가 `current`인 한 제외 항목은 유지되고, "기준" 라벨을 달아
`baseline`이 되면 검사가 낡은 제외 항목이라며 실패한다.
- 완료 조건: 본문을 현행화하고 표지 셋을 package.json 버전에 맞춘 뒤, 항목을 `excludedCurrentDocuments`에서
`currentVersionDocuments`로 옮긴다(표지는 `overviewMarkers`와 같은 hero·🆕·footer, footer 정규식만 확인).
`npm run docs:check` green.
**남은 것: 없음.**
(10번은 2026-09-28 task `simulation-doc-refresh`로 처리했다 — 시뮬레이션 문서 본문을 현행화하고
`docs:check` 현행 문서로 등록했다. 대조표는 그 task의 artifact에 있다.)
(4번은 2026-09-12에 **B(src 상수 + 문서 블록 + pin)로 결정**해 task `framing-prompts-in-src`로 올려 여기서 지웠다.
testcritic은 `--rubric` 선택자로 3 루브릭 모두 src에 둔다.)
(6번은 2026-09-12에 처리했다. 다만 **전제가 반쯤 뒤집혔다** — 실측 결과 이 머신(데스크톱 앱 세션)에서는
Expand Down
Loading
Loading