# ACF Fields Page Redesign

Audience: AI coding agents first.

## Outcome
Redesign international-press-zone ACF Fields page to closely match owner-supplied reference: dense two-pane field-group browser and field-management workspace, aligned with existing plugin design system and real functionality.

## Status
ACTIVE — implementation worker currently executing.

## Task IDs
- IPZ-ACF-UI-1: inspect current ACF page, data flow, reusable components, styles, tests.
- IPZ-ACF-UI-2: implement responsive accessible redesign.
- IPZ-ACF-UI-3: build, run deterministic tests, visually verify before/after through approved remote browser path.
- IPZ-ACF-UI-4: independent review, resolve findings, commit, land, and verify local installed plugin.

## Source Request
2026-08-12 owner request: “redesign the ACF page to look like this,” with reference image showing Translations > Fields: field-group list left; selected group header, controls, field table, nested repeater rows, status badges, pagination right.

## Acceptance Criteria
- ACF page reproduces reference layout hierarchy and density rather than merely changing colors.
- Left pane includes group count, search/filter controls, selectable group cards, field count/status/location, overflow action, pagination/footer.
- Right pane includes selected-group title/metadata/status, global default control, add-field action, search/type/sync filters, bulk actions, refresh, field table, nested children presentation, statuses/actions, pagination/footer.
- Existing supported ACF operations remain functional; do not invent fake controls or data.
- Responsive layout remains usable at narrower admin widths.
- Keyboard use, focus states, labels, and contrast meet accessibility requirements.
- No inline CSS. Use existing tokens/components where available.
- Before-state visual verification confirms current mismatch; after-state verification confirms target structure and computed styles.
- Admin production assets are rebuilt cleanly. Relevant automated tests pass without ignored warnings.
- Change is committed, landed by established project workflow, installed on local development WordPress, and verified through the real page.

## Preserved WIP / Ref / Path
- Source shared checkout has unrelated edits. NEVER modify or clean it.
- Fresh worktree: `/home/user/Projects/Press.zone/wordpress/wp-content/.worktrees/acf-page-redesign`
- Branch: `wt/acf-page-redesign`, based on fresh `origin/master` via project worktree helper.
- Reference image: `/home/user/.claude/image-cache/d48c7b7a-60b2-460d-92b1-7567807256fb/1.png`

## Constraints
- Follow plugin `.claude/agents/expert.md` and all mapped skills.
- Delegate implementation to project expert/domain agent; main thread coordinates.
- Read current implementation before claims or edits.
- Keep every changed line traceable to redesign request; preserve behavior.
- Use `e2e-remote` for browser plus dev-server verification. Local WordPress is only permitted target; never dev1/dev3.
- Address every warning and review finding before landing.

## Execution Steps
1. Inspect required specs, expert rules, current ACF page, API/data contracts, component/style patterns, tests, and launch path.
2. Capture current page via approved visual verification and record concrete mismatch.
3. Produce implementation blueprint mapping reference elements to supported features.
4. Implement JSX/JS and SCSS with accessibility and responsive behavior.
5. Add or update focused automated and visual checks.
6. Build production assets; run focused tests and remote browser verification.
7. Run independent code/UI review; fix verified findings and re-run gates.
8. Commit locally, land per repository rules, install/deploy to local WordPress, verify owner-visible page.

## Current Receipt
2026-08-12: request registered. Fresh isolated worktree created from origin/master. No product code changed yet. Reference image retained. Required expert inspection and delegated implementation are next.

## Next Executable Action
Load plugin expert task mapping and UI/verification skills, then delegate inspection plus implementation with exact reference and worktree paths.