Skip to main content

Prerequisites

  • Node.js >= 22

Install and Initialize

1

Initialize your project

npx dev-workflows init
This creates a .dwf/ directory with config.yml and empty rule files for each scope: architecture, conventions, security, testing, and workflow.The CLI detects existing AI tools in your project (CLAUDE.md, .cursor/, GEMINI.md) and pre-selects them.
2

Add a rule block (optional)

npx dev-workflows add typescript-strict
Installs prebuilt rules into your .dwf/rules/ files. Run devw add --list to see all available blocks.
3

Compile

npx dev-workflows compile
Generates editor-specific config files:
ToolOutput
Claude CodeCLAUDE.md
Cursor.cursor/rules/devworkflows.mdc
Gemini CLIGEMINI.md

What’s Next

  • Write your own rules in .dwf/rules/Rules format
  • Validate your setup → devw doctor
  • Browse all commands → Commands