aiws-factory
v0.15.1
Published
AI Software Factory - deterministic orchestrator that turns a requirement into tested code through gated phases (Claude Code first).
Maintainers
Readme
aiws-factory
The aiws command: the orchestrator of AIWS — AI Software Factory: a requirement becomes tested code through gated phases (analysis → design + test specification → AI design review → human approval → implementation task by task with unit tests → review → human pull-request merge → knowledge update). A deterministic CLI owns the state; AI agents only work inside the write scope of the current phase. Runs on Claude Code; a Codex adapter can take the review. When a run stops at a gate, aiws gate (opened by aiws run in a terminal) lets you approve, reject or answer from a menu, and aiws stats shows where the tokens of each phase went.
npx aiws-factory init my-project # a new workspace with the reference kit (config, agents, skills, templates, docs)
npm install -g aiws-factory # puts the `aiws` command on your PATH
cd my-project && git init && git add -A && git commit -m "aiws workspace"
aiws detect --write # recognise the stack of each source-* folder
aiws sync claude # generate CLAUDE.md and .claude/
aiws sync opencode # or codex, antigravity: agents, skills and the guard for that tool
aiws discover # build aiws/knowledge/
aiws new REQ-001 && aiws run REQ-001 # requirements/REQ-001-*.md first, or: aiws new REQ-001 --from-issue 12Requirements: Node.js 22 or newer, Git, and Claude Code signed in. The package carries the kit it was released with; aiws init records that version in aiws/config/kit-version, and aiws run says so when the CLI and the kit of a workspace are not the same release. aiws upgrade then brings the kit to the CLI's: it replaces the files you left alone, keeps the ones you changed (with the kit's version beside them as *.aiws-new when both changed), and commits nothing.
Documentation, the handbook and the changelog live in the repository: https://github.com/vannt-dev/aiws-factory.
MIT © Van Nguyen
