f3571475d5
Some checks are pending
CI / detect-changes (push) Waiting to run
CI / docs-check (push) Blocked by required conditions
CI / lint (push) Blocked by required conditions
CI / build (push) Blocked by required conditions
CI / integration-tests (push) Blocked by required conditions
CI / windows-portability (push) Blocked by required conditions
CI / rtk-portability (linux, blacksmith-4vcpu-ubuntu-2404) (push) Blocked by required conditions
CI / rtk-portability (macos, macos-15) (push) Blocked by required conditions
CI / rtk-portability (windows, blacksmith-4vcpu-windows-2025) (push) Blocked by required conditions
Design doc for moving SF's milestone planning state from markdown-as-source-of-truth to DB-as-source-of-truth, with markdown becoming a render target. 463 lines, ~4500 words. Includes: - Survey of all markdown artifacts under .sf/milestones/M*/ and who writes/reads each today (drift authoritative-ness is ambiguous in most cases) - MVP picks *-VALIDATION.md as first artifact to migrate — three read-site fixes, no schema change, the doctor's db_projection_validation_drift check retires immediately - Hybrid editing UX (option c): CONTEXT-DRAFT and in-progress PLAN stay LLM-writable markdown; tool-call-bounded artifacts (validate_milestone, complete_slice, etc.) become DB-first with generated <!-- generated --> headers - 5-phase rollout plan - Open question flagged: git atomicity for milestone-level syncMilestoneLevelFiles calls — needs explicit tracing before Phase 4/5 No source-code changes. Implementation comes later. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| workflows | ||
| 698-browser-tools-feature-additions.md | ||
| agent-runtime-unification.md | ||
| db-first-planning-state.md | ||
| rfc-gitops-branching-strategy.md | ||