{
  "schemaVersion": 2,
  "runId": "2026-09-16-2002",
  "project": "keycloak",
  "record": "docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
  "startedAt": "2026-09-16T20:02:43+09:00",
  "finishedAt": "2026-09-16T20:15:37+09:00",
  "stages": [
    {
      "id": "S1",
      "name": "코드베이스 → SSOT",
      "skill": "analyzing-codebase-for-tech-log",
      "runBy": "ssot-analyst",
      "status": "SKIPPED",
      "skipReason": "SSOT(docs/keycloak/final/document.md)가 이미 있고 이 기록의 근거를 그 안에서 찾을 수 있다. 이번 런은 기록의 칸 배치를 고치는 것이라 SSOT 를 건드리지 않았다.",
      "skillEcho": "",
      "skillRevision": "edd45dfec66d155a621cd41186b83b5582f2244c",
      "inputs": [],
      "outputs": [],
      "gates": [],
      "notes": "",
      "finishedAt": "2026-09-16T20:05:55+09:00",
      "finishedBy": null
    },
    {
      "id": "S2",
      "name": "SSOT → 분해 계약",
      "skill": "deriving-tech-log-root-tree",
      "runBy": "tree-deriver",
      "status": "SKIPPED",
      "skipReason": "이 글감은 tech-log-tree.json 에 PROMOTE·CONFIRMED 로 이미 있다. 계약이 아니라 기록 파일 안의 문단 위치를 고쳤다.",
      "skillEcho": "",
      "skillRevision": null,
      "inputs": [],
      "outputs": [],
      "gates": [],
      "notes": "",
      "finishedAt": "2026-09-16T20:05:55+09:00",
      "finishedBy": null
    },
    {
      "id": "S3",
      "name": "글감 → 기록",
      "skill": "writing-tech-log-records",
      "runBy": "record-writer",
      "status": "DONE",
      "skipReason": "",
      "skillEcho": "수치, 날짜, 버전, 단위, 코드, 명령어, URL, 인용, 공식 명칭은 원문과 한 글자도 달라지면 안 된다.",
      "skillRevision": null,
      "inputs": [],
      "outputs": [
        "docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md"
      ],
      "gates": [
        {
          "cmd": "python3 scripts/studio-body.py docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md -o /tmp/sb.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:05:55+09:00"
        },
        {
          "cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/sb.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:05:55+09:00"
        },
        {
          "cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:05:55+09:00"
        },
        {
          "cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:05:55+09:00"
        },
        {
          "cmd": "python3 scripts/check-required-content.py --file docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:05:55+09:00"
        }
      ],
      "notes": "둘째 문단 170자를 「목적」 칸 마지막 문단으로 한 글자도 고치지 않고 옮겼다. 지우지 않은 이유가 둘이다 — (가) 「인가된 클라이언트(authorized client)」 영문 원어 대응이 파일 전체에서 이 문단에만 있다(grep -i \"authorized client\" 로 확인). (나) 네 항목을 함께 설계해야 한다는 범위 진술 자체가 없었고, 옮기기 전 「목적」 칸에는 로그아웃과 downstream 오류가 아예 없었다. 네 항목 중 셋이 규칙 2·3·4 에 있는 것은 확인했지만 그것은 규칙 하나씩이지 범위가 아니다.",
      "startedAt": null,
      "generation": 1,
      "owner": null,
      "elapsedSeconds": 0,
      "finishedAt": "2026-09-16T20:05:55+09:00",
      "finishedBy": null
    },
    {
      "id": "S4",
      "name": "기록 → 그림",
      "skill": "technical-visualizer",
      "runBy": "diagram-maker",
      "status": "SKIPPED",
      "skipReason": "그림이 필요 없다. 이번 런은 제목 아래 문단을 알맞은 칸으로 옮기거나 지운 것이라 새로 그릴 소재가 생기지 않았다.",
      "skillEcho": "",
      "skillRevision": "edd45dfec66d155a621cd41186b83b5582f2244c",
      "inputs": [],
      "outputs": [],
      "gates": [],
      "notes": "",
      "finishedAt": "2026-09-16T20:05:55+09:00",
      "finishedBy": null
    },
    {
      "id": "S5",
      "name": "AI 티 제거",
      "skill": "rewriting-technical-prose-naturally",
      "runBy": "prose-rewriter",
      "status": "DONE",
      "skipReason": "",
      "skillEcho": "| One sentence runs through two subjects, scales, or results | Split it at the subject change |",
      "skillRevision": null,
      "inputs": [],
      "outputs": [
        "docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md"
      ],
      "gates": [
        {
          "cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:10:30+09:00"
        },
        {
          "cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/style_profile.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
          "exit": 1,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:10:30+09:00"
        },
        {
          "cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/s5.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:10:30+09:00"
        },
        {
          "cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:10:30+09:00"
        }
      ],
      "notes": "옮겨 온 문단의 두 자리를 고쳤다. (가) 문단이 목적 끝으로 내려오면서 「인가된 클라이언트」의 첫 사용이 목적 1문단이 되고 원어 대응은 3문단에 남았다 — 대응을 첫 사용 앞으로 옮겼다(지운 것이 아니라 이동, 파일 안 출현 횟수 여전히 1). (나) 155자 네 항목 나열을 주어가 바뀌는 자리에서 끊었다. 120자 초과 비율 0.096→0.075. 안 고친 것 — 목적 첫 문장이 「세션」+「토큰을 보관하는 인가된 클라이언트」인지 「세션과 토큰」을 보관하는 것인지 두 가지로 읽힌다. 풀려면 어떤 토큰이 어디 있다는 판정을 해야 해서 남긴다.",
      "startedAt": null,
      "generation": 1,
      "owner": null,
      "elapsedSeconds": 0,
      "finishedAt": "2026-09-16T20:10:30+09:00",
      "finishedBy": null
    },
    {
      "id": "S6",
      "name": "일한 사람의 목소리",
      "skill": "writing-as-the-person-who-did-it",
      "runBy": "voice-writer",
      "status": "DONE",
      "skipReason": "",
      "skillEcho": "**쓸 수 있는 것은 자료가 기록한 사람의 행동과 판단뿐이다.** 넣은 문장마다 그것이 어느 파일,",
      "skillRevision": "edd45dfec66d155a621cd41186b83b5582f2244c",
      "inputs": [],
      "outputs": [
        "docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md"
      ],
      "gates": [
        {
          "cmd": "node .agents/skills/writing-as-the-person-who-did-it/scripts/check_voice.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:15:37+09:00"
        },
        {
          "cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/reference/reference-bff-auth-design.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:15:37+09:00"
        },
        {
          "cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/s6.md",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:15:37+09:00"
        },
        {
          "cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo",
          "exit": 0,
          "session": null,
          "generation": 1,
          "at": "2026-09-16T20:15:37+09:00"
        }
      ],
      "notes": "흔적 하나와 모호함 수정. 목적 첫 문단에 「브라우저 응답에서 토큰이 안 보인다고 토큰을 다루는 일까지 없어지지는 않는다 · BFF 는 프록시가 아니라 로그인 상태와 토큰을 가진 보안 구성요소가 된다」를 넣었다 — 근거는 SSOT:167 과 :1461, 둘 다 source 앵커 안이다. 그리고 S5 가 보고한 모호함을 SSOT 로 갈랐다 — 「세션」 + 「토큰을 보관하는 인가된 클라이언트」 둘이 맞다. SSOT:239 가 토큰은 authorized client 에 로그인 상태는 AP3_SESSION 에 라고 나누고, :167 의 「session 에서 authorized client 를 찾고」가 세션이 같은 그릇이 아니라 찾는 입력임을 보인다. 같은 기록 규칙 3 도 조회 열쇠가 다르다고 이미 적고 있다. 근거가 분명해 한 문장을 둘로 끊고 주어를 각각 붙였다.",
      "startedAt": null,
      "generation": 1,
      "owner": null,
      "elapsedSeconds": 1,
      "finishedAt": "2026-09-16T20:15:37+09:00",
      "finishedBy": null
    },
    {
      "id": "S7",
      "name": "Studio 저장",
      "skill": "publishing-tech-log-to-studio",
      "runBy": "studio-validator",
      "status": "SKIPPED",
      "skipReason": "사용자가 Studio 반입을 요청하지 않았다. 이 기록은 이미 게시돼 있고 S7 은 저장까지인데, 저장하면 Studio 쪽 version 이 올라간다. 저장소와 공개본이 갈린 상태로 두고 사람이 판단할 일로 넘긴다. 게시는 어떤 경우에도 하지 않는다.",
      "skillEcho": "",
      "skillRevision": null,
      "inputs": [],
      "outputs": [],
      "gates": [],
      "notes": "",
      "finishedAt": "2026-09-16T20:15:37+09:00",
      "finishedBy": null
    }
  ],
  "revision": 23,
  "updatedAt": "2026-09-16T20:15:37+09:00",
  "sessions": [
    {
      "session": null,
      "stage": "S3",
      "generation": 1,
      "beganAt": "2026-09-16T20:05:55+09:00"
    },
    {
      "session": null,
      "stage": "S5",
      "generation": 1,
      "beganAt": "2026-09-16T20:10:30+09:00"
    },
    {
      "session": null,
      "stage": "S6",
      "generation": 1,
      "beganAt": "2026-09-16T20:15:36+09:00"
    }
  ]
}