create-saw-app
v0.1.3
Published
Saw — measure twice, cut once for AI-written code. Scaffolds a quality-gated AI development workflow: opencode harness (roles & gates) + Vibe Kanban board, preconfigured.
Maintainers
Readme
create-saw-app
Saw — measure twice, cut once for AI-written code.
Scaffold or retrofit a project with the Saw quality workflow for AI-assisted development: an opencode harness (roles, quality gates, evidence-based delivery) plus a preconfigured Vibe Kanban board. Nothing merges ("cuts") until it's been measured: spec verified, criteria proven, QA verdict passed.
Process design adapted from safe-agentic-workflow (© ByBren, LLC / J. Scott Graham, MIT + attribution).
New project
npx create-saw-app my-project
cd my-project
npm install
npm run board # kanban UI; or just: opencodeSaw is a workflow framework, not a stack: the first task (/spec) bootstraps
whatever stack you want (Next.js, FastAPI, a Rust CLI…). The scaffolder adds the
workflow, never boilerplate.
Existing project (any language)
cd your-project
npx create-saw-app initNon-destructive and idempotent:
.opencode/,.workflow/,docs/— copied, existing files never overwrittenAGENTS.md— created, or the SAW contract is appended below your existing rulesopencode.json— created, or missing top-level keys merged in (yours win)package.json—boardscript +vibe-kanbandevDependency added if absent (indentation preserved); non-Node projects: usenpx vibe-kanbaninstead- your
README.mdis never touched (quickstart lands indocs/SAW-QUICKSTART.md) - nothing is committed — review with
git diff
What you get
- 6 role agents with separated permissions: bsa, architect, implementer, qas, security, tech-writer
- 14 commands: step-by-step (
/spec→/start-work→/implement→/qa→/security-check→/pre-pr), autonomous pipelines (/run-task,/run-backlog), Vibe Kanban mode (/run-task-vk,/close-task), service (/check-workflow,/quick-fix,/retro) - Hard gates: no spec → no code; nobody approves their own work; evidence, not claims; humans merge
- Docs: getting started, core concepts, full command reference, model strategy,
Vibe Kanban guide, FAQ — in
docs/(English, with Russian versions indocs/ru/)
License
MIT. Workflow concept attribution: ByBren, LLC — Words To Film By™.
