handbook.md

title	Engineering Handbook
version	1

Chapter 1: Onboarding

• Create account
• Set up SSH
• Run first build

Chapter 2: Engineering Standards

• Use black/ruff (strict)
• 88-col limit
• Type hints enforced

Chapter 3: Branching Strategy

• main is protected
• feature branches from main
• rebase before merge

Chapter 4: Code Review

• 2 approvals
• Address comments
• CI green

Chapter 5: Release Process

• bump version (semver)
• tag release
• publish artifacts
• smoke test in staging

Chapter 6: Incident Response

• SEV1 page immediately
• Initial RCA within 24h
• Full postmortem within 72h

Chapter 7: Glossary

• CI: Continuous Integration
• CD: Continuous Delivery

Chapter 8: FAQ

• Q: Who owns releases? A: Dev Infra
• Q: What’s the SLA? A: 99.9%
• Q: Do we support LTS? A: 12 months