---
schema_version: 2
session_id: 20260617-112933
resumed_from: null
started_at: 2026-06-17T11:29:33+09:00
ended_at: 2026-06-17T11:52:00+09:00
user_request: |
  기존문서들을 ATP 카테고리로 이관하게 도와
# memory_decision: 후보 1-3 수용(글로벌 ~/.claude/auto-loaded-context.md 기입은 §6 게이트 — 사용자 승인 대기). 후보 4는 Open Item 유지.
---

# Summary
기존 `Docs/` (대문자, git 55파일 추적) 의 프로젝트 고유 구조(Decisions/Features/Plans/Rules/Troubleshooting/WorkDone + 루트 loose)를 `/atp:init` 이 생성한 ATP 표준 카테고리(adr/analysis/architecture/backlog/changes/contracts/development/domain/issues/maintenance/security/usage/work-log)로 이관. 이력 보존 위해 `git mv`. 이관 후 카테고리 index 링크 갱신 + 루트 index.md 재작성.

# Invocations
- id: inv-001
  layer: orchestrator
  name: orchestrator
  parent_invocation_id: null
  started_at: 2026-06-17T11:29:33+09:00
  input_digest: "Docs 구조 조사 + git 추적/케이스 확인 + 분류 기준 로드"
  output_digest: "물리 dir=Docs(대문자), core.ignorecase=true, 55파일 추적, stale lock 파일 1건 발견"
  model_choice:
    phase: analyze
    dispatch_size: direct
    tier: large
    effort: medium
    resolved_model: inherit
    capped: false
    capped_from: null
    escalation_reason: null
    fallback_reason: null
    rationale: "분류 매핑 판단 + 케이스/이력 위험 분석 — orchestrator 직접"
- id: inv-002
  layer: orchestrator
  name: orchestrator
  parent_invocation_id: null
  started_at: 2026-06-17T11:38:00+09:00
  input_digest: "git mv 53파일 + git rm lock 1 + rmdir 구 디렉토리 6"
  output_digest: "53/53 이동 성공, 0 실패. 깨진 내부 링크 7건 식별"
  model_choice:
    phase: code
    dispatch_size: m-batch
    tier: medium
    effort: low
    resolved_model: inherit
    capped: false
    capped_from: null
    escalation_reason: null
    fallback_reason: null
    rationale: "기계적 git mv — orchestrator 직접 실행(파괴적 게이트 user 승인 완료)"
- id: inv-003
  layer: advisor
  name: documentation-advisor
  parent_invocation_id: null
  started_at: 2026-06-17T11:39:00+09:00
  input_digest: "카테고리별 이관 내용 + 깨진 링크 7건 명세"
  output_digest: "22파일 편집(14 카테고리 index + 루트 index + 링크 12개 수정). self_verification pass"
  artifacts: [.atp/work-session/20260617-112933/documentation.md]
  model_choice:
    phase: docs
    dispatch_size: m-batch
    tier: medium
    effort: medium
    resolved_model: sonnet
    capped: false
    capped_from: null
    escalation_reason: null
    fallback_reason: null
    rationale: "14 카테고리 index + 루트 index 재작성 + 링크 수정 = documentation 도메인, 기계적 — medium"

# Advisor Invocation Decision Log
- advisor: requirements-advisor
  decision: skip
  rationale: '스코프 명확 — 사용자 요청 "기존문서를 ATP 카테고리로 이관" 단일 목적. 미결은 분류 정책(user 결정)뿐.'
  checked_at: 2026-06-17T11:30:00+09:00
- advisor: graphify-lookup-advisor
  decision: skip
  rationale: '코드 구조 조사 불필요 — 문서 파일 이동 작업. 파일 목록은 직접 Glob/git ls-files 로 확보.'
  checked_at: 2026-06-17T11:30:00+09:00
- advisor: research-advisor
  decision: skip
  rationale: '외부 자료 불필요. 분류 기준은 document-category-classification.md 로컬 문서로 충분.'
  checked_at: 2026-06-17T11:30:00+09:00
- advisor: design-advisor
  decision: skip
  rationale: '분류 매핑이 design 산출물 — 대부분 파일명/index 로 확정적. 흔들리는 축은 design trade-off 아닌 user 정책 결정(Plans/WorkDone 목적지). orchestrator 가 매핑 작성 + AskUserQuestion plan 게이트(§5.0 (b/c)).'
  checked_at: 2026-06-17T11:31:00+09:00
- advisor: documentation-advisor
  decision: call
  rationale: '이관 후 14개 카테고리 index.md 링크 채우기 + 루트 index.md 재작성 = documentation-advisor 도메인(카테고리 index 링크 필수).'
  checked_at: 2026-06-17T11:31:00+09:00
- advisor: verification-advisor
  decision: skip
  rationale: '코드 변경 0줄(문서 이동). 코드 검증 N/A. 대신 orchestrator 가 링크 무결성/orphan/이동 성공 직접 확인.'
  checked_at: 2026-06-17T11:31:00+09:00
- advisor: graph-refresh-checker
  decision: skip
  rationale: 'docs-only 변경, code scope 미변경(§3.2 no-scope-change). graphify add-on 판정과 무관하게 scope 변경 없음.'
  checked_at: 2026-06-17T11:31:00+09:00

# Decisions
- by: user
  at: 2026-06-17T11:35:00+09:00
  decision: "Plans → 구현/미구현 분리(구현 architecture/, 미구현 backlog/), WorkDone → work-log/, lock 파일 git rm, 실행 진행"
  rationale: "AskUserQuestion 4축 응답"
  related_invocations: [inv-001]
- by: orchestrator
  at: 2026-06-17T11:36:00+09:00
  decision: "Plans 12개 분리 확정: 11개 구현됨(WorkDone 대조 + Setup_Wizard 는 apps/bot/src/commands/setup.ts 로 확인)→architecture/, Feature_Roadmap→backlog/"
  rationale: "WorkDone 30건 + 코드 grep 으로 구현 상태 전수 대조. 실측 카운트 Plans=12 WorkDone=30 (총 55 재대조)"
  related_invocations: [inv-001]

# Conflicts

# verified_by_me
- 링크 무결성: python3 상대링크 존재 검증 145건 중 143 유효. 잔존 2건은 init 템플릿 잔재(아래).
- 구경로 링크 잔존 0 (Troubleshooting|Decisions|Plans|Features|Rules|WorkDone grep CLEAN).
- orphan 0: 모든 이관 문서가 카테고리 index 링크됨 + 14 카테고리 전부 루트 index 등재.
- git mv 53/53 성공, lock 파일 git rm 1, 구 디렉토리 6 정리. rename 정합 확인.

# graph_refresh
- skip: no-scope-change (docs-only 변경, code scope 미변경 — 프로토콜 §3.2)

# needs_user_verification
- (선택) 커밋 여부 결정 — 마이그레이션 일괄. 프로젝트 CLAUDE.md 에 커밋 정책 미정의 → 사용자 확인 필요.

# Open Items
- 'Docs/.!97170!index.md — git rm 처리 완료 (user 승인).'
- '선재 결함(마이그레이션 무관): Docs/development/verification-strategies.md 의 ./agent-team-protocol.md 링크 2건 깨짐. 이 문서는 /atp:init 이 번들에서 복사했으나 agent-team-protocol.md 는 플러그인 번들에만 존재(프로젝트 미복사). init 템플릿 설계 갭 — 별도 처리 필요.'
- '선재 결함(이번 세션 수정): Docs/architecture/database-schema.md 의 prisma 링크가 monorepo 전환 시 doc-sync 누락으로 ../prisma/ (repo-root, 미존재) 를 가리키고 있었음. 실제 위치 packages/db/prisma/schema.prisma 로 정정.'
- 'ADR 파일명 규약: Docs/adr/Dashboard_Architecture_gRPC.md 가 ADR-NNNN 규약 미준수 (documentation-advisor concern). 향후 정규화 후보.'

# User Signals
user_signals:
  positive:
    - quote_or_paraphrase: "AskUserQuestion 4축 1라운드 수락 + '진행'"
      about: "분류 매핑/정책 게이트를 한 번에 수락 — 옵션 설계가 결정 축을 잘 덮음"
  negative: []

# Retrospective
Retrospective:
  signals:
    positive:
      - quote_or_paraphrase: "AskUserQuestion 4축 1라운드 수락 + '진행'"
        about: "Plans 분류(구현/미구현 분리), WorkDone 목적지, lock 파일 처리, 실행 진행 여부 — 4개 결정 축을 단일 라운드로 압축했고 사용자가 한 번에 수락"
    negative: []

  what_went_well:
    - "AskUserQuestion 4축 압축 설계 — 대규모 파일 이동 전 불확실한 결정 포인트(Plans 분류 정책, WorkDone 목적지, stale 파일 처리, 실행 게이트) 를 사전조사 단계에서 전부 발굴해 1라운드에 묶어 제시. 사용자가 이견 없이 수락하고 자율 진행된 것은 옵션 설계가 결정 축을 충분히 덮었다는 검증."
    - "macOS case-insensitive FS 함정을 조기 탐지 — git ls-files 'docs/*' 가 0을 반환했을 때 즉시 의심하고 'Docs/*'(대문자)로 재확인해 55파일 추적 확정. 오판 없이 진행."
    - "알려진 총합(55) 대조로 분류 카운트 오류를 스스로 정정 — 초기 14+28=42 오산을 총 55 재대조로 12+30+나머지 구조로 교정. 외부 피드백 없이 내부 일관성 검사로 수정."
    - "python3 링크 존재 검증 스크립트 활용 — 단순 stale-path grep 대신 실제 파일 존재 여부를 검증해 마이그레이션 무관 선재 결함(database-schema.md 의 monorepo 전환 시 누락된 prisma 경로)까지 표면화하고 이번 세션에서 즉시 수정."

  what_to_improve:
    - "atp:init 번들이 verification-strategies.md 에 agent-team-protocol.md 링크를 삽입하지만, agent-team-protocol.md 자체는 번들에 포함되지 않아 init 직후부터 깨진 링크가 발생한다. 이번 세션에서 표면화된 init 템플릿 설계 갭 — 별도 이슈로 처리 필요."
    - "ADR 파일명이 ADR-NNNN 규약을 미준수한 채로 이관됨 (Docs/adr/Dashboard_Architecture_gRPC.md). 마이그레이션 시 파일명 정규화 여부를 결정 축에 포함하거나 Open Item 으로 명시하는 규율 필요."

  memory_candidates:
    - name: macos-case-insensitive-git-ls-files-trap
      type: feedback
      description: macOS case-insensitive FS + core.ignorecase=true 환경에서 git ls-files 패턴은 대소문자를 맞춰야 한다
      body_draft: |
        macOS (HFS+/APFS default case-insensitive) + `git config core.ignorecase=true` 환경에서 `git ls-files 'docs/*'` 는 물리 디렉토리가 `Docs/`(대문자)이면 0건을 반환할 수 있다. git 인덱스가 저장한 케이스와 패턴 케이스가 불일치할 때 발생하는 함정.

        **Why:** 2026-06-17 세션에서 `git ls-files 'docs/*'` 가 0을 반환해 "미추적" 오판 위험이 있었으나, 물리 경로 `Docs/`(대문자)를 확인 후 `git ls-files 'Docs/*'` 로 재실행해 55파일 추적 확정. 단발 실수가 아니라 macOS 개발 환경 전반의 재현성 있는 함정.

        **How to apply:** `git ls-files <path>` 결과가 예상보다 적거나 0이면, 먼저 `ls` 로 물리 디렉토리명의 실제 케이스를 확인한 뒤 패턴 케이스를 일치시켜 재실행. git 인덱스 케이스는 최초 add 시점 케이스로 고정되므로 물리명이 정답.
      rationale_for_saving: macOS 개발 환경에서 재현성이 높고, git ls-files 결과 0이 "파일 없음"과 "케이스 불일치" 두 원인을 가짐을 코드/문서에서 유도할 수 없다. 이 함정은 관찰로만 드러난다.
      signal_source: observation
      docs_sync_target: null

    - name: known-total-cross-check-for-classification-count
      type: feedback
      description: 분류 카운트 합산은 알려진 전체 수와 대조해 오산을 잡는다
      body_draft: |
        파일 분류 작업(git ls-files, 카테고리 매핑 등)에서 각 카테고리 카운트를 합산한 뒤 **알려진 전체 추적 파일 수와 대조**해 일치 여부를 확인한다.

        **Why:** 2026-06-17 세션에서 Plans=14, WorkDone=28 로 초기 집계했으나 합산이 총 55와 맞지 않았다. 총합 재대조로 Plans=12, WorkDone=30 으로 정정. 외부 피드백 없이 내부 일관성 검사만으로 오류를 발견한 패턴.

        **How to apply:** 분류/카운트 작업의 마지막 단계에서 `sum(카테고리별 수) == 알려진 전체 수` 를 명시적으로 확인. 불일치 시 각 카테고리를 재집계. 알려진 전체 수는 `git ls-files | wc -l` 또는 equivalent 로 먼저 고정.
      rationale_for_saving: 카테고리 분류·마이그레이션 작업에서 반복 적용 가능한 검증 패턴. 코드나 문서에서 유도되지 않으며 관찰로 드러난 교훈.
      signal_source: observation
      docs_sync_target: null

    - name: link-audit-surfaces-pre-existing-doc-debt
      type: feedback
      description: 마이그레이션 링크 감사(파일 존재 검증)는 마이그레이션 무관 선재 문서 부채를 표면화한다 — 그 자리에서 수정한다
      body_draft: |
        대규모 문서 마이그레이션 후 링크 감사를 단순 stale-path grep 이 아니라 **실제 파일 존재 여부 검증**(예: python3 스크립트로 상대 링크 resolve) 으로 수행하면, 마이그레이션과 무관한 선재 결함도 함께 드러난다.

        **Why:** 2026-06-17 세션에서 python3 링크 존재 검증 145건 수행 중, `database-schema.md` 의 `../prisma/` 링크가 monorepo 전환 시 doc-sync 누락으로 이미 깨진 상태였음이 표면화됐다. 이 결함은 이번 마이그레이션이 아닌 이전 monorepo 전환 시 발생한 것.

        **How to apply:** 링크 감사 결과에서 "마이그레이션 원인" 과 "선재 원인" 을 분리해 기록. 선재 결함은 범위 밖이라도 가능하면 그 자리에서 수정(이번 세션처럼). 수정 불가 시 Open Items 에 명시하고 별도 이슈로 이관. stale-path grep 만으로는 이 계층을 볼 수 없으므로 실존 검증을 권장.
      rationale_for_saving: 링크 감사 방법론 선택(grep vs 존재 검증)이 결과 품질에 미치는 차이. 코드/git log 에서 유도 불가. 마이그레이션이 있는 모든 프로젝트에서 재현성 있음.
      signal_source: observation
      docs_sync_target: null

    - name: atp-init-bundle-missing-agent-team-protocol-link-gap
      type: project
      description: atp:init 번들이 verification-strategies.md 에 agent-team-protocol.md 링크를 생성하지만 파일 자체는 번들에 미포함 — init 직후 깨진 링크 발생
      body_draft: |
        `/atp:init` 실행 시 번들에서 `Docs/development/verification-strategies.md` 가 복사되며, 이 파일은 `./agent-team-protocol.md` 를 2곳 참조한다. 그러나 `agent-team-protocol.md` 는 플러그인 번들에만 존재하고 프로젝트 디렉토리에는 복사되지 않아, init 직후부터 링크가 깨진 상태.

        **현황:** Kord 프로젝트에서 2026-06-17 세션 링크 감사 중 발견. Open Items 에 등재. 별도 처리(agent-team-protocol.md 를 번들에 포함하거나 링크를 외부 URL 로 교체) 필요.
      rationale_for_saving: atp:init 설계 갭으로, 이 프로젝트 외 atp:init 을 사용하는 모든 프로젝트에서 동일하게 재현. 코드/문서에서 식별하기 어려운 구조적 누락.
      signal_source: observation
      docs_sync_target: null

  protocol_feedback:
    - "atp:init 번들 점검 필요: verification-strategies.md 가 ./agent-team-protocol.md 를 참조하지만 해당 파일이 번들에 포함되지 않아 init 직후 깨진 링크가 발생한다. 번들에 포함하거나 참조를 외부 링크로 교체하는 수정 필요 (structural: true — 모든 atp:init 프로젝트에서 재현)."
    - "대규모 문서 마이그레이션 절차에 링크 감사 방법론 명시 추천: stale-path grep 이 아니라 파일 존재 검증(python3 또는 equivalent)을 권장 방법으로 기술하면 선재 문서 부채 표면화 효과를 기대할 수 있음."

  applied_changes: []
