157 lines
11 KiB
Markdown
157 lines
11 KiB
Markdown
---
|
|
schema_version: 2
|
|
session_id: 20260617-172407
|
|
resumed_from: null
|
|
started_at: 2026-06-17T17:24:07+09:00
|
|
ended_at: 2026-06-17T17:40:00+09:00
|
|
user_request: |
|
|
W3에서 기능별로 골자는 정해두고 싶어. 당장 작업하려는건 아니야
|
|
---
|
|
|
|
# Summary
|
|
W3(사이트 플랫폼 워크스트림) 5개 서브기능(W3-1 태그+검색, W3-2 댓글/리뷰, W3-3 포스팅 보드, W3-4 메인 허브, W3-5 Unity 업로드 deferred)의 "골자"를 정의하는 기획 정리 세션. 사용자 명시: 당장 구현 아님(코드 0줄). 산출은 문서 only.
|
|
|
|
# Invocations
|
|
- id: inv-001
|
|
layer: orchestrator
|
|
name: orchestrator
|
|
started_at: 2026-06-17T17:24:07+09:00
|
|
input_digest: "W3 기능별 골자 정의 요청 (구현 아님)"
|
|
output_digest: "프로토콜+로드맵 로드, 골자 깊이/범위 미결 → 계획 게이트 진입 예정"
|
|
artifacts: []
|
|
concerns: []
|
|
|
|
# Advisor Invocation Decision Log
|
|
# 각 advisor 호출/스킵 판단 즉시 1줄 append
|
|
- advisor: requirements-advisor
|
|
decision: call
|
|
rationale: '골자=기능 윤곽+미결질문 도출 = requirements 도메인. 코드현황 대조 필요(컨텍스트 오염 방지 위임). tier=medium/effort=medium/s-batch'
|
|
checked_at: 2026-06-17T17:24:07+09:00
|
|
- advisor: design-advisor
|
|
decision: skip
|
|
rationale: '윤곽 카탈로그 깊이 — 미결질문을 남기는 게 목적, 오픈질문0 완결설계 아님. 본격 design 은 기능별 착수 시'
|
|
checked_at: 2026-06-17T17:24:07+09:00
|
|
- advisor: verification-advisor
|
|
decision: skip
|
|
rationale: '코드 변경 0줄(문서 only 기획) — 검증 대상 없음'
|
|
checked_at: 2026-06-17T17:24:07+09:00
|
|
- advisor: graph-refresh-checker
|
|
decision: skip
|
|
rationale: 'src/ scope 변경 없음(docs only) — no-scope-change'
|
|
checked_at: 2026-06-17T17:24:07+09:00
|
|
|
|
# Decisions
|
|
- by: user
|
|
at: 2026-06-17T17:24:07+09:00
|
|
decision: "골자 깊이=윤곽 카탈로그 / W3-5 deferred=포함(조사항목 스텁만)"
|
|
rationale: "당장 구현 아님 — 미결질문 남기는 1페이지 카탈로그"
|
|
related_invocations: [inv-001]
|
|
- by: orchestrator
|
|
at: 2026-06-17T17:24:07+09:00
|
|
decision: "산출 카테고리 backlog → work-log 정정"
|
|
rationale: "document-category-classification §backlog 은 '확정 로드맵 제외' 명시. W3 골자는 확정 로드맵(W1~W4) 구체화 = work-log(로드맵과 동일 카테고리, 시점성 기획). 자체 발견 정정(§2.3)"
|
|
related_invocations: [inv-001]
|
|
|
|
# Conflicts
|
|
|
|
# Open Items
|
|
- 미커밋 잔여: docs/work-log/2026-06-17-w3-feature-skeletons.md(신규), docs/work-log/index.md(수정), .atp/work-session/20260617-172407/(신규). 커밋 여부 사용자 판단 대기(CLAUDE.md 커밋 정책 = 명시 요청 시).
|
|
- QG-3 (코드 잠재 버그): /game/** 정적 핸들러 미등록(UploadResourceConfig 는 /profile/** 만) — W3-5 착수 전 의도/버그 확인 필요. 골자 범위 밖이라 본 세션 미수정.
|
|
|
|
# verified_by_me
|
|
- L1/L2: 해당 없음 — 코드 변경 0줄(문서 only 기획). verification-advisor skip.
|
|
- 문서 정합성: work-log/index.md 링크 추가 확인, source_roadmap 상호 링크 확인, 골자 깊이(DDL/API/시퀀스 없음·미결 해소 안 함) 사용자 확정과 일치.
|
|
|
|
# needs_user_verification
|
|
- 골자 카탈로그 검토(5기능 미결질문·결합표·착수순서가 의도와 맞는지).
|
|
- QG-3 /game/** 핸들러 동작 확인은 W3-5 착수 시 research 단계 과제.
|
|
|
|
# graph_refresh
|
|
- skip: no-scope-change — src/ 변경 0(docs only). graph-refresh-checker 미호출(§3.2 호출 스킵 조건 충족).
|
|
|
|
# User Signals
|
|
user_signals:
|
|
positive:
|
|
- quote_or_paraphrase: "AskUserQuestion(깊이+범위) 1회에 명확히 답하고 수락(윤곽 카탈로그 + deferred 포함)"
|
|
about: "계획 게이트 옵션 설계 — 미리보기로 깊이 차이를 구체화한 것이 1회 수락으로 이어짐"
|
|
negative:
|
|
- quote_or_paraphrase: "너 혼자 정한거야? → 걸리는 곳: 골자 내용 자체"
|
|
about: "골자 내용(5기능 미결질문 선정·결합 해석·착수순서 제언)을 사용자 검토 없이 advisor→work-log 문서로 확정. 깊이/범위만 계획 게이트로 묻고, 정작 이 세션의 핵심 deliverable 인 골자 내용은 동의 없이 굳힘. '골자는 정해두고 싶어'=함께 정하자는 의도를 통보로 처리."
|
|
structural: true
|
|
|
|
# Protocol Feedback
|
|
protocol_feedback:
|
|
- issue: "문서-only 기획 세션의 산출물 내용 동의 게이트 부재"
|
|
detail: "§5.0 계획 가시성 의무는 '첫 코드 변경 전' 동의를 강제한다. 코드 변경 0인 기획/골자 세션에선 이 트리거가 안 걸려, 산출물(골자) 내용 자체를 사용자 동의 없이 advisor→docs 로 확정하는 경로가 열린다. §5.0 은 'design 산출물은 파일로만 존재, orchestrator 가 핵심 결정 전달 책임'을 말하나, 문서 세션에서 그 '전달'을 확정 전 동의가 아닌 사후 보고로 처리해도 막는 규정이 없다."
|
|
repro: "요청='X 골자/기획 정해두고 싶어' + 코드 변경 0. orchestrator 가 깊이/범위만 게이트로 묻고 내용은 advisor 산출→docs 직행 확정."
|
|
proposed: "문서가 곧 deliverable 인 세션(기획/골자/설계 문서)은 advisor 산출 내용을 docs 정식 배치 전 사용자 검토 게이트를 1회 둔다. '코드 변경 전' 대신 'deliverable 확정 전' 으로 §5.0 트리거 일반화."
|
|
|
|
---
|
|
|
|
# Retrospective
|
|
|
|
```yaml
|
|
Retrospective:
|
|
signals:
|
|
positive:
|
|
- quote_or_paraphrase: "AskUserQuestion(깊이+범위) 1회에 명확히 답하고 수락(윤곽 카탈로그 + deferred 포함)"
|
|
about: "계획 게이트에서 3단계 깊이(윤곽/설계/구현) 옵션을 미리보기로 구체화 — 왕복 없이 1회 결정 완료"
|
|
negative: []
|
|
|
|
what_went_well:
|
|
- "계획 게이트 AskUserQuestion에서 깊이 옵션을 추상 레이블이 아닌 산출물 차이(미결질문 남김 vs DDL/API까지 vs 코드 직접) 미리보기로 구체화했고, 사용자가 1회 수락으로 범위 확정. 재호출 없이 완료."
|
|
- "orchestrator가 산출 카테고리를 backlog로 추정했다가 document-category-classification.md §backlog('확정 로드맵 제외' 명시)를 읽고 work-log로 자체 정정(§2.3). 분류기준 문서가 의도대로 작동함."
|
|
- "requirements-advisor가 코드 대조(GamesMapper, GameCommentsMapper, UploadResourceConfig)를 수행해 '결합/의존' 섹션 정확도를 높임. 분류 문서 없이 추정만 했다면 결합표가 부정확했을 것."
|
|
|
|
what_to_improve:
|
|
- "orchestrator가 분류기준 문서를 읽기 전에 backlog를 추정 출력했다가 정정한 패턴이 재현 가능. 문서 카테고리 결정은 산출 시점이 아니라 배치 전 document-category-classification.md 조회 후 결정하는 순서를 고정해야 한다."
|
|
|
|
memory_candidates:
|
|
- name: doc-category-read-before-placement
|
|
type: feedback
|
|
description: "문서 산출 카테고리는 document-category-classification.md를 읽은 후 결정한다 — 추정 먼저 출력 금지"
|
|
body_draft: |
|
|
orchestrator가 docs/ 산출물 배치 카테고리를 결정할 때, document-category-classification.md를 확인하기 전에 추정값을 먼저 사용하면 정정 사이클이 발생한다.
|
|
|
|
**Why:** 2026-06-17 세션(20260617-172407)에서 W3 골자 기획 문서를 backlog로 추정했다가, document-category-classification.md §backlog("확정된 로드맵 제외")를 읽고 work-log로 정정. 분류기준이 명문화돼 있어 조회만 했으면 첫 판단이 정확했을 것.
|
|
|
|
**How to apply:**
|
|
- 산출 문서를 처음 배치할 때 조건 판단 전에 document-category-classification.md를 먼저 읽는다.
|
|
- 빠른 결정 순서(§빠른 결정 순서)를 따라 해당 카테고리를 선택한 후 배치한다.
|
|
- 추정이 맞더라도 근거 없는 추정은 report.md Decisions에 기록하지 말고 조회 후 기록한다.
|
|
- 적용 조건: docs/ 하위 신규 문서 배치 시 전건 적용.
|
|
rationale_for_saving: "분류기준 문서가 존재하지만 '먼저 읽어야 한다'는 절차는 CLAUDE.md나 프로토콜에 명시되어 있지 않음. orchestrator가 추정-정정 사이클을 반복할 수 있는 구조적 빈틈. 재현 가능성 높음."
|
|
signal_source: observation
|
|
docs_sync_target: /Users/wemadeplay/workspace/stz/bibimbap/docs/development/agent-team-protocol.md
|
|
|
|
- name: plan-gate-depth-preview-single-pass
|
|
type: feedback
|
|
description: "계획 게이트에서 깊이/범위 옵션을 산출물 차이 미리보기로 구체화하면 1회 수락으로 이어진다"
|
|
body_draft: |
|
|
AskUserQuestion의 깊이/범위 옵션을 추상 레이블만으로 제시하면 추가 질문이 발생하지만, 각 옵션 선택 시 실제 산출물이 어떻게 달라지는지를 2~3줄 미리보기로 포함하면 왕복 없이 결정 완료된다.
|
|
|
|
**Why:** 2026-06-17 세션(20260617-172407)에서 W3 골자 깊이를 "윤곽 카탈로그 / 설계 완결 / 구현 착수"로 구분하고 각 옵션의 산출물 차이(미결질문 남김 여부, DDL/API 포함 여부, 코드 직접 작성 여부)를 미리보기로 제시. 사용자가 재질의 없이 1회 수락(윤곽 카탈로그 + deferred 포함).
|
|
|
|
**How to apply:**
|
|
- 깊이/범위 옵션 ≥ 2이고, 선택이 이후 작업량과 산출 형식을 크게 바꾸는 경우에 적용.
|
|
- 옵션별로 "이 옵션을 선택하면 X가 포함되고 Y는 다음 세션으로" 형식의 2~4줄 비교를 포함한다.
|
|
- 전체 설계 공유는 과잉 — 선택 기준이 되는 핵심 차이만 기술한다.
|
|
- 기존 memory `preview-requery-pattern`(agent-team-protocol 프로젝트)과 동일 패턴. 중복 후보 — 해당 memory가 bibimbap 프로젝트에도 적용 가능한지 orchestrator가 판단 후 신규 저장 여부 결정.
|
|
rationale_for_saving: "agent-team-protocol 프로젝트에 `preview-requery-pattern`으로 이미 존재. bibimbap 프로젝트 memory에는 없으나, 패턴 자체는 기존 memory와 중복. orchestrator가 프로젝트별 memory 저장 필요성을 판단해야 하므로 후보로 올려 위임."
|
|
signal_source: positive
|
|
conflicts_with: preview-requery-pattern (agent-team-protocol 프로젝트)
|
|
docs_sync_target: null
|
|
|
|
protocol_feedback: []
|
|
|
|
applied_changes:
|
|
- "memory_candidates 2건 검토 → 둘 다 미수용(보류)."
|
|
- "후보1 doc-category-read-before-placement: 기존 CLAUDE.md docs-first 정책('작업 시작 전 카테고리 index→구체 문서')에 내포된 교훈. 위반은 단발 실수(self-caught, 비용 0). docs_sync_target(플러그인 번들 agent-team-protocol.md)은 §6 ~/.claude 수정 금지 + bibimbap 경로 부재로 부적합. 신규 MEMORY 불필요."
|
|
- "후보2 plan-gate-depth-preview-single-pass: 일반 UX 패턴, agent-team-protocol 프로젝트 preview-requery-pattern 중복, 프로젝트 특정성 없음. bibimbap 중복 저장 가치 낮음."
|
|
```
|
|
|
|
# Closeout
|
|
- ended_at: 2026-06-17T17:40:00+09:00
|
|
- 미커밋 잔여(커밋 정책 = 사용자 명시 요청 시): docs/work-log/index.md(M), docs/work-log/2026-06-17-w3-feature-skeletons.md(??), .atp/work-session/20260617-172407/(??). 사용자 커밋 결정 대기.
|
|
- project-gate: skip: no-project-gate (코드 0줄, 런타임 게이트 무의미).
|