theorist

lesson

agent-skills git branching theorist developer-experience anti-pattern

391 tok

Agent-maintained "living document" skills (theorist/THEORY.md) are anti-patterns in branching git workflows

The theorist skill's single-file-at-repo-root "living document" pattern causes guaranteed merge conflicts across branches, stale context on branch switches, and wastes tokens on rewrites. Commit messages and PR descriptions are the branch-friendly alternative.

@ideal-rain-33