From 3a3554b58d07dcd76dc58705884ec04ffdde76ee Mon Sep 17 00:00:00 2001 From: aaron Date: Sun, 9 Aug 2026 14:22:50 -0400 Subject: [PATCH] =?UTF-8?q?retire=20Project=20as=20user-facing=20concept?= =?UTF-8?q?=20=E2=80=94=20align=20with=20Armonia=20vision?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Workspace is the single checkout (~/armonia), Problem is the pulse-design unit (data/problems/), Sessions are global and grouped by Problem. Project is now deprecated/internal (storage compatibility only) and no longer surfaced in the dashboard. Updates Armonia distinct-from line to Workspace. Fixes #319 --- CONTEXT.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/CONTEXT.md b/CONTEXT.md index 8ad2f03..cc95b72 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -28,22 +28,30 @@ _Avoid_: User, tenant, owner (interchangeably) ### Work organization -**Project**: -The unit of work organization — a directory registered with amicode where files, solves, and Sessions live. The dashboard's project surface owns switching between Projects and creating new ones. Every Session belongs to exactly one Project. -_Avoid_: Workspace, folder (as a concept name), repo +**Workspace**: +The single local checkout you open (e.g. `~/armonia`) — repos, mounted vaults, and the managed data dir (`~/.amico` → `~/armonia/data`). One per machine in normal use; the dashboard has no project switcher. The opencode engine still stores a worktree string per Session for compatibility, but it is not a user-facing switch. +_Avoid_: Project, folder (as a concept name) + +**Problem**: +The pulse-design unit — a named directory under `~/.amico/problems` (mirrored as `~/armonia/data/problems`) where the System, Formulation, `solve.jl`, and Runs live. Created and tracked via `amicode_problem` and the Amico interview, not via an engine picker. The Problems surface (not the engine's picker) is where you switch designs. +_Avoid_: Project, workspace, folder (as a concept name) **Session**: -One agent conversation, bound to exactly one Project at creation and never re-parented. Sessions are children of a Project — surfaced nested under their Project, never as a global flat list. +One agent conversation, bound to exactly one Workspace at creation and never re-parented. Sessions surface as a global, chronologically ordered list — optionally grouped by Problem — not nested under a selectable Project. _Avoid_: Chat (as a concept name), conversation **Bug session**: -A single-purpose Session spawned by the Report-a-Bug entry point. Bound to the active Project like any Session, but machine-managed: archived once its report is filed, deleted if abandoned before filing, and kept out of the Project's session history in every state. +A single-purpose Session spawned by the Report-a-Bug entry point. Bound to the active Workspace like any Session, but machine-managed: archived once its report is filed, deleted if abandoned before filing, and kept out of the Workspace's session history in every state. _Avoid_: chat, side chat, ticket +**Project** *(deprecated — internal only)*: +Legacy engine term for a registered worktree. Retained for storage compatibility (`Session.directory`, `LocalProject.worktree`) but not surfaced in product language. Use **Workspace** for the single checkout and **Problem** for the design unit. +_Avoid_: using "Project" for anything user-facing + ### Knowledge **Armonia**: -The knowledge system amicode reads for context — a precedence-ordered stack of mounted Vaults (personal → project → team). Surfaced as the "Armonia" sidebar panel; backed by ArmoniaService. Distinct from a Project: Armonia is shared knowledge that mounts in, a Project is the directory you work in. +The knowledge system amicode reads for context — a precedence-ordered stack of mounted Vaults (personal → project → team). Surfaced as the "Armonia" sidebar panel; backed by ArmoniaService. Distinct from a Workspace: Armonia is shared knowledge that mounts in, a Workspace is the directory you work in. Vault `project` scope is a *mount tier within Armonia*, not the deprecated engine Project. _Avoid_: Vault (as the system name), knowledge base **Vault**: