- Fixtures first. If the change touches parsing, write or extend a synthetic fixture before touching the parser (TDD).
- Small commits. One logical change per commit; describe why, not what.
- No live-database writes by default. Treat Devin's stores as read-only unless the feature explicitly mutates them behind a flag.
- Platform docs. Keep shared behavior in
README.md; keep Windows and Linux setup, paths, commands, and troubleshooting in their OS-specific guides.
pip install -e ".[dev]"
pytest- Tests pass on Windows and Linux (CI runs both).
- README sections Prior art and Limitations still accurate.
- CHANGELOG updated (semver).
- No secrets, tokens, or absolute user paths in code or docs.
New or changed functionality must include tests; PRs without coverage for new behavior are not merged.