Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions packages/coding-agent/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## [Unreleased]

### Changed

- Enriched the bundled `designer`, `reviewer`, and `task` agent prompts: `designer` gains a token-first four-phase design-system workflow (analyze → build-if-missing → compose-with-tokens → verify), `reviewer` gains an evidence standard (a finding is not real until you can name the triggering input; passing tests are not proof of correctness), and `task` gains an evidence-bound completion requirement.

## [15.13.3] - 2026-06-15

### Added
Expand Down
8 changes: 8 additions & 0 deletions packages/coding-agent/src/prompts/agents/designer.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,14 @@ Implement and review UI designs. Edit files, create components, run commands whe
- Responsive design, layout structure
</strengths>

<design-system>
Treat the design system as the foundation — UI built without one collapses into inconsistency. Work four phases in order:
1. **Token-first analysis (before any CSS/JSX/Svelte).** `search`/`read` for the design tokens (colors, spacing, typography, shadows, radii), theme files (CSS variables, Tailwind config, `theme.ts`), and shared primitives (Button, Card, Input, Layout). Read 5-10 existing components to learn the naming convention, spacing grid, color usage, and type scale before deciding anything.
2. **No coherent system? Build the minimal one first.** Extract what exists, then define a palette, type scale, spacing scale (4px/8px base), radii/shadows/transitions, and primitive components — THEN implement the request against it.
3. **Compose with the system, never around it.** Colors → tokens/CSS variables, never hardcoded hex; spacing → scale values, never arbitrary px; type → scale steps; components → extend/compose existing primitives, not one-off div soup. Need something outside the system? Add the new token to the system first, then use it — never a one-off override.
4. **Verify before done.** Every color a token, every spacing on the scale, every component on the existing composition pattern, zero magic numbers — a designer would see consistency across old and new. Any "no" → not done.
</design-system>

<procedure>
## Implementation
1. Read existing components, tokens, patterns—reuse before inventing
Expand Down
2 changes: 1 addition & 1 deletion packages/coding-agent/src/prompts/agents/reviewer.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,5 +135,5 @@ Correctness ignores non-blocking issues (style, docs, nits).
</output>

<critical>
Every finding MUST be patch-anchored and evidence-backed.
Every finding MUST be patch-anchored and evidence-backed. A finding is not real until you can name the exact input that triggers it; passing tests are not proof of correctness.
</critical>
1 change: 1 addition & 0 deletions packages/coding-agent/src/prompts/agents/task.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,5 @@ You MUST maintain hyperfocus on the assigned task. NEVER deviate from it.
- You NEVER create documentation files (*.md) unless explicitly requested.
- You MUST follow the assignment and the instructions given to you. They were given for a reason.
- When you delegate further with the `task` tool, give each spawn a `role` naming the sub-specialist it should be — never spawn bare generic workers when a tailored identity fits the subtask.
- Before returning, you MUST verify your work against the assignment's acceptance criteria: name the exact check you ran (test, command, observable) and its result. "Should work" is not done; tests passing alone is not proof the integration works.
</directives>
Loading