---
id: 07-editor-library-traces
epic: platform-retrofit
title: Library traces for @xyflow/react and zustand
type: technical-story
status: todo
feature: docs
depends-on: []
blocks: []
created: 2026-07-12T10:22:00Z
---

## Goal

`docs/library-decisions/` contains approved traces (via the `/evaluate-library` skill, ADR-022) for the feature-tier runtime deps the walking-skeleton PRD needs: `@xyflow/react` and `zustand` (v5). Traces only — the packages are not installed by this story.

## Why

Walking-skeleton tasks must not stall on the library-policy pre-commit hook (PRD user story 6). Pre-approving the traces decouples library evaluation from feature implementation.

## Done when

- `docs/library-decisions/` contains an approved trace for `@xyflow/react` and an approved trace for `zustand` (v5), each produced by the `/evaluate-library` protocol.
- The ADR-022 pre-commit hook passes on each commit.
- `pnpm typecheck && pnpm lint && pnpm test && pnpm conformance && pnpm fallow:audit && pnpm coverage:diff` pass.

## Out of scope

- Installing either package into any workspace package (the consuming feature installs them in the walking-skeleton PRD).
- Traces for runner-side deps (execa, vite, react-docgen-typescript) — app-tier `apps/runner` deps are exempt from ADR-022; traces for them are optional hardening, deferred.

## Tasks

- [ ] Run `/evaluate-library` for `@xyflow/react` and commit the approved trace to `docs/library-decisions/` — one commit, all gates pass.
- [ ] Run `/evaluate-library` for `zustand` (v5) and commit the approved trace to `docs/library-decisions/` — one commit, all gates pass.
