Skip to main content
dev-workflows supports two output modes, configured during devw init or in .dwf/config.yml.

​
Copy Mode (default)

Writes compiled content directly into the target files. This is the simplest and recommended mode.

​
Link Mode

Writes compiled files to .dwf/.cache/ and creates symlinks from the expected output paths. Useful if you want a single source of truth without duplicating content. When using link mode, .dwf/.cache/ is automatically added to .gitignore.

​
Markers

When compiling to CLAUDE.md or GEMINI.md, the generated content is wrapped in markers:
If you have manual content outside the markers, it is preserved on recompile. This lets you keep hand-written rules alongside generated ones.

​
Which bridges use markers?

Not all bridges use BEGIN/END markers. It depends on whether the output file is shared with other content: Files without markers are completely overwritten on each compile. Do not add manual content to these files — it will be lost.