singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
singularity-forge/docs/design-docs/index.md
Mikael Hugo 0976bbbb83 docs: add ADR-019 workspace VM convergence architecture 
Captures the SF↔ACE incremental convergence strategy: workspace VMs
(Firecracker) as the unified execution isolation primitive, the three-layer
architecture (orchestration/knowledge/execution), the 6-phase convergence
path, and ADR-014 Phase 4 cancellation (persistent-agent runtime reassigned
to ACE). Cross-references the matching ACE document at
docs/architecture/sf-ace-convergence.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-01 23:21:23 +02:00

2.5 KiB
Raw Blame History

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
ADR-019 Workspace VM Convergence — SF↔ACE incremental convergence via microVM execution layer Proposed

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