dioptx/weft

README preview

# weft

**Deterministic workflow tracking for Claude Code — smart skills, template management, dashboard auto-refresh.**

![weft pitch — agentic chain of skills with bounded loops + guards](docs/demos/pitch.gif)

Weft turns ad-hoc agent sessions into auditable, event-sourced workflows. Define a template (plan → implement → verify, or an 11-step ticket-to-PR cycle), and weft enforces the order, blocks tools that violate the current step's guards, and refuses to let you `Stop` with steps still pending.

## Why this exists

Multi-step engineering work needs structure that survives compaction, retries, and the agent forgetting what step it's on. Weft solves three problems:

- **Skills fire reliably** — `/wf-start`, `/wf-step`, `/wf-status` read state from disk, not memory.
- **Templates apply consistently** — workflows live in JSON, version-controlled with your project.
- **Hooks enforce the contract** — `PreToolUse`, `PreCompact`, and `Stop` block out-of-order actions or premature exits.

State is an append-only event log under `.claude/weft/`, so every workflow is fully reconstructible.

### Why not just use TODOs or Claude's task list?

View full repository on GitHub →