Skip to content

Development Design Changelog

2026-09-10 — Fresh-start baseline

  • Reframed repository as a learn-by-building project plus product source tree.
  • Simplified Task state to Backlog/Ready/Working/Needs You/Review/Done.
  • Moved planning/review/verification into independent lifecycles.
  • Added immutable Plan Revision model.
  • Kept Go core + Electron/React desktop split.
  • Added explicit Execution Environment boundary separate from Agent Adapter.
  • Added durable Operation coordinator for external side effects and recovery.
  • Added Agent Driver → Instance → Strategy → Capability model.
  • Added Agent Turn beneath Agent Run.
  • Kept raw-before-parse and raw logs outside SQLite.
  • Kept Fact/Claim distinction.
  • Made worktree paths stable-ID based and cleanup recoverability-based.
  • Added live-stream versus historical-state split and connection/sync health separation.
  • Changed documentation policy so canonical docs are updated when decisions change; archive is history only.

Forge is local-first. The docs are part of the product engineering system.