kandev/docs/plans/threads-layouts/task-05-document-presentation.md

id, title, status, wave, depends_on, plan, requirements, acceptance_criteria, system_design

id	title	status	wave	depends_on	plan	requirements	acceptance_criteria	system_design
05-document-presentation	Document Threads presentation	done	5	04-display-settings	plan.md	REQ-UI-THREADS-SAVED-VIEWS-005 REQ-UI-THREADS-DECK-004 REQ-UI-THREADS-DECK-005	AC-UI-THREADS-SAVED-VIEWS-005.4 AC-UI-THREADS-SAVED-VIEWS-005.5 AC-UI-THREADS-SAVED-VIEWS-005.6 AC-UI-THREADS-DECK-004.6 AC-UI-THREADS-DECK-004.7 AC-UI-THREADS-DECK-004.8 AC-UI-THREADS-DECK-005.1 AC-UI-THREADS-DECK-005.5 AC-UI-THREADS-DECK-005.7	../../specs/ui/system-design/threads-saved-views.md ../../specs/ui/system-design/threads-conversation-deck.md

Task 05: Document Threads presentation

Summary

Update the existing Threads user guide to explain choosing layouts and auto-hide, their saved-view behavior, and the phone interaction. Synchronize the scoped engineering notes with the implemented contracts.

In scope

• Update the Threads section of docs/public/sessions-and-review.md as a concise how-to: Display, Save/Discard, Grid, Maximum chats, auto-hide, required actions, visible touch composers, CI-only collapse, and the existing Open task.
• Check docs/public/tasks-and-workflows.md, root README, and screenshot catalog for directly contradicted Threads wording; edit only affected text.
• Update apps/web/components/threads/AGENTS.md with stable direct tiles, two-row/phone geometry, the saved preference owner, and composer ownership.
• Record final work-order results and promote the package status only after implementation matches the reviewed designs and required checks passed.

Out of scope

Publishing docs, a new docs page/navigation entry, production screenshots, runtime demos, code cleanup, and a generic QA/review task.

Acceptance

1. The existing guide explains the complete user flow and defaults, including five total chats, height/phone fallbacks, preserved drafts, and visible Stop or required actions.
2. Engineering notes name the actual implemented ownership and preserve viewport budgets and session submission behavior.
3. Documentation validators pass; each work order records its own actual commands/results without claiming unrun tests or prior-package counts.

Verification

Use /docs-maintainer. Run from the repository root.

node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
python3 scripts/lint-spec-files.test.py
python3 scripts/lint-spec-files.py --all
git diff --check -- docs/public docs/specs docs/plans/threads-layouts apps/web/components/threads/AGENTS.md README.md docs/screenshots.md
git status --short -- docs/plans/threads-layouts

This work order changes documents only. It does not rerun product suites without a new product change or unresolved concern. Final package results reference the Task 04 integration checks and each earlier work-order result.

Files likely touched

• docs/public/sessions-and-review.md
• docs/public/tasks-and-workflows.md, README.md, and docs/screenshots.md only if existing statements need correction.
• apps/web/components/threads/AGENTS.md
• The paired deck/saved-view requirement/design status and relevant details, plus this plan and completed work-order Results.

Dependencies

Task 04 and its successful integration checks. Document the final behavior.

Risks

Public copy must not imply auto-hide is enabled by default, that Grid doubles a saved chat limit, or that phones show multiple live conversations. Do not call future draft behavior shipped before the implementation is complete.

Parallelism

sequential

Inputs

• Complete package and previews
• Current public Threads section and scoped Threads engineering notes.
• Actual implementation/test results from Tasks 01-04.

Results

Done, 2026-09-11, after Task 04's successful integration checks.

Public docs updated: docs/public/sessions-and-review.md. The page remains a how-to guide. Its Threads section now has action-first Display/Save/Discard steps, unchanged defaults and total-chat limit, Grid/height/phone behavior, CI-only collapse, keyboard reveal, draft preservation, required actions, and visible touch composers. Existing Open task and task-action flows remain. The concise steps follow the requested i-have-adhd communication style.

Checked docs/public/tasks-and-workflows.md, root README, and screenshot catalog: no contradictory layout/composer wording required edits. No new page, navigation entry, published screenshot, or diagram is needed for this short settings flow.

Updated the scoped Threads engineering guide with actual preference, Display, disclosure, activity, native scroll, and viewport ownership. Synchronized the design with the implemented context reporting and immediate region hiding; there is no height/opacity animation. Promoted the owning requirements to active, system designs to current, and this package to implemented. Earlier packages and their historical verification counts remain unchanged.

All listed validation commands passed: public-doc validator test (one suite), 46 published pages, 36 specification-linter tests, complete specification lint, scoped diff/whitespace checks, and work-order status inventory. No product files changed in this work order; Task 04 records the final 23 desktop and 19 mobile browser tests, and Tasks 01-03 retain their own focused evidence. Physical-device keyboard testing was not available. Changes remain local and uncommitted; no push, publication, deployment, or additional session.