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> |
||
|---|---|---|
| .. | ||
| building-coding-agents | ||
| context-and-hooks | ||
| drafts | ||
| extending-pi | ||
| pi-ui-tui | ||
| proposals | ||
| sf-runtime | ||
| what-is-pi | ||
| ADR-001-branchless-worktree-architecture.md | ||
| ADR-003-pipeline-simplification.md | ||
| ADR-004-capability-aware-model-routing.md | ||
| ADR-005-multi-model-provider-tool-strategy.md | ||
| ADR-007-model-catalog-split.md | ||
| ADR-008-IMPLEMENTATION-PLAN.md | ||
| ADR-008-sf-tools-over-mcp-for-provider-parity.md | ||
| ADR-009-IMPLEMENTATION-PLAN.md | ||
| ADR-009-orchestration-kernel-refactor.md | ||
| ADR-010-pi-clean-seam-architecture.md | ||
| ADR-011-swarm-chat-and-debate-mode.md | ||
| ADR-012-multi-instance-federation.md | ||
| ADR-013-network-and-remote-execution.md | ||
| ADR-014-singularity-knowledge-and-agent-platform.md | ||
| ADR-015-flight-recorder.md | ||
| ADR-016-charm-ai-stack-adoption.md | ||
| ADR-017-charm-tui-client.md | ||
| ADR-018-repo-native-harness-evolution.md | ||
| ADR-019-workspace-vm-convergence.md | ||
| ADR-020-internal-wire-architecture.md | ||
| ADR-021-versioned-documents-and-upgrade-path.md | ||
| ADR-022-scaffold-profiles.md | ||
| architecture.md | ||
| ci-cd-pipeline.md | ||
| FILE-SYSTEM-MAP.md | ||
| FRONTIER-TECHNIQUES.md | ||
| generated-artifact-policy.md | ||
| json-contracts.md | ||
| MEMORY-SYSTEM-ARCHITECTURE.md | ||
| MEMORY-SYSTEM-INTEGRATION-GUIDE.md | ||
| pi-context-optimization-opportunities.md | ||
| PRD-branchless-worktree-architecture.md | ||
| PRD-pi-clean-seam-refactor.md | ||
| repo-native-harness-architecture.md | ||
| repo-native-harness-template-kits.md | ||
| SETUP.md | ||
| SQLITE-MIGRATION.md | ||
| UOK-SELF-EVOLUTION.md | ||