Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

A hook blocked my command

The model receives the denial reason and usually corrects itself. When you need to override deliberately:

DEVFLOW_ALLOW_RAW_COMMIT=1 git commit -m "..."

Every gate and its escape hatch is listed on gates and enforcement. Prefer a one-off prefix over an export — an exported escape hatch is a gate you removed.

If you are overriding the same gate repeatedly, log it so the friction is measurable rather than anecdotal:

Contributing

Mon, 01 Jan 0001 00:00:00 +0000

DevFlow is MIT licensed and developed in the open at AO-Cyber-Systems/devflow-claude.

Development install

git clone https://github.com/AO-Cyber-Systems/devflow-claude.git

/plugin marketplace add /absolute/path/to/devflow-claude
/plugin install devflow@aocyber

The plugin directory is the source of truth for distribution; there is no npm publish step.

Tests

npm test

Node’s native test runner against .test.cjs and .test.js files adjacent to their source. There is no lint command.

plugins/devflow/devflow/bin/df-tools.test.cjs
plugins/devflow/devflow/bin/lib/*.test.cjs
plugins/devflow/hooks/*.test.js

Hooks are tested like any other module — they are plain Node scripts reading JSON on stdin.

Documentation on DevFlow

Troubleshooting

A hook blocked my command

Contributing

Development install

Tests