keyvaluesoftwaresystems frontend-tasks
Break the approved frontend scope into the smallest ordered set of verifiable tasks that implement the contract from the UI side. Small tasks keep the implement→verify→fix loop tight and every change reviewable. Read-only — produces a task list, not code.
Inputs
Your instructions name what to read — the cross-repo contract and the frontend LLD — and the artifact path to write. Standalone? read them and write to a path you choose (and tell the user where).
Steps
- Read the contract and the frontend LLD (the inputs your instructions point to); read the target app's structure read-only (routing, state management, component conventions, design system, API client).
- Slice vertically where possible — a thin end-to-end slice (types→API client→component →test) before breadth, so value is demonstrable early.
- Order by dependency — types/models → API client + data-fetching → state/store → presentational components → composite/container components → routing/page wiring → tests → i18n/accessibility polish.
- Make each task small — ~one commit, one testable behavior, exact files.
- Attach a test + standards + risk to every task (below).
- Write the task list artifact.
Each task must specify
id,title, and the exact files it touches.test— the check that proves it (the failing test to write first: component/unit or E2E).standards— which of {accessibility, i18n, validation, error-handling, performance, security (XSS/CSRF), state-management} this task must honor.needs_human_gate— true if it touches auth/session flows, payment UI, feature flags, or a dependency change.
Coverage — the plan as a whole must include tasks for
- Client-side validation (all fields, bounds, formats) and every error/empty/loading state.
- The negative/authz UI paths from the contract (401/403/4xx/5xx, offline), not just success.
- Optimistic updates + rollback where the LLD calls for them.
- Accessibility (WCAG AA) and i18n of all user-facing text.
- A feature-flag task if the HLD calls for gated rollout.
Edge cases to plan for explicitly
- Tasks touching shared/legacy components with no tests (add characterization tests first).
- Tasks that require a coordinated backend/contract change (flag the dependency).
- Concurrency of in-flight requests (stale response handling, debouncing).
- Timezone/locale-sensitive rendering.
External skill (provision — planner)
If the writing-plans skill (from the Superpowers pack) is installed, use it to produce
bite-sized, verifiable tasks — each task must still carry files + test + standards + risk as
above. If it is not installed, plan in-pack.
Output
Author it in one shot, then refine once — compose the whole tasks.json (manifest, all
tasks[], slices[]) in a single Write; do not stub-and-grow it with successive Edits.
Validate once; if it fails, make one corrective edit and re-validate (repeat only to fix
validation errors, never to build the file up incrementally).
Write the DAG to the tasks.json path your instructions specify (the orchestrator passes it;
run standalone? use a sensible path you choose) conforming to
engine/schemas/tasks.schema.json (the same shape the design step emits): context_manifest
(batched-read files), tasks[] (id, group_id, title, depends_on intra-group only,
reads, writes, test, standards, needs_human_gate), and slices[] (one per
independent group — two tasks share a group iff one depends on the other or they write a
common file). Validate with
python3 engine/validate_tasks.py <the tasks.json path> (must print OK).
Definition of done
Every task ≤ ~1 commit, has a test and standards, and is dependency-ordered; negative/empty/ loading states, accessibility and i18n are represented; risky tasks are flagged; tasks.json validates against the schema (no cross-group edges, disjoint writes across groups).
Output contract
Return tasks_path, task_count (integer), slice_count (integer), and risky
(true if any task needs a human gate) — all short scalars.