# Feature Coverage Matrix

This matrix is the audit ledger for ZoneGaze Flow feature documentation. It maps each feature group to its owner docs, source-of-truth code, and current input/process/output/result media evidence.

Documentation structure follows the Diataxis split used by this repo: manual and how-to docs for users, feature docs for explanations, architecture/reference docs for implementation contracts, and platform docs for direct app launch paths. Architecture language is aligned with C4 and arc42, and decision history remains in ADRs.

## Audit Inputs

- Source truth: repository code, tests, platform packages, existing docs, and generated reference.
- External documentation models: [Diataxis](https://diataxis.fr/), [C4 model](https://c4model.com/), [arc42](https://arc42.org/overview), and [ADR guidance](https://adr.github.io/).
- Raw media run: `project-testing/project-test-zonegaze-flow-016`.
- Durable media: [screenshot assets](../assets/screenshots/README.md) and [video assets](../assets/videos/README.md).

## Coverage Summary

| Feature group | Owner docs | Source of truth | Evidence | Status |
| --- | --- | --- | --- | --- |
| Documentation map and manual | [Master](../MASTER.md), [software manual](../manual/software-manual.md) | [docs check](../../scripts/check-docs.mjs) | linked indexes | Covered |
| Class, function, API, and line-level source lookup | [Generated inventory](../reference/generated/inventory.md), [generated source reference](../reference/generated/source/README.md), [generated API reference](../reference/generated/api/README.md) | [documentation system](../developer/documentation-system.md), [inventory generator](../../scripts/generate-docs-inventory.mjs) | generated reference links | Covered |
| Project management | [core features](zonegaze-flow-core-features.md#project-management), [manual](../manual/software-manual.md#main-screens) | [project navigation panel](../../flow/web/src/components/project-navigation-panel.tsx) | [board input screenshot](../assets/screenshots/core-board-input.png) | Covered |
| Board lanes and archive views | [core features](zonegaze-flow-core-features.md#board-and-work-items), [feature catalog](feature-catalog.md#board-and-work-items) | [runtime columns](../../flow/contracts/src/api-contract.ts) | [archive result](../assets/screenshots/core-archive-result.png), [core video](../assets/videos/zonegaze-flow-core-working-demo.webm) | Covered |
| Task creation, prompts, images, base refs, plan mode, auto review | [core features](zonegaze-flow-core-features.md#task-inputs), [how-to](../user/how-to.md#start-a-task-in-plan-mode) | [task create dialog](../../flow/web/src/components/task-create-dialog.tsx), [task command](../../flow/runtime/src/commands/task.ts) | [create task process](../assets/screenshots/core-create-task-process.png) | Covered |
| Work types, hierarchy, coordinator validation | [core features](zonegaze-flow-core-features.md#work-types-and-hierarchy), [configuration](../reference/configuration.md#board-and-workflow-flags) | [work types contract](../../flow/contracts/src/work-types.ts), [work type settings](../../flow/web/src/components/work-type-settings-section.tsx) | [settings process](../assets/screenshots/core-settings-process.png) | Covered |
| Dependencies, linked tasks, blocked/ready state | [core features](zonegaze-flow-core-features.md#dependencies-and-chained-work), [how-to](../user/how-to.md#create-linked-tasks) | [dependency linking hook](../../flow/web/src/components/dependencies/use-dependency-linking.ts), [task command](../../flow/runtime/src/commands/task.ts) | board and task creation screenshots | Covered |
| Home agent and task planning | [core features](zonegaze-flow-core-features.md#home-agent-and-planning) | [home session](../../flow/runtime/src/core/home-agent-session.ts), [task command](../../flow/runtime/src/commands/task.ts) | [agent sidebar](../assets/screenshots/agent-sidebar.png) | Covered |
| Agents and native Cline/ZoneGaze Flow | [core features](zonegaze-flow-core-features.md#agents), [Cline integration](cline-integration.md) | [agent catalog](../../flow/runtime/src/core/agent-catalog.ts), [Cline SDK boundary](../../flow/runtime/src/cline-sdk) | [settings process](../assets/screenshots/core-settings-process.png), [core video](../assets/videos/zonegaze-flow-core-working-demo.webm) | Covered |
| Cline MCP, providers, OAuth, model/reasoning settings | [Cline integration](cline-integration.md), [configuration](../reference/configuration.md#cline-provider-settings) | [Cline setup section](../../flow/web/src/components/shared/cline-setup-section.tsx), [API contract](../../flow/contracts/src/api-contract.ts) | settings screenshot | Covered |
| Terminal, PTY sessions, shortcuts | [core features](zonegaze-flow-core-features.md#terminal-and-shortcuts), [how-to](../user/how-to.md#run-a-script-shortcut) | [persistent terminal manager](../../flow/web/src/terminal/persistent-terminal-manager.ts), [PTY agent ADR](../adr/0005-pty-backed-cli-agents.md) | [terminal panel](../assets/screenshots/terminal-panel.png) | Covered |
| Review, diffs, comments, commits, PR prompts | [core features](zonegaze-flow-core-features.md#review-and-shipping), [manual](../manual/software-manual.md#worktrees-and-review) | [card detail view](../../flow/web/src/components/card-detail-view.tsx), [runtime API](../reference/runtime-api.md) | [Git/review output](../assets/screenshots/core-git-output.png) | Covered |
| Git interface and worktrees | [core features](zonegaze-flow-core-features.md#git-and-worktrees), [how-to](../user/how-to.md#use-git-history) | [git history service](../../flow/runtime/src/workspace/git-history.ts), [git sync service](../../flow/runtime/src/workspace/git-sync.ts), [worktree manager](../../flow/runtime/src/workspace/task-worktree.ts) | [Git output](../assets/screenshots/core-git-output.png), [git history](../assets/screenshots/git-history.png) | Covered |
| Settings, context, hooks, access, updates, PWA, feedback | [core features](zonegaze-flow-core-features.md#settings-context-access-updates-and-pwa), [configuration](../reference/configuration.md) | [runtime settings dialog](../../flow/web/src/components/runtime-settings-dialog.tsx), [passcode manager](../../flow/runtime/src/security/passcode-manager.ts), [Featurebase button](../../flow/web/src/components/featurebase-feedback-button.tsx) | [settings process](../assets/screenshots/core-settings-process.png) | Covered |
| Fresh demo output/result | [core features](zonegaze-flow-core-features.md#workflow-evidence), [manual](../manual/software-manual.md#input-process-output-result-evidence) | `project-testing/project-test-zonegaze-flow-016`, previous website capture from `project-testing/project-test-zonegaze-flow-8` | [produced website result](../assets/screenshots/core-produced-website-result-page.png), [core video](../assets/videos/zonegaze-flow-core-working-demo.webm) | Covered |
| Direct Mac app | [Mac app](../platforms/direct-mac-application.md), [platforms](../platforms/README.md) | [desktop main](../../platforms/desktop/src/main.ts), [runtime orchestrator](../../platforms/desktop/src/runtime-orchestrator.ts), [tray controller](../../platforms/desktop/src/tray-controller.ts) | [Mac dashboard](../assets/screenshots/mac-desktop-dashboard.png), [Mac workflow video](../assets/videos/zonegaze-flow-mac-full-workflow.webm) | Covered |
| Direct Android app dashboard/setup | [Android app](../platforms/android-application.md), [platforms](../platforms/README.md) | [Android controller](../../platforms/android/app/src/main/java/com/zonegazeflow/app/ServerController.kt), [Android terminal backend](../../platforms/android/app/src/main/java/com/zonegazeflow/app/AndroidTerminalBackend.kt), [WebActivity](../../platforms/android/app/src/main/java/com/zonegazeflow/app/WebActivity.kt) | [Android emulator dashboard](../assets/screenshots/android-emulator-dashboard.png), [Android dashboard setup video](../assets/videos/zonegaze-flow-android-dashboard-setup.mp4) | Dashboard/setup covered |
| Direct Android full owned runtime, WebView, IDE working video | [Android app](../platforms/android-application.md#recording-status) | same Android source files as above | No full owned-runtime workflow video in this environment | Blocked by missing connected Android device/emulator runtime |

## Media Criteria

- Screenshots are app-only or emulator-only surfaces.
- Core and Mac videos are real interaction recordings.
- The Android dashboard recording is real but limited to the setup-blocked state; it is not used as proof of a full owned Android runtime workflow.
- Any future Android full workflow capture should be promoted only after it shows APK dashboard input, Zone Terminal setup/process, runtime output, board WebView result, and ZoneGaze Code result.
