16ff608d80
Gitignore (core change): - Remove stale blanket .sf/ entries from .gitignore (migrated to .git/info/exclude on 2026-04-29, never cleaned up) - gitignore.ts: split SF_RUNTIME_EXCLUSION_PATTERNS into two modes — SF_SYMLINK_EXCLUSION_PATTERNS (blanket .sf for symlink repos where git cannot traverse the symlink) and SF_RUNTIME_EXCLUSION_PATTERNS (granular runtime-only patterns for directory repos, enabling .sf/milestones/ and other durable planning artifacts to be tracked) - ensureGitInfoExclude() now detects symlink vs directory and writes the correct patterns, handling transitions between modes cleanly - ADR-001 status: Proposed → Accepted Docs: - Fill 11 placeholder scaffold docs with real SF-specific content: PLANS, DESIGN, PRODUCT_SENSE, QUALITY_SCORE, RELIABILITY, SECURITY, design-docs/index.md, exec-plans/active, exec-plans/completed, exec-plans/tech-debt-tracker, records/index - Add records note: docs/records/2026-05-01-repo-vcs-and-notifications.md - ADR-008 status: Accepted → Proposed (deferred — not applicable to current usage model where Claude Code assists externally, not as a Pi provider inside SF's dispatch loop) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
Design Docs
Durable design decisions live here. ADRs (Architecture Decision Records) are numbered sequentially
in docs/dev/. Lighter design docs (problem framing, event model decisions) live in this directory.
Architecture Decision Records (docs/dev/)
| ADR | Title | Status |
|---|---|---|
| ADR-001 | Branchless Worktree Architecture — .sf/milestones/ tracked, runtime gitignored |
Accepted |
| ADR-003 | Pipeline Simplification — research merged into planning | Accepted |
| ADR-004 | Capability-Aware Model Routing | Accepted |
| ADR-005 | Multi-Model Provider Tool Strategy | Accepted |
| ADR-007 | Model Catalog Split | Accepted |
| ADR-008 | SF Tools over MCP for Provider Parity | Proposed — deferred (usage model mismatch) |
| ADR-009 | Orchestration Kernel Refactor | Accepted |
| ADR-010 | Pi Clean Seam Architecture | Accepted |
| ADR-011 | Swarm Chat and Debate Mode | Proposed |
| ADR-012 | Multi-Instance Federation | Proposed |
| ADR-013 | Network and Remote Execution | Proposed |
| ADR-014 | Singularity Knowledge and Agent Platform | Proposed |
| ADR-015 | Flight Recorder | Proposed |
| ADR-016 | Charm AI Stack Adoption | Proposed |
| ADR-017 | Charm TUI Client | Proposed |
| ADR-018 | Repo-Native Harness Evolution | Proposed — staged impl |
Design Docs (this directory)
| Doc | Title | Status |
|---|---|---|
| core-beliefs.md | Core Beliefs | Accepted |
| notification-event-model.md | Notification Event Model | Draft |