From 1fb6670e6741740238bd70b74552bf9b5393a4c8 Mon Sep 17 00:00:00 2001 From: altair823 Date: Sat, 25 Apr 2026 17:10:04 +0900 Subject: [PATCH] docs: decouple due-date spec from dogfood strategy doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The due-date extraction work originated as feedback during dogfood, but the dogfood strategy doc itself should stay feature-agnostic — it's the generic operating manual for the 2-week dogfood, not a feedback log. - Remove the "시간 표현 포함 노트 수" row from dogfood-strategy §3.1. - Rephrase the due-date spec stub so H1 / §7 / §9 reference the spec's own sample-collection plan instead of relying on the dogfood retro. - Spec is now framed as "independent of slice exit"; entry timing is a separate decision once an accumulated sample meets H1. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../2026-04-25-due-date-extraction-design.md | 27 +++++++++---------- docs/superpowers/strategy/dogfood-strategy.md | 1 - 2 files changed, 13 insertions(+), 15 deletions(-) diff --git a/docs/superpowers/specs/2026-04-25-due-date-extraction-design.md b/docs/superpowers/specs/2026-04-25-due-date-extraction-design.md index a1f970c..6e9756f 100644 --- a/docs/superpowers/specs/2026-04-25-due-date-extraction-design.md +++ b/docs/superpowers/specs/2026-04-25-due-date-extraction-design.md @@ -2,11 +2,10 @@ **작성일:** 2026-04-25 (v0.1, stub) **저자:** 김태현 (dlsrks0734@gmail.com) -**상태:** ⚠️ Stub — 슬라이스 v0.4 dogfood 종료 후 정식 작성. 본 문서는 후속 spec 의 골격과 결정 대기 항목만 담는다. +**상태:** ⚠️ Stub — 슬라이스 v0.4 dogfood 중 발견된 피드백에서 출발. 본 문서는 후속 spec 의 골격과 결정 대기 항목만 담으며, 정식화 전에 §7 의 미정 항목들이 답해져야 한다. **선행 문서:** -- `docs/superpowers/specs/2026-04-24-inkling-vertical-slice-design.md` v0.4 (슬라이스 종료 후 본 spec 시작) +- `docs/superpowers/specs/2026-04-24-inkling-vertical-slice-design.md` v0.4 (슬라이스 본문) - `docs/superpowers/strategy/strategy.md` §2.2 (Clarify 단계의 의미 부여), §7-원칙4 (AI 확신도 낮게) -- `docs/superpowers/strategy/dogfood-strategy.md` (1주차 회고에서 due_date 필요성 검증 항목) --- @@ -20,11 +19,11 @@ | # | 가설 | 측정 | |---|------|------| -| H1 | 슬라이스 dogfood 노트 중 시간 표현 포함 비율이 ≥ 30% | 1주차 dogfood 로그 회고에서 본인 노트 분류 | +| H1 | 누적 캡처 노트 중 시간 표현 포함 비율이 ≥ 30% | 본 spec 자체 표본 — 누적 50건 노트의 본문을 정규식 + 본인 라벨링으로 분류 | | H2 | 규칙 기반 파서가 일상 한국어 시간 표현의 ≥ 80% 를 정확히 변환 | 골든 픽스처 50건 + 단위 테스트 | -| H3 | due_date 후보 수락률 ≥ 60% (제안 중 사용자가 그대로 수락한 비율) | post-launch 측정 | +| H3 | due_date 후보 수락률 ≥ 60% (제안 중 사용자가 그대로 수락한 비율) | 정식 출시 후 측정 | -H1 이 미달이면 본 spec 자체가 불필요 — dogfood 회고에서 먼저 H1 부터 판정한다. +H1 이 미달이면 본 spec 자체가 불필요 — 정식화 전 H1 표본 평가가 먼저다. --- @@ -117,11 +116,11 @@ ALTER TABLE notes ADD COLUMN due_date_edited_by_user INTEGER NOT NULL DEFAULT 0; --- -## 7. 결정 대기 항목 (dogfood 회고 후 결론) +## 7. 결정 대기 항목 (정식화 전 답할 질문) -본 spec 을 정식화하기 전 1주차 dogfood 로그에서 답해야 할 질문: +본 spec 을 정식화하기 전 답해야 할 항목 — 누적 캡처 표본·자체 사고 실험·라이브러리 비교 등으로 결론 도달: -1. **얼마나 자주 시간 표현이 들어가나?** (H1 검증) +1. **얼마나 자주 시간 표현이 들어가나?** (H1 검증, 표본 50건 분류) 2. **"오늘 PR 리뷰"** 같은 노트는 due 가 정말 오늘인가, 아니면 단순 맥락어인가? — false positive 비율 추정 3. **due_date 가 있는 노트를 다시 보고 싶은 트리거는 무엇인가?** (Inbox 자체 / 별도 뷰 / 알림) 4. **`📅` 라벨이 NoteCard 의 어느 슬롯에 붙어야 자연스러운가?** (제목 옆, 태그 옆, 별도 줄) @@ -144,11 +143,11 @@ ALTER TABLE notes ADD COLUMN due_date_edited_by_user INTEGER NOT NULL DEFAULT 0; ## 9. Slice 와의 관계 -본 spec 은 **슬라이스 v0.4 dogfood Pass 판정 후에만 시작.** 이유: +본 spec 은 **슬라이스 v0.4 와 독립**이다. 슬라이스 dogfood 중 발견된 피드백이 출처지만, 슬라이스 종료 조건에는 포함되지 않는다. - 슬라이스의 3 가설 (3초 마찰 / AI 품질 / 행동 루프) 중 어느 것도 due_date 없이 검증 가능 -- migration v2 + 컬럼 2개 + UI 슬롯 = 작지 않은 변화. 슬라이스 invariant 6 ("AI 재실행은 user-edited 필드 덮어쓰기 금지") 의 적용 표면을 확장하므로 dogfood 안정성 검증 후 진입이 안전 -- dogfood 1주차 회고에서 H1 (시간 표현 빈도 ≥ 30%) 이 미달이면 본 spec 자체가 폐기되고, 30% 이상이면 본 stub 을 v0.2 로 정식화 +- migration v2 + 컬럼 2개 + UI 슬롯 = 작지 않은 변화. 슬라이스 invariant 2 ("AI 재실행은 user-edited 필드 덮어쓰기 금지") 의 적용 표면을 확장하므로 슬라이스 안정성이 먼저 검증된 상태에서 진입하는 게 안전 +- 본 spec 의 정식화·실행 시점은 별개 결정 — 누적 표본으로 H1 충족이 확인되면 진입 --- @@ -178,12 +177,12 @@ ALTER TABLE notes ADD COLUMN due_date_edited_by_user INTEGER NOT NULL DEFAULT 0; "퇴근 전" → today (시각 단위는 본 spec 범위 밖이지만 fallback) ``` -각 케이스의 confidence 등급 + 사용자 가설 행동(수락 / 편집 / 무시)을 dogfood 회고에서 본인이 직접 라벨링한다. 이 라벨링이 H2 / H3 측정의 근거. +각 케이스의 confidence 등급 + 사용자 가설 행동(수락 / 편집 / 무시)을 본 spec 정식화 시 본인이 직접 라벨링한다. 이 라벨링이 H2 / H3 측정의 근거. --- ## 부록 B. 미정 정책 -- "오늘" 의 시간대 — 자정 기준인가, 24시간 후인가? (KST 자정으로 잠정 결정, dogfood 후 검증) +- "오늘" 의 시간대 — 자정 기준인가, 24시간 후인가? (KST 자정으로 잠정 결정, 정식화 시 검증) - 사용자 명시적 due_date 와 AI 추출 due_date 의 시각적 구분 (현재 안: AI 라벨 색조) - due_date 검색·필터 UI — 본 spec 범위 vs 별도 spec diff --git a/docs/superpowers/strategy/dogfood-strategy.md b/docs/superpowers/strategy/dogfood-strategy.md index c68c0b9..a3792da 100644 --- a/docs/superpowers/strategy/dogfood-strategy.md +++ b/docs/superpowers/strategy/dogfood-strategy.md @@ -96,7 +96,6 @@ dogfood 첫 날 시작 전, 환경을 한 번에 정렬한다. | 트리거 응답률 | 회의 후·퇴근 전 트리거에 실제로 캡처한 횟수 / 트리거 발생 횟수 | 본인 카운트 | | AI 수용률 | AI 생성 필드를 그대로 둔 노트 수 / 전체 캡처 수 | Inbox 의 "AI" 라벨 잔존율 | | `pending` 스택 | 24시간 이상 `pending` 상태로 남은 노트 수 | Inbox PendingBanner | -| 시간 표현 포함 노트 수 | `오늘`/`내일`/`N일 뒤`/`N월 N일` 등 시간 어휘가 들어간 노트 수 — due-date-extraction spec H1 (≥ 30%) 검증용 | 본인 라벨링 (로그 §6 자유 메모) | ### 3.2 주간 지표 (일요일 갱신)