We launched dif on Sep 5 and the most-asked question in the comments was some version of what does the agent part actually do? So here is a bit more context:
dif init writes a managed block into AGENTS.md, CLAUDE.md, and .cursorrules. The block tells the agent where flag files live, the frontmatter schema, the dif("flag-id") call at the render site, and to run dif validate before opening a PR. It also installs three Claude Code skills into .claude/skills/: one proposes the surfaces in your app, one drafts a flag or test, one concludes it and writes the learning back to the repo.
Every dif build refreshes dif/context.json, so the next session starts knowing what is live and what already got killed.
Pick what you want with --agents claude, --agents cursor, --agents general, or --agents none.
Congrats on the launch. The "flags reviewed in a PR" part is the real hook for me - most flag tools bolt on a dashboard that nobody checks, and this just stays in the same review flow. Curious about one thing though: if two agents are working in parallel branches and both touch the same markdown flag file, does dif help resolve that conflict at all or is it just a normal git merge conflict at that point?
@galdayan Right now it's just a normal git merge. That's a good idea to add though, we'll note it!