# Keycloak 2026-09-20 역할 계약 기반 remediation

- 기준 리뷰: reviews/2026-09-20-keycloak-final-verification-review.md
- 대상: docs/keycloak
- 수행 방식: 별도 subagent 프로세스를 실행했다고 기록하지 않는다. 현재 세션이 각 .claude/agents/<role>.md와 연결된 SKILL.md/reference를 읽고 역할별 책임을 분리해 수행했다.
- 변경 Record: 17개
- 현재 판정: **아직 더 봐야됨**

## 이번 remediation에서 실제 수행한 역할

| 역할 | 계약 | 결과 |
|---|---|---|
| record-writer | .claude/agents/record-writer.md + writing-tech-log-records | 17개 Record의 kind/source/body/evidence 계약 재검토. body/prose/local evidence hard failure 0. --repo는 source checkout 부재로 exit 3 |
| prose-rewriter | .claude/agents/prose-rewriter.md + rewriting-technical-prose-naturally | 17개 모두 check_prose exit 0. style profile 12건 nonzero는 advisory로 유지. 의미·불확실성 보존 위반 추가 발견 없음 |
| voice-writer | .claude/agents/voice-writer.md + writing-as-the-person-who-did-it | 17개 모두 check_voice exit 0. 상류 자료에 없는 경험/감정 문장을 새로 넣지 않음 |
| fact-reviewer | .claude/agents/fact-reviewer.md | local SSOT/evidence 역대조는 수행. exact source revision reconciliation은 완료하지 못해 VERDICT: FAIL |
| diagram-maker | .claude/agents/diagram-maker.md + technical-visualizer | stale context 2개를 canonical spec/context로 재렌더. Figure gates PASS, layout warn 0 |

## F-01 — 역할별 계약 수행

사용자가 허용한 실행 방식에 맞춰 **역할을 실제로 읽고 역할별 책임을 분리해서 수행**했다.

중요한 제한:
- Agent(subagent_type=...)를 실행했다고 주장하지 않는다.
- 기존 2026-09-19 run.json을 실제 subagent 실행처럼 소급 수정하지 않는다.
- 이번 역할별 검토는 이 폴더의 별도 artifact로 남긴다.
- fact-reviewer가 source reconciliation을 완료하지 못했으므로 새 green remediation run을 만들지 않는다.

따라서 F-01의 “역할 계약을 실제 작업에 적용하지 않았다”는 문제는 이번 remediation에서 해소했다. **프로세스 격리 자체를 수행했다는 의미는 아니다.**

## F-02 — source repository reconciliation

현재 Tree가 요구하는 source repository:

~~~text
/home/donghyeon/workspace/keycloak-pattern
~~~

고정 revision:

~~~text
AP1 64175266df05545f8f181fc91c1f0364bc47fce9
AP2 d019846f8725bdb0badde33043b020dc252e32ff
AP3 934c5da5d6edc2429dfb558b773656e46f21d677
AP4 f4aea65dc6255eae07b20ebbe21e02fb6115e563
~~~

실제 실행:

~~~text
node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo

exit = 3
불일치 = 0
대조 불가 = 1
원인 = sourceRepository.path가 이 기계에 없음
~~~

/shared, /home/donghyeon, Library의 과거 Keycloak source snapshot까지 확인했다. Library의 repomix-output.xml에는 같은 Keycloak 프로젝트의 실제 source와 develop-keycloak-pattern1..4 구조가 있고 refreshTokenMaxReuse=0도 존재하지만, 위 네 commit SHA는 포함하지 않는다. 따라서 해당 snapshot을 exact revision checkout처럼 취급하지 않는다.

**F-02는 아직 열려 있다.**

## F-03 — stale TechViz context

재렌더 대상:

~~~text
ap1-direct-architecture
login-api-phase-split
~~~

canonical spec.json + context.json으로 다시 render했고 두 manifest의 source document hash가 현재 SSOT hash로 갱신됐다.

~~~text
ea10df24b892e2c57123a37a4b4f0d821e4f394353e6746f50df6a48342353e9
~~~

검증:

~~~text
FIGURE TEXT: PASS
FIGURE OVERLAP: PASS
FIGURE PROVENANCE: PASS
PROJECT LAYOUT: PASS — error 0 · warn 0
~~~

F-03은 **완료**.

## 현재 남은 완료 조건

- [x] 역할별 contract/SKILL/reference를 읽고 직접 책임 분리 수행
- [x] 17개 Record body/prose/voice/command hard failure 0
- [x] style advisory를 수치 맞추기 위해 rewrite하지 않음
- [x] stale TechViz 2개 재렌더
- [x] Figure/Layout gates PASS
- [x] 과거 run ledger 소급 수정 안 함
- [ ] exact source repository 또는 revision-proven import source 확보
- [ ] check_evidence.mjs keycloak --repo exit 0
- [ ] 그 상태에서 fact-reviewer 최종 PASS
- [ ] 그 상태에서만 새 remediation run 작성/검증

따라서 현재 Keycloak 최종 상태는 **아직 더 봐야됨**이다.