devmonks engineering handbook

How we engineer software at devmonks.

This handbook is engineering-focused. It's a living document — small today, evolving as we grow.

For company-wide policies (leave, benefits, hiring, general communication, day-to-day operations), see our Notion workspace.

What's in here

• Principles — our mantra and working principles, including AI usage rules
• Coding guidelines — how we actually write code
• Prompting AI tools — how to write clear, direct prompts
• Git conventions — commit format, branch naming, rules
• GitHub conventions — issues, PR workflow, README, open-source contributions
• Code review — review process and standards

Philosophy

• Start small. Add things only when they earn their place.
• Describe how we actually work, not how we aspire to work.
• Anyone can propose changes via pull request.
• If a doc isn't being read or referenced, it shouldn't exist.