# PM · Agent Agency — Desktop UX v008 Handoff — Superseded Draft

Status: **OWNER APPROVED**

This draft is superseded by the final Owner-approved Product/UX handoff.
Do not restart Target V2.
Preserve and rebase the existing Target v004 implementation candidate under the final handoff.

## Accepted-for-review Product/UX scope

Desktop Prototype v008 now represents both:
- CURRENT-state corrections derived from live UI/QA;
- FUTURE-state functions already accepted in Target v004.

Primary IA:
- Outside Project: Projects / Employee Library / New Project.
- Inside Project: Overview / Roadmap / Team.
- Task / Result / Owner Attention / Employee detail / execution planning / Discuss are contextual.

## Future-state functions implementation must preserve

1. Four independent execution facts:
   - PM recommendation;
   - Owner Task preference/override;
   - Mission request/selection;
   - Actual Run runtime/model/effort.

2. Automatic / Preferred / Exact semantics.
   - Preferred fallback only inside approved policy.
   - Exact forbids silent fallback.

3. Truthful runtime observations.
   - Available / Unavailable / Unknown / Stale.
   - Capacity separate from readiness.
   - Unsupported option visible with reason, never selectable as permission.

4. Fallback as normal supported state.
   - preserve requested preference;
   - preserve actual selected Run;
   - record human reason.

5. Mid-Mission switch.
   - same Task;
   - same Mission;
   - old Run historical;
   - successor Run new;
   - checkpoint / generation/fence in Advanced only.

6. Bootstrap.
   - Sources → Interview → Proposal → exact Owner approval → Provisioning → Project Control.
   - Proposal includes Team reuse/new, Roadmap, Drive plan, execution policy, PM recommendations, Owner overrides, runtime bindings, collaboration endpoints and real Owner actions.

7. Generic provisioning Owner UX.
   - Настраивается автоматически / Готово / Ожидается действие владельца / Заблокировано.
   - no Bridge/journal/workRoot/service internals in normal Owner UI.

8. Employee + Drive.
   - reusable global Employee;
   - membership / responsibility separate;
   - global Drive workspace separate from project-local workspace;
   - Drive draft ≠ Hub approved;
   - active Mission keeps pinned snapshot.

9. Discuss.
   - human collaboration endpoints;
   - destination before opening;
   - Copy context separate from Open;
   - chat does not mutate Hub state.

10. Grok.
   - optional admitted capability only;
   - unverified binding = unavailable/not configured, never fictitious green.

11. Owner Attention.
   - supports real execution decisions, including Exact unavailable.
   - capacity fluctuation alone is not a permanent alarm.

12. Trusted-device expectation.
   - PIN + OTP once on trusted device;
   - persistent normal session;
   - explicit Logout / revocation / security expiry.

## Work packages — Owner approval received

### WP0 — Data/truth reconciliation · P0
Fix current-stage/status truth, Team responsibility truth, version adoption truth, Result locator integrity.

### WP1 — Desktop Owner shell / Projects / Overview · P1
Rebase existing UI to human Project summary and NOW/NEXT/ATTENTION.

### WP2 — Meaningful Roadmap + Owner-first Task Inspector · P1
Include completed journey, current/next/future, compact execution chips, technical disclosure.

### WP3 — Results / Artifacts · P0/P1
Human actions, safe locators, unavailable states.

### WP4 — Team / Employee / Drive · P1
Responsibility, approved version, observed execution, global/project workspaces.

### WP5 — Employee Library + staffing · P1
Discovery aliases/taxonomy and Reuse/Create/Add flow.

### WP6 — Project Bootstrap + generic provisioning · P1
Implement existing v004 architecture contract; do not invent a new workflow engine.

### WP7 — Execution planning / fallback / runtime switch · P1
PM recommendation, Owner override, Mission resolution preview, availability/capacity/freshness, fallback and successor Run history.

### WP8 — Discuss / collaboration endpoints · P1
Human routing to external conversations, no Hub chat implementation.

### WP9 — Auth/trusted-device completion · P2
Keep current persistence; finish expiry/re-auth/logout UX and QA.

### WP10 — Independent QA · Gate
Re-run current live browser tests plus Target v004 future-state coverage.

## Preserve / rebase

Preserve:
- existing Target v004 schema/domain work;
- setup_operations and collaboration endpoint architecture;
- Employee workspaces;
- runtime provisioning work;
- Task execution preference persistence;
- Run provenance/switch contracts;
- trusted-session work;
- Project/Task/Mission/Run/Result canonical relationships.

Implementation must adapt/rebase existing work to the approved Product/UX specification.
It must not rebuild Agent Agency from zero.

## Dispatch rule

No implementation assignment until Human Owner explicitly approves/corrects Desktop Prototype v008.

STATUS: **WAITING OWNER PROTOTYPE APPROVAL**