A practical, vendor-neutral playbook for scaling, security, incident response, observability, and performance engineering in production systems.
The repository includes a minimum production evidence contract and a controlled reference service with correlation, metrics, traces, health, injected dependency latency, failure, and recovery tests. Measured workload exercises remain the next evidence gate.
- Scaling and capacity
- Security
- Incident management
- Observability
- Performance and the one-million-request exercise
- Evidence-gated roadmap
- Execution plan
- Production engineering diagrams
- Production evidence pack
- Production review template
Each guide separates goals, controls, measurements, and failure conditions. Recommendations must be adapted to the system's workload, risk, ownership model, and recovery objectives.
Requires the .NET 8 SDK.
dotnet run --project src/ReferenceServiceThe controlled critical path is GET /critical-flow?delayMs=10. Add
failure=error to inject a dependency failure. Validate the instrumentation and
recovery contract with:
dotnet test ProductionEngineering.slnThis service is an operational laboratory, not a production application or a performance claim.
Read CONTRIBUTING.md before proposing significant work. Report suspected vulnerabilities through SECURITY.md, not a public issue.
Licensed under the MIT License.