singularity-forge/docs/design-docs/index.md
Mikael Hugo 6f877b61ab feat: harness scaffold, runtime pattern sync, and ARCHITECTURE injection
- 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>
2026-05-01 22:46:28 +02:00

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