# REF-TASK-001 — Restore current-state and handover as concise continuation aids

**Status:** Implemented  
**Kind:** Documentation cleanup  
**Depends on:** None

## Problem and evidence

`docs/current-state.md` and `docs/ai-handover.md` state that they contain the current snapshot and
latest handoff, but each exceeds 2,200 lines and retains sequential records from many completed MVP
tasks. The same implementation and validation narratives are repeated between the two files and in
the immutable task records under `docs/specs/003-mvp/tasks/`. Important current facts—MVP-TASK-034's
external blocker, the latest verified checks, unverified hosted evidence, and the next action—are
buried among history already available in Git and specifications.

## Proposed change

- Replace `docs/current-state.md` with one current implementation snapshot: delivered capabilities,
  active/blocked work, latest validation checkpoint, known limitations, and next action.
- Replace `docs/ai-handover.md` with only the latest task context needed by the next agent: scope,
  working-tree state, changed files, decisions that must not be revisited casually, validation,
  remaining work, and next command/action.
- Link to MVP task implementation records and ADR 004 for history rather than copying them.
- Remove obsolete machine/load anecdotes and prior-agent narrative. Preserve any still-current
  blocker, security constraint, or unverified check in its canonical location.

## Constraints and sequence

First inventory every unique current fact in both files; classify it as current, canonical
elsewhere, historical, or obsolete. Move missing durable guidance to its existing canonical guide
only when necessary, then rewrite current state, then handover. Do not edit existing specifications
or ADRs and do not lose MVP-TASK-034's Demo/ECR prerequisites. This task changes no application
behavior.

## Validation

Review every retained claim against code, task status tables, and `git status`; run
`pnpm docs:links:check` (or the current link-check command) after the rewrite, then `pnpm quality`.
No application, database, or browser tests are required. Record a practical size/role check in the
handover without introducing a hard line-count rule.

## Guidance / ADR

Update `docs/development.md` only if its handover instructions still encourage duplication. No ADR.

## Implementation record

`docs/current-state.md` now contains a single present-tense implementation snapshot, active Epic 004
work, the still-blocked Surfboard integration and its exact ADR-owned prerequisites, the latest
local validation checkpoint, external evidence gaps, known limitations, and one next action.
`docs/ai-handover.md` now contains only this task's scope, changed files, decisions, validation, and
continuation. Historical narratives were removed rather than relocated because Git, Epic 003 task
records, and ADR 004 already own them. The development guide already described these roles
correctly, so it required no change.