What is the primary benefit of using Smithers for AI coding?

Smithers provides a deterministic framework that forces AI agents through specific phases like research, testing, and review, preventing the quality degradation often seen in single-prompt long-context tasks.

Can I resume a workflow if it gets interrupted?

Yes, Smithers persists all state to a local SQLite database via Drizzle ORM, allowing you to stop and resume complex workflows without losing progress or re-running successful steps.

How does Smithers ensure agent outputs are accurate?

It uses Zod schema validation for every task output. If an agent provides a malformed response, the engine automatically triggers retries or falls back to alternative models until the schema is satisfied.

What tools are required to run the Smithers engine?

Smithers requires Bun >= 1.3 for the runtime and optionally Jujutsu (jj) if you want to use the Worktree primitive for isolated, idempotent branch management.

Smithers AI Workflow Engine

Name: Smithers AI Workflow Engine
Author: enitrat

byenitrat

•

생산성 및 워크플로

Orchestrates multi-phase AI development pipelines using a deterministic, resumable JSX-based framework for structured coding tasks.

Smithers is a TypeScript-based workflow engine designed to transform Claude and other AI agents into a structured development team. It uses JSX primitives to define complex, multi-step pipelines—incorporating research, implementation, testing, and automated review loops. By leveraging a resumable SQLite state and Zod schema validation, Smithers ensures that AI-driven code changes are deterministic and verifiable, making it an essential tool for large-scale refactors, feature porting, and maintaining high-quality code standards through 'atomic' development cycles.

주요 기능

01Isolated worktree management using Git and Jujutsu (jj) for safe, idempotent code iterations in separate environments.

02Deterministic JSX primitives for defining complex workflows like sequences, parallel tasks, and Ralph loops.

038 GitHub stars

04Multi-agent support for Claude, Gemini, Kimi, and Codex with configurable primary and fallback models.

05Resumable execution engine using SQLite and Drizzle ORM to maintain state across long-running AI tasks.

06Strict Zod schema validation for agent outputs to ensure structured data and enable automatic retries on failure.

사용 사례

01Executing complex code migrations that require sequential research, implementation, and multi-stage testing.

02Processing large batches of similar tasks (like porting test cases) through a standardized development pipeline.

03Automating multi-agent code review loops where one model implements and another verifies against a spec.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add enitrat/skill-issue smithers

For use in Claude.ai and ChatGPT

Download Skill