> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase19-session16-ergonomics-and-documentation/tasks.md).

# Task Checklist

**Session ID**: `phase19-session16-ergonomics-and-documentation` **Total Tasks**: 20 **Estimated Duration**: 3-4 hours **Created**: 2026-06-28

***

Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID.

***

## Progress Summary

| Metric              | Value     |
| ------------------- | --------- |
| Tasks Completed     | 20 / 20   |
| Estimated Remaining | 0 minutes |
| Blockers            | 0         |

***

## Setup (2 tasks)

* [x] T001 \[S1916] Verify Session 16 prerequisites, completed Phase 19 artifacts, shortcut/cross-link scope, current e2e configuration, and no-claim security boundaries (`.spec_system/PRD/phase_19/session_16_ergonomics_and_documentation.md`, `.spec_system/CONSIDERATIONS.md`, `.spec_system/SECURITY-COMPLIANCE.md`, `playwright.config.ts`)
* [x] T002 \[S1916] Inspect current shortcut, Orchestration shell, store selection, attention, campaign, queue, executor, handoff, terminal, docs, and e2e paths before changing ergonomics (`apps/web/src/lib/useKeyboardShortcuts.ts`, `apps/web/src/components/orchestration/OrchestrationShell.tsx`, `apps/web/src/store/useGameStore.ts`, `tests/e2e/app.e2e.ts`)

***

## Foundation (4 tasks)

* [x] T003 \[S1916] Create pure command-center shortcut helpers for detail open, Attention focus, selected pending decisions, blocked/failed queue cycling, filters, terminal entry, spawn entry, handoff entry, selected-target safety, and accessible labels with platform-appropriate accessibility labels, focus management, and input support (`apps/web/src/lib/commandCenterShortcuts.ts`)
* [x] T004 \[S1916] Create adjacent-surface link helpers for Mission Control, Plan Workpad, Permission Modal, Notice Board, Quest Board, War Room, Settings, Git/Codex, terminal, handoff, export, replay, achievements, mission history, channels, remote access, and usage availability without active hosted or remote claims (`apps/web/src/lib/commandCenterCrossLinks.ts`)
* [x] T005 \[S1916] \[P] Add shortcut helper tests for route resolution, typing-target suppression, browser chord suppression, selected/focused target safety, in-flight duplicate prevention, and label coverage (`apps/web/tests/commandCenterShortcuts.test.ts`, `apps/web/tests/keyboardShortcuts.test.ts`)
* [x] T006 \[S1916] \[P] Add cross-link helper tests for destination kinds, unavailable/no-claim rows, safe labels, and coverage of every historical adjacent surface (`apps/web/tests/commandCenterCrossLinks.test.ts`)

***

## Web Implementation (7 tasks)

* [x] T007 \[S1916] Extend the global keyboard shortcut listener and shortcut help data with command-center actions while preserving existing Quest Board, palette, replay, settings, typing-field, and browser-reserved guards (`apps/web/src/lib/useKeyboardShortcuts.ts`)
* [x] T008 \[S1916] Update the shortcut modal to group Orchestration shortcut rows with accessible labels, stable counts, responsive text fit, and product-facing copy only (`apps/web/src/components/KeyboardShortcutsModal.tsx`, `apps/web/tests/KeyboardShortcutsModal.test.tsx`)
* [x] T009 \[S1916] Wire command-center shortcut dispatch through existing Orchestration shell callbacks and store actions for details, tabs, attention decisions, queue cycling, filters, terminal drawer, spawn entry, and handoff entry with duplicate-trigger prevention while in-flight (`apps/web/src/components/orchestration/OrchestrationShell.tsx`, `apps/web/src/store/useGameStore.ts`)
* [x] T010 \[S1916] Add stable focus targets, selected-row state, and shortcut-safe approve/reject behavior to Attention with state reset or revalidation on re-entry (`apps/web/src/components/orchestration/AttentionWorkbench.tsx`)
* [x] T011 \[S1916] Add keyboard focus and selected-state support for campaign, queue, and executor workflows, including blocked/failed queue cycling and unavailable executor copy without hidden mutations (`apps/web/src/components/orchestration/CampaignWorkbench.tsx`, `apps/web/src/components/orchestration/QueueWorkbench.tsx`, `apps/web/src/components/orchestration/ExecutorFamiliesPanel.tsx`)
* [x] T012 \[S1916] Add handoff, terminal, header, and tab focus affordances so shortcut entry points open existing visible controls and keep modal/drawer Escape behavior intact (`apps/web/src/components/orchestration/CollaborationHandoffPanel.tsx`, `apps/web/src/components/orchestration/TerminalRuntimeDrawer.tsx`, `apps/web/src/components/orchestration/OrchestrationHeader.tsx`, `apps/web/src/components/orchestration/OrchestrationTabs.tsx`)
* [x] T013 \[S1916] Create and mount the adjacent-surface panel with product-facing cross-links or capability rows and explicit unavailable/no-claim copy for remote access and unsupported surfaces (`apps/web/src/components/orchestration/CommandCenterAdjacentSurfaces.tsx`, `apps/web/src/components/orchestration/CommandCenterPanes.tsx`)

***

## Testing (4 tasks)

* [x] T014 \[S1916] Extend Orchestration component coverage for shortcut dispatch wiring, detail modal open/close, selected attention decisions, queue cycling, campaign and executor focus paths, adjacent rows, loading, empty, error, and offline states (`apps/web/tests/OrchestrationPanel.test.tsx`, `apps/web/tests/AttentionWorkbench.test.tsx`, `apps/web/tests/CommandCenterPanes.test.tsx`)
* [x] T015 \[S1916] Add Playwright command-center coverage and wire the new e2e file into app desktop/mobile projects with privacy-safe visible text, no-overlap, and focused-flow assertions (`tests/e2e/orchestration-command-center.e2e.ts`, `playwright.config.ts`)
* [x] T016 \[S1916] Run focused web and app e2e tests for shortcut helpers, shortcut modal, Orchestration panel, Attention workbench, CommandCenterPanes, and command-center Playwright flows (`npm test -- commandCenterShortcuts commandCenterCrossLinks keyboardShortcuts KeyboardShortcutsModal OrchestrationPanel AttentionWorkbench CommandCenterPanes`, `npm run test:e2e -- --project=app-desktop --project=app-mobile orchestration-command-center.e2e.ts`)
* [x] T017 \[S1916] Run package/workspace validation and ASCII/LF checks before handoff (`npm --workspace apps/web run typecheck`, `npm run format:check`, `npm run lint`, `npm run typecheck --workspaces --if-present`, `npm test`, `find .spec_system/specs/phase19-session16-ergonomics-and-documentation -type f -print`)

***

## Documentation And Closeout (3 tasks)

* [x] T018 \[S1916] Update stable API and package docs for final command-center ergonomics, shortcut/cross-link behavior, Playwright evidence path, and unchanged local API/no-claim boundaries (`docs/api/README_api.md`, `apps/server/README_server.md`, `apps/web/README_web.md`, `packages/protocol/README_protocol.md`)
* [x] T019 \[S1916] Record implementation notes, command evidence, runtime verification, security posture, docs changes, no-claim states, and any bounded e2e blocker evidence for review and validation (`.spec_system/specs/phase19-session16-ergonomics-and-documentation/implementation-notes.md`, `.spec_system/specs/phase19-session16-ergonomics-and-documentation/security-compliance.md`)
* [x] T020 \[S1916] Verify all task states, docs links, shortcut labels, cross-link coverage, Playwright coverage, ASCII/LF requirements, and final handoff readiness for the implement -> creview -> validate sequence (`.spec_system/specs/phase19-session16-ergonomics-and-documentation/tasks.md`, `.spec_system/specs/phase19-session16-ergonomics-and-documentation/spec.md`)

***

## Completion Checklist

* [x] All tasks marked `[x]`
* [x] All tests and checks passing
* [x] All files ASCII-encoded with LF line endings
* [x] implementation-notes.md updated
* [x] Ready for `creview` to start the review -> validate sequence

***

## Next Steps

Run the `creview` workflow step.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase19-session16-ergonomics-and-documentation/tasks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.