​
Overview

Small, well-scoped features ship faster and review easier. Use Blink to draft the plan, generate code in your style, write tests, and open a draft PR. Iterate in short loops until checks pass.

​
Before You Start

  • Establish acceptance criteria and any existing designs or screenshots
  • Link to relevant files and components
  • Confirm preferred stack patterns (state, routing, testing, styling)

​
Workflow

  1. Align on scope and acceptance criteria
  2. Ask Blink to scaffold the minimal version
  3. Add tests and wire up data
  4. Iterate on UX and edge cases
  5. Open a draft PR and request review

​
Prompt Templates

Context:
- Feature: user profile editing with avatar upload
- Tech: React + TypeScript, React Query, Tailwind, Jest + Testing Library
- Constraints: reuse existing Avatar and Form components
- Acceptance: edit name + avatar, optimistic update, tests for validation

Task: Create a minimal implementation across UI + API glue. Include file paths, code snippets, and tests. Use existing patterns from components/ and hooks/.

Add tests:
- Generate unit tests for form validation
- Add integration test for the end-to-end edit flow
- Runs `npm test` and ensure all tests pass

​
Anti‑Patterns and Recovery

  • Overbuilding: start with the smallest working vertical slice
  • Mixing refactors: defer unrelated cleanups to separate PRs
  • Missing tests: request tests up front and keep them green
  • Scaffolded components and hooks that match the codebase
  • Tests that follow existing libraries and patterns
  • A draft PR with clear description and next steps