sambitcreate · sambitcreate · Aug 9, 2026 · Jul 30, 2026 · Jul 30, 2026 · Jul 30, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -25,3 +25,7 @@ For complex workflows, record concise implementation friction in `.papercuts/tro
 ## Tests
 
 When adding a feature or changing behavior, layout, configuration, or contracts, always check whether existing tests need updating and add or extend tests when coverage is missing. Run the relevant suites before finishing (`npm run test`, or the narrower scripts in `package.json` when the change is scoped). If a new test file is added, register it in the appropriate `package.json` test script so CI picks it up.
+
+## Onboarding
+
+Aiden's onboarding flow is the first-run place to introduce setup-critical features. When adding a user-facing feature that changes first-run setup, provider/model configuration, profile data, permissions, privacy expectations, or core workspace capabilities, update the onboarding flow so new users learn or configure it at the right moment. Keep onboarding concise, use Aiden theme primitives, preserve macOS-style motion and focus behavior, and do not add network calls beyond the explicit provider/auth actions the user chooses.
diff --git a/docs/chatgpt-desktop-ui-inspiration.md b/docs/chatgpt-desktop-ui-inspiration.md
@@ -292,7 +292,7 @@ Aiden's shared dialogs currently animate from `scale(.8)` to `scale(1)` in `180m
 
 - Type: system sans, `14px` base, `12px` secondary, `18–20px` compact headings.
 - Toolbar: approximately `40–46px`, with icon buttons no larger than `32–36px` unless they are the primary action.
-- Conversation measure: keep the existing `max-w-3xl` family; wide code/diff content may escape into a review surface.
+- Conversation measure: keep the transcript, pending approval, and composer on the shared centered `52rem` chat-column contract; wide code/diff content may escape into a review surface.
 - Sidebar: preserve the current `220–340px` range and `300ms` width transition.
 - Composer: one continuous rounded surface; context strip attached, not a separate card.
 - Elevation: hairline or a compact shadow, not both at high intensity.

diff --git a/docs/plans/README.md b/docs/plans/README.md
@@ -4,26 +4,27 @@ This directory is the source of truth for Aiden's implementation plans. The engi
 
 ## Active and partial
 
-| Plan                                                                                        | Status      | Current state                                                                                                                                |
-| ------------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| [Aiden Assistant](aiden-assistant-plan.md)                                                  | Partial     | The in-window dock and its dedicated Settings section/global hotkey controls are implemented; settings tools and proactivity remain planned. |
-| [Compaction](compaction-plan.md)                                                            | Partial     | Core context transformation has landed; the broader design remains open.                                                                     |
-| [Designer Mode](designer-mode-plan.md)                                                      | Planned     | Phase 0 validation has not started in the runtime.                                                                                           |
-| [Dynamic Model Catalog](dynamic-model-catalog-plan.md)                                      | Partial     | Stored Pi catalogs, cache-only hydration, and explicit provider refresh ship; remote overlays for otherwise-static providers remain open.     |
-| [Generation Progress Notes](generation-progress-notes-plan.md)                              | Planned     | No implementation yet.                                                                                                                       |
-| [Performance, Stability, Battery, and Efficiency](performance-stability-efficiency-plan.md) | Planned     | Whole-app source audit is complete; implementation starts with instrumentation, durable state, and hard memory bounds.                       |
-| [Pi Provider Integration](pi-provider-integration-plan.md)                                  | Partial     | Pi built-ins, stores, auth, native routing, refresh, and voice credential lookup ship; custom composition, provenance, scalable UX, and rollout cleanup remain. |
-| [Slash Commands and Skill Invocation](slash-commands-and-skill-invocation-plan.md)          | Planned     | Pi command, Aiden architecture, and composer UI audits are complete; implementation has not started.                                         |
-| [Taracodlab Learnings](taracodlab-learnings-plan.md)                                        | Partial     | Phases A–B and D, plus core Phase E, are implemented; the remaining roadmap is open.                                                         |
+| Plan                                                                                        | Status  | Current state                                                                                                                                                                |
+| ------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Aiden Assistant](aiden-assistant-plan.md)                                                  | Partial | The dock, Markdown rendering, and confirmed provider-connection/model-pinned project-or-MCP automation creation/editing ship; settings tools and proactivity remain planned. |
+| [Compaction](compaction-plan.md)                                                            | Partial | Core context transformation has landed; the broader design remains open.                                                                                                     |
+| [Designer Mode](designer-mode-plan.md)                                                      | Planned | Phase 0 validation has not started in the runtime.                                                                                                                           |
+| [Dynamic Model Catalog](dynamic-model-catalog-plan.md)                                      | Partial | Stored Pi catalogs, cache-only hydration, and explicit provider refresh ship; remote overlays for otherwise-static providers remain open.                                    |
+| [Generation Progress Notes](generation-progress-notes-plan.md)                              | Planned | No implementation yet.                                                                                                                                                       |
+| [Performance, Stability, Battery, and Efficiency](performance-stability-efficiency-plan.md) | Planned | Whole-app source audit is complete; implementation starts with instrumentation, durable state, and hard memory bounds.                                                       |
+| [Pi Provider Integration](pi-provider-integration-plan.md)                                  | Partial | Pi built-ins, stores, auth, native routing, refresh, and voice credential lookup ship; custom composition, provenance, scalable UX, and rollout cleanup remain.              |
+| [Slash Commands and Skill Invocation](slash-commands-and-skill-invocation-plan.md)          | Planned | Pi command, Aiden architecture, and composer UI audits are complete; implementation has not started.                                                                         |
+| [Subagent Orchestration Expansion](subagent-orchestration-expansion-plan.md)                | Active  | Phases 0–6, Phase 7A durable lifecycle, and the canonical Phase 7B1 storage seam are complete; app-lifetime coordinator activation is next.                                |
+| [Taracodlab Learnings](taracodlab-learnings-plan.md)                                        | Partial | Phases A–B and D, plus core Phase E, are implemented; the remaining roadmap is open.                                                                                         |
 
 ## Completed
 
-| Plan                                                                 | Status   | Completion note                                                                                                                                   |
-| -------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [Keyboard Command System](completed/keyboard-command-system-plan.md) | Complete | One command catalog now powers transactional global hotkeys, scoped app shortcuts, native menus, canonical settings, and the `Command-K` palette. |
-| [Aiden-Native Subagents](completed/aiden-native-subagents-plan.md) | Complete | All five phases passed focused/package gates, two final fresh reviews, and the default 100-cycle packaged lifecycle soak. |
-| [Development and Production Coexistence](completed/development-production-coexistence-plan.md) | Complete | Development now has a visibly distinct app identity, isolated state roots, opt-in global shortcuts, and production-only updates. |
-| [Gemini Native Upgrade](completed/gemini-native-upgrade-plan.md)     | Complete | Its funded delivery phases shipped; deliberately deferred Gemini tracks remain future work.                                                       |
-| [Scheduled Tasks](completed/scheduled-tasks-plan.md)                 | Complete | Implemented through the plan's original Phase 4 scope.                                                                                            |
+| Plan                                                                                           | Status   | Completion note                                                                                                                                   |
+| ---------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Keyboard Command System](completed/keyboard-command-system-plan.md)                           | Complete | One command catalog now powers transactional global hotkeys, scoped app shortcuts, native menus, canonical settings, and the `Command-K` palette. |
+| [Aiden-Native Subagents](completed/aiden-native-subagents-plan.md)                             | Complete | All five phases passed focused/package gates, two final fresh reviews, and the default 100-cycle packaged lifecycle soak.                         |
+| [Development and Production Coexistence](completed/development-production-coexistence-plan.md) | Complete | Development now has a visibly distinct app identity, isolated state roots, opt-in global shortcuts, and production-only updates.                  |
+| [Gemini Native Upgrade](completed/gemini-native-upgrade-plan.md)                               | Complete | Its funded delivery phases shipped; deliberately deferred Gemini tracks remain future work.                                                       |
+| [Scheduled Tasks](completed/scheduled-tasks-plan.md)                                           | Complete | Implemented through the plan's original Phase 4 scope.                                                                                            |
 
 Move a plan to `completed/` only when its original delivery scope is complete. Keep the original plan as historical documentation; follow-on work belongs in a new active plan.