engineering-handbook

What problem does it solve?

This handbook solves the problem of engineers shipping code that is hard to maintain, unsafe under real-world failure modes, and inconsistent across teams by providing a shared approach to thinking, designing, coding, testing, and reviewing.

Core Features & Use Cases

• Mindset and problem framing: Turn unclear requests into maintainable solutions by aligning on “what done means” and anticipating production failure risks.
• Technical delivery workflow: Follow a repeatable sequence (understand → design → slice work → code → self-review → PR + handoff) to reduce rework.
• Production-grade engineering standards: Apply guardrails for error handling, external integrations, database operations, concurrency, validation, configuration/secrets, and idempotency.
• Team quality gates: Define expectations for unit testing, CI/CD checks, branch protection, and deployment pipelines.
• PR readiness discipline: Use a pre-PR checklist to catch correctness, safety, observability, and review-hygiene gaps early.
• Non-negotiables vs flexible zones: Codify what must never be compromised and where teams can choose pragmatically.

Quick Start

Tell an AI assistant: “Use the engineering-handbook skill to review my proposed change plan and PR checklist for correctness, testing coverage, and production safety.”