Configuration on DevFlow

config.json

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

.planning/config.json is created by /devflow:new-project and edited by /devflow:settings. You can also edit it directly.

The shipped defaults

{
 "mode": "yolo",
 "depth": "standard",
 "job_checker_enabled": true,
 "workflow": {
 "research": true,
 "job_check": true,
 "verifier": true,
 "auto_advance": true,
 "verifier_checkpoints": false,
 "decision_queue": false
 },
 "planning": {
 "commit_docs": true,
 "search_gitignored": false
 },
 "parallelization": {
 "enabled": true,
 "job_level": true,
 "task_level": false,
 "skip_checkpoints": true,
 "max_concurrent_agents": 3,
 "min_jobs_for_parallel": 2
 },
 "gates": {
 "confirm_project": true,
 "confirm_objectives": true,
 "confirm_roadmap": true,
 "confirm_breakdown": true,
 "confirm_job": true,
 "execute_next_job": true,
 "issues_review": true,
 "confirm_transition": true,
 "editGate": "strict"
 },
 "safety": {
 "always_confirm_destructive": true,
 "always_confirm_external_services": true
 },
 "workstreams": {
 "worktree_prefix": "../{project}-ws-",
 "branch_prefix": "df/ws-",
 "merge_strategy": "squash"
 },
 "github": {
 "enabled": false,
 "repo": "",
 "milestone_prefix": "v",
 "labels": {
 "objective": "devflow:objective",
 "in_progress": "devflow:in-progress",
 "gaps": "devflow:gaps"
 }
 },
 "awareness": {
 "cache_ttl_minutes": 10,
 "peer_stale_days": 30,
 "branch_patterns": ["feature/*", "df/*", "fix/*", "proposal/*"],
 "org_project_id": "",
 "sibling_repos": [],
 "eden_libs_path": null
 },
 "daemon": {
 "notifications": false,
 "notify_on_start": true,
 "notify_on_complete": true,
 "auto_launch": false,
 "multi_project": false,
 "cross_shell": [],
 "status_line": false
 }
}

Top-level

Field	Values	Default	Meaning
`mode`	`interactive` / `yolo` / `autonomous`	`yolo`	How checkpoints behave — see below
`depth`	`quick` / `standard` / `comprehensive`	`standard`	Default planning depth when the intent model does not override it
`job_checker_enabled`	boolean	`true`	Whether plans are reviewed before execution

mode

The single most consequential setting.

Model profiles

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

Switching profile

/devflow:set-profile quality
/devflow:set-profile balanced
/devflow:set-profile budget

Or for one run only, without changing any files:

/devflow:build 4 --model budget

The assignment table

Generated from references/model-profiles.json:

Agent	Role	Quality	Balanced	Budget
`codebase-mapper`	Analyzes a codebase from a specific angle (stack, architecture, quality, or concerns) and writes structured findings.	sonnet	haiku	haiku
`debugger` effort xhigh	Investigates bugs using a structured scientific method with persistent session state across context resets.	opus	sonnet	sonnet
`executor` effort xhigh	Executes planned tasks with atomic git commits, handles deviations, and manages checkpoints during builds.	opus	sonnet	sonnet
`integration-checker`	Verifies that separately-built features connect properly and end-to-end user workflows actually work.	sonnet	sonnet	haiku
`job-checker`	Reviews execution plans before they run to verify they will actually achieve the objective goal.	sonnet	sonnet	haiku
`objective-researcher`	Researches how to implement an objective — discovers best practices, patterns, and pitfalls before planning begins.	opus	sonnet	haiku
`planner` effort xhigh	Creates detailed execution plans for objectives with task breakdown, dependency ordering, and built-in quality checks.	opus	opus	sonnet
`project-researcher`	Researches the domain ecosystem for a new project — stack options, architecture patterns, features, and common pitfalls.	opus	sonnet	haiku
`research-synthesizer`	Combines findings from multiple parallel research agents into a unified summary for roadmap creation.	sonnet	sonnet	haiku
`roadmapper` effort high	Creates project roadmaps by breaking requirements into ordered objectives with success criteria and dependency mapping.	opus	sonnet	sonnet
`security-auditor` effort xhigh	Scans codebase for security vulnerabilities in a specific domain: secrets, auth flows, or dependency risks.	opus	sonnet	sonnet
`ui-evaluator` effort high	Machine-judges the visual correctness of Flutter UI states by capturing each declared surface, scoring it through the offline visual-eval engine, and writing evidence the verifier consumes.	opus	sonnet	sonnet
`verifier`	Verifies that built code actually achieves the objective goal, not just that tasks were completed.	sonnet	sonnet	haiku

The assignment is not uniform, and that is the point. Under budget, planner still drops only to Sonnet while codebase-mapper drops to Haiku — a bad plan costs a whole build, a slightly worse codebase map costs a re-read.

Gates and enforcement

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

DevFlow has two kinds of gate and they are easy to confuse.

Confirmation gates are workflow pauses configured in config.json — points where DevFlow asks you before proceeding.

Enforcement gates are hooks that block tool calls outright. They are not configurable per-decision; they are on or off.

Confirmation gates

{
 "gates": {
 "confirm_project": true,
 "confirm_objectives": true,
 "confirm_roadmap": true,
 "confirm_breakdown": true,
 "confirm_job": true,
 "execute_next_job": true,
 "issues_review": true,
 "confirm_transition": true
 }
}

Gate	Fires when
`confirm_project`	after `PROJECT.md` is drafted
`confirm_objectives`	after objectives are proposed
`confirm_roadmap`	after the roadmap is assembled
`confirm_breakdown`	after an objective is broken into jobs
`confirm_job`	before each job executes
`execute_next_job`	between jobs
`issues_review`	when verification finds gaps
`confirm_transition`	at milestone transitions

Turn them off as you build trust on a project. confirm_roadmap is the one worth keeping longest — a wrong roadmap costs the most to discover late.

Environment variables

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

Escape hatches

Prefer one-off use over exporting. An exported escape hatch is a removed gate.

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

Variable	Effect
`DEVFLOW_ALLOW_RAW_COMMIT=1`	Allow raw `git commit`, bypassing `gate-commits`
`DEVFLOW_SKIP_EDIT_GATE=1`	Disable `gate-edits` entirely
`DEVFLOW_SKIP_CHANGELOG_GATE=1`	Allow `git tag -a` without a changelog entry
`DEVFLOW_SKIP_PROGRESS_GUARD=1`	Disable the repeated-call guard
`DEVFLOW_SKIP_INTERACTIVE_GATE=1`	Disable interactive-command interception

Session behaviour

Variable	Effect
`DEVFLOW_SKIP_CLASSIFY=1`	Skip session classification and the routing preamble
`DEVFLOW_SKIP_AWARENESS_POPULATE=1`	Skip the background awareness cache warm
`DEVFLOW_SKIP_ORG_CONTEXT=1`	Skip org-context injection at planning time
`DEVFLOW_SKIP_HANDOFF_INJECT=1`	Skip handoff result injection
`DEVFLOW_SKIP_HANDOFF_RESULTS=1`	Skip handoff result routing

Paths and overrides

Variable	Effect
`DEVFLOW_HOME`	Override the runtime mirror location (default `~/.claude/devflow`)
`DEVFLOW_AUDIT_LOG_PATH`	Where the Stop-hook audit log is written
`DEVFLOW_MODEL_PROFILE`	Force a model profile for the session
`DEVFLOW_OWNED`	Marks a path as DevFlow-managed

Handoff daemon

Variable	Effect
`DEVFLOW_HANDOFF_PID_FILE`	Override the daemon PID file location
`DEVFLOW_WATCH_ALLOW_FILE`	Path to a custom allowlist
`DEVFLOW_HANDOFF_RESULT_TTL_MS`	How long an unconsumed result stays valid

Deprecated

Variable	Status
`DEVFLOW_STRICT_EDITS=1`	No longer needed — strict is the default. Use `gates.editGate` to relax it.

Claude Code variables

Two are worth an explicit position, because tuning them looks helpful and is not.