← All runbooks
impeccable / polish

impeccable/polish

Perform a meticulous final quality pass on a frontend interface to catch all the small details that separate good work from great work. The agent will discover the project's design system, assess the current state of the target, systematically polish it across all visual and inte

agent claude-codemodel claude-sonnet-4-6snapshot python312-uveval programmatic8 stepsv1.0.0

Deploy impeccable/polish to your jetty.io

One-click installs this runbook into a collection on your Jetty account. You can run it from the Spot dashboard, schedule it, or pipe inputs in via the API.

Deploy on jetty.io →View source
The shape of the run

8 steps · start to finish.

  1. 1
    Step 1

    Environment Setup

    ▶

    Verify all prerequisites and load project context before any design work.

    # Verify node is present
command -v node >/dev/null || { echo "ERROR: node not installed"; exit 1; }

# Create results directory
mkdir -p /app/results

# Verify target is specified
if [ -z "$TARGET" ]; then
  echo "ERROR: TARGET is not set. Set TARGET to the file, component, or route to polish."
  exit 1
fi

echo "Target: $TARGET"
echo "Quality bar: ${QUALITY_BAR:-flagship}"

    Pre-flight check (state before editing any files):

    IMPECCABLE_PREFLIGHT: context=? product=? command_reference=polish shape=not_required image_gate=not_required mutation=closed

    Do not open mutation=open until all gates pass.

  2. 2
    Step 2

    Design System Discovery

    ▶

    **Aligning to the design system is non-optional.** Polish without alignment is decoration on top of drift.

  3. 3
    Step 3

    Pre-Polish Assessment

    ▶

    Understand the current state before touching anything. Do **not** skip this step.

  4. 4
    Step 4

    Systematic Polish Pass

    ▶

    Work through each dimension methodically. Record every change in `/app/results/changes.md` with reasoning. Maintain consistent quality — never perfect one area while leaving others rough.

  5. 5
    Step 5

    Iterate on Issues (max 3 rounds)

    ▶

    After the first systematic pass, do a fresh-eyes review:

  6. 6
    Step 6

    Complete Polish Checklist

    ▶

    Write `/app/results/polish_checklist.md` with a status for each item:

  7. 7
    Step 7

    Final Verification

    ▶

    Before marking as done:

  8. 8
    Step 8

    Write Output Files

    ▶

    Write all required output files to `/app/results/`: