implement · git:20261118.4ed259f · 2026-11-18 · sha256 c12265f55a2bde04
implement git:20261118.4ed259fA
Immutable. This exact content never changes and is served at /api/v1/blob/c12265f55a2bde04.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_l7ca44r34ezt2enz/c12265f55a2bde0497fa3de2e7d566ead3c284cd8b635f6d8ee0af1805d7c85b.json
Then /plugin install implement@markdownregistry-l7ca44r34ezt2enz in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: implement description: Audits any ticket or PRD for ambiguity, flips ticket status to in-progress in real time, designs modular/configurable/optimized solutions reusing shared UI and utilities, executes test-first production code, runs post-ticket independent review, immediately unblocks downstream tickets, and checkpoints per-ticket handover. Use when implementing any ticket, issue, or feature slice. --- # Implement (Real-Time Lifecycle → Ambiguity Audit → Design → TDD → Review → Unblock & Handover) Build **one ticket or vertical slice** to industrial production quality—never MVP stubs, hardcoded values, deferred status updates, or unreviewed diffs. ## Decision tree 1. **Does the ticket/PRD/request pass Phase 0 (Ambiguity & Feasibility Audit)?** - **No (unclear rules, UI states, auth/tenancy, config keys, API contracts, or repo conflicts)** → **STOP. Do NOT write code and do NOT invent defaults.** Call `ask_question` with exact gaps and `(Recommended)` options. - **Yes** → Proceed to step 2. 2. **Is the ticket blocked by an unfinished ticket (`Blocked by` in `docs/sprint/SPRINT.md`)?** - **Yes** → Stop and report the blocking ticket first. - **No** → If the active Wave has `>= 2` independent `ready` tickets with disjoint files, consider `/wave-execute` for parallel execution; otherwise proceed to step 3. 3. **Is `CONTEXT.md` populated for the target area of the codebase?** - **No** → Run `/index-project` (including `scan-repo.mjs`) first so you know exact dependencies, UI primitives, config/logging seams, and verification commands. - **Yes** → Immediately flip ticket status to `in-progress` and execute Phases 1–3 below. --- ## Phase 0: Mandatory Ticket / PRD Ambiguity Audit (Anti-Yes-Man Gate) Audit Jira/GitHub/Linear/chat/Sprint tickets against these 7 checks before designing or coding: 1. **Scope & Acceptance Criteria**: Is every expected behavior and exclusion testable? 2. **Actors & Auth**: Who can access/mutate this? What happens on `401`/`403`/`404` or cross-tenant access? 3. **Inputs & Edge Cases**: Required/optional fields, bounds, formats, empty/duplicate/idempotent cases? 4. **Data & API Contract**: Exact fields, status/error codes, schema migrations—and do referenced tables/endpoints exist? 5. **UI / UX States (if UI)**: Loading, empty, validation error, server/offline error, disabled/in-flight, responsive, disposal? 6. **Config, Logging & Failures**: Env/config keys, timeouts/retries, offline/partial failure behavior? 7. **Codebase Contradictions**: Does anything contradict `CONTEXT.md`, `docs/learnings/LESSONS.md`, or existing code? **Hard rule:** If any behavior-changing detail is missing or contradictory, stop, cite `ticket/PRD` vs `file:line`, and call `ask_question`. --- ## Phase 1: Pre-Code Design, Config/Logging & Reuse Plan (After `in-progress` Flip) Before editing any production or test file: 1. **Immediate Status Transition**: Update `**Status**: in-progress` in both `docs/sprint/tickets/<NN>-*.md` and `docs/sprint/SPRINT.md` so concurrent sessions or teammates know this ticket is actively owned. 2. **Reuse & Callers Search**: Search `components/`, `widgets/`, `ui/`, `shared/`, `lib/`, `utils/`, `hooks/`, `schemas/`, `api/`, read target primitives/helpers, and check all callers (`rg -n`) of any shared symbol you will modify. 3. **Engineering Design Check** (invoke `/codebase-design` if non-trivial): - Modularity & narrow DI seam at external I/O boundaries. - Performance optimization: zero N+1, optimal data structures, cursor pagination/`ListView.builder`, isolate/worker offload for heavy CPU, `dispose()`/`close()` plan. - Configurability: exact env, `--dart-define`, or typed config keys (zero hardcoded URLs, limits, or secrets). - Structured logging: events, `traceId`, and `<REDACTED>` secret/PII policy. --- ## Phase 2: TDD Execution & Optimization 1. Follow `/tdd`: write failing public-seam tests (happy path, `N-1`/`N`/`N+1`, invalid/empty, auth, idempotency, failure mode). 2. Implement complete production logic—zero stubs, mock stores, dummy data, hardcoded secrets/URLs, or stray `print`/`console.log`. 3. Run focused tests and static analyzer/typechecker (`dart analyze`, `tsc --noEmit`, etc.) after each step. --- ## Phase 3: Post-Ticket Re-Check, Independent Review & Handover Commit 1. **Ticket Re-Check**: Re-read the ticket/PRD line-by-line and confirm every acceptance criterion, touchpoint, UI state, config key, log event, and edge case is implemented. 2. **Black-Box Diff Audit & Full Verification**: ```bash node .agents/skills/implement/scripts/audit-diff.mjs --help node .agents/skills/implement/scripts/audit-diff.mjs ``` Then run the project's full test, static analysis, lint, and build commands via `run_command` and confirm exit code `0`. 3. **Mandatory Post-Ticket Review**: Flip ticket status to `in-review` and run `/code-review` (using read-only `adversarial-reviewer`, plus `security-auditor` / `architecture-planner` as needed) via `invoke_subagent`. 4. **Immediate Status Done, Downstream Unblock & Per-Ticket Handover**: - Flip the completed ticket to `done` in `docs/sprint/tickets/<NN>-*.md` and `docs/sprint/SPRINT.md` immediately upon review approval. - **Never delay unblocking**: immediately inspect every `blocked` ticket whose `Blocked by` list is now `100%` `done` and promote it to `ready` in both its ticket file and `SPRINT.md`. - Update `CONTEXT.md` if new seams/primitives/config vars were added, and run `/self-learn` if any new insight emerged. - **Mandatory Per-1-Ticket Handover**: Run `/handoff` immediately after finishing this ticket (`docs/sprint/HANDOFF.md` + `.scratch/handoff.md`), then create one atomic Conventional Commit (`feat(scope): ...`) if commits were authorized in this session (otherwise propose the exact commit command/message).