Epic: #651
리포트 항목: A4 후속 — docs/reports/2026-08-28-upstream-spec-drift-research.md (PR #650)
⚠️ 착수 금지. 이 이슈는 트래킹 전용이다. flat 키 제거 시점은 별도로 결정되며, 저장소 오너가 이 이슈에 "제거 진행" 사인을 남기기 전까지 구현 PR을 열지 않는다. Symphony 자동 디스패치 대상에서도 제외한다(Project Status를 Ready로 두지 말 것).
배경
#669에서 tracker.provider 객체를 도입하면서 기존 flat 키(tracker.api_key, project_slug, project_id, endpoint, state_field, priority, priority_field, pickup_labels, blocker_check_states, planning_states 등)는 deprecated alias로 유지된다(non-breaking, changeset:minor). 파서가 flat 키를 provider로 승격하고 doctor/workflow validate가 경고 + 변환된 provider 블록을 출력한다.
이 이슈는 그 alias를 다음 major에서 제거하는 작업을 추적한다.
제거 조건 (사인 전 확인)
제거 시 할 일
- 파서에서 flat 키 alias 경로 삭제, flat 키 발견 시 typed error(
workflow_deprecated_key)로 마이그레이션 안내
doctor의 변환 출력은 유지(오류 메시지에서 링크)
changeset:major, 마이그레이션 가이드, ADR(#669의 ADR에 "제거 완료" supersede 노트)
- E2E: flat 키 WORKFLOW.md가 명확한 오류로 실패하는 시나리오
완료 기준
- flat 키 WORKFLOW.md가 typed error로 거부되고,
provider 형식만 동작
- major 릴리스 병합
Blocked by: #669
Epic: #651
리포트 항목: A4 후속 —
docs/reports/2026-08-28-upstream-spec-drift-research.md(PR #650)배경
#669에서
tracker.provider객체를 도입하면서 기존 flat 키(tracker.api_key,project_slug,project_id,endpoint,state_field,priority,priority_field,pickup_labels,blocker_check_states,planning_states등)는 deprecated alias로 유지된다(non-breaking,changeset:minor). 파서가 flat 키를provider로 승격하고doctor/workflow validate가 경고 + 변환된provider블록을 출력한다.이 이슈는 그 alias를 다음 major에서 제거하는 작업을 추적한다.
제거 조건 (사인 전 확인)
docs/configuration.md마이그레이션 절과doctor자동 변환 출력이 릴리스 노트에 안내됨generate-reference-workflow.ts·docs/examples/*가 모두provider형식으로 갱신됨 (feat(core,trackers,cli): tracker.provider object with adapter-owned validation and state defaults; deprecate flat tracker keys via doctor diagnostics #669 범위)제거 시 할 일
workflow_deprecated_key)로 마이그레이션 안내doctor의 변환 출력은 유지(오류 메시지에서 링크)changeset:major, 마이그레이션 가이드, ADR(#669의 ADR에 "제거 완료" supersede 노트)완료 기준
provider형식만 동작Blocked by: #669