- Add harness/ directory to SF repo (specs/, evals/, graders/ with AGENTS.md) and seed harness/specs/bootstrap.md (agent-legibility verification) - Extend agentic-docs-scaffold.ts: new repos get harness/ + ADR-TEMPLATE.md and just adr / just spec / just harness-spec recipes via justfile - Sync SF_RUNTIME_PATTERNS (gitignore.ts canonical) → git-service.ts and worktree-manager.ts: add audit/, exec/, model-benchmarks/, reports/, notifications.jsonl, routing-history.json, self-feedback.jsonl, repo-meta.json, and milestone continue-marker patterns - Inject ARCHITECTURE.md into system prompt via loadArchitectureBlock() in system-context.ts (capped at 8 000 chars, after KNOWLEDGE block) - Write real ARCHITECTURE.md for this repo (system map, .sf/ layout, key flows) - Add ADR-TEMPLATE.md to docs/design-docs/ 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 |
|---|---|---|
| ADR-TEMPLATE.md | ADR Template | Reference |
| core-beliefs.md | Core Beliefs | Accepted |
| notification-event-model.md | Notification Event Model | Draft |