script-kit-agent-workflow
Script Kit Agent Workflow
Mandatory workflow for all code changes. Do NOT ask users to test. Do NOT skip verification.
Quick-Start Checklist (Do First)
- Read CLAUDE.md before changing code
- Check
.hive/issues.jsonlfor tasks/context - TDD: write failing test → implement → refactor
- Update bead status when starting/completing work
- Include
correlation_idin all log entries/spans - UI changes: test via stdin JSON protocol (never CLI args)
- Before every commit:
cargo check && cargo clippy --all-targets -- -D warnings && cargo test
The Fix-Verify Loop
1. EXPLORE: Understand the problem
- Use Task tool with explore agent for codebase search
More from johnlindquist/script-kit-next
dev-loop
Run ./dev.sh in background, monitor logs, iterate on code changes until the expected behavior is observed. Use when making changes that need runtime verification — UI behavior, protocol handling, camera capture, keyboard events. Spawns cargo-watch, tails logs, checks for expected output.
1visual-test
Visual iteration workflow for Script Kit GPUI. Use when making UI changes that need visual verification — focus indicators, colors, layout, shadows, spacing. Covers the named-pipe test pattern, captureWindow screenshots, and the build-capture-verify loop.
1gpui-patterns
GPUI framework patterns for Script Kit. Use when writing UI code, handling keyboard events, managing state, or working with layouts. Covers layout chains, lists, themes, events, focus, and window management.
1testing-skill
A brief description of what this skill does
1script-kit-hive
Hive/beads task management for Script Kit agents. Use when working with the issue tracking system, managing beads, or coordinating agent work. Covers issue lifecycle, progress reporting, and file reservations.
1layout-inspector
Layout debugging for GPUI windows. Use when diagnosing layout bugs — missing elements, clipped content, flex sizing issues, overflow problems. Covers debug div probing, layout dump JSON protocol, computed bounds assertions, and the agentic fix-verify loop.
1