# Permissions Browser CRUD Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Add a real browser CRUD scenario for the admin permissions page and keep the supported E2E gate green.

**Architecture:** Extend the existing Playwright CDP runner with one new scenario and only touch product code if the new scenario exposes a real defect. Keep assertions aligned with the page's current tree/list modal workflow and wait on real API responses for every mutation.

**Tech Stack:** Playwright CDP runner, React admin frontend, Go backend APIs, Vitest for regressions when product fixes are needed.

---

### Task 1: Add the red browser scenario

**Files:**
- Modify: `frontend/admin/scripts/run-playwright-cdp-e2e.mjs`

- [ ] Add a new scenario entry named `permissions-management-crud` to the supported scenario list.
- [ ] Implement the scenario with real page navigation and mutation-response waits for create, update, status toggle, and delete.
- [ ] Run `cd frontend/admin && $env:E2E_SCENARIOS='permissions-management-crud'; npm.cmd run e2e:full:win`.
- [ ] Confirm the first run fails for a real reason before changing product code.

### Task 2: Fix the exposed product issue if needed

**Files:**
- Modify only the minimal affected product files revealed by Task 1
- Test: affected frontend/backend regression tests only if product behavior changes

- [ ] Add the smallest failing regression test for the exposed product bug.
- [ ] Run that regression test and confirm it fails for the expected reason.
- [ ] Implement the minimal product fix.
- [ ] Re-run the regression test until it passes.

### Task 3: Verify the new scenario end to end

**Files:**
- Modify: `frontend/admin/scripts/run-playwright-cdp-e2e.mjs`
- Modify: docs only if the supported browser conclusion changes

- [ ] Re-run `cd frontend/admin && $env:E2E_SCENARIOS='permissions-management-crud'; npm.cmd run e2e:full:win`.
- [ ] Confirm the targeted scenario passes without weakening assertions.
- [ ] Run `cd frontend/admin && npm.cmd run e2e:full:win`.
- [ ] Confirm the full supported browser gate stays green with the new scenario included.

### Task 4: Re-run the full matrix and sync docs

**Files:**
- Modify: `docs/status/REAL_PROJECT_STATUS.md`
- Modify: `docs/team/PRODUCTION_CHECKLIST.md`
- Modify: `docs/team/TECHNICAL_GUIDE.md`
- Modify: `docs/team/PROJECT_EXPERIENCE_SUMMARY.md`
- Modify: `docs/team/QUALITY_STANDARD.md`

- [ ] Run `go test ./... -count=1`.
- [ ] Run `go vet ./...`.
- [ ] Run `go build ./cmd/server`.
- [ ] Run `cd frontend/admin && npm.cmd run test:run`.
- [ ] Run `cd frontend/admin && npm.cmd run lint`.
- [ ] Run `cd frontend/admin && npm.cmd run build`.
- [ ] Update docs only with the results actually observed on this branch state.