Safety Case
Agent Prompt Snippet
Confirm the project includes a safety case with structured argumentation and supporting evidence that the system meets safety requirements.Purpose
A safety case provides structured argumentation that the system is acceptably safe for its intended use, supported by evidence from testing and analysis.
This is a Required document — every project of this type should have one. Without it, the team risks misalignment, rework, or undetected issues that compound over time.
What Makes It Good vs Bad
A strong version of this document:
- Defines clear roles, responsibilities, and decision-making authority
- Includes processes for exceptions and escalations
- Balances rigor with pragmatism — not so heavy it’s ignored
- Regularly reviewed and updated based on team retrospectives
- Connects governance policies to measurable outcomes
Warning signs of a weak version:
- So bureaucratic that teams route around the process entirely
- No enforcement mechanism — policies exist but aren’t followed
- Missing escalation paths for when standard processes don’t fit
- Written by one group without buy-in from the people who must follow it
- Never updated despite organizational or technical changes
Common Mistakes
- Creating processes so rigid that teams circumvent them entirely
- Not defining clear ownership for governance artifacts
- Applying the same governance overhead to projects of vastly different risk levels
- Writing policies without practical examples of how to follow them
How to Use This Document
Design governance processes to be proportional to risk. A weekend hackathon project needs different governance than a financial trading system. Define the minimum viable process that provides adequate oversight without crushing velocity. Make exceptions explicit — document when and how to deviate from standard processes.
For AI agents: Reference governance documents to understand approval workflows, coding standards, and change management requirements. Ensure proposed changes follow the documented process or explicitly note deviations.
Starter Template
SpecBase includes a ready-to-use template for this document: kb/templates/embedded/safety_case.md.tmpl. Use the SpecBase CLI or MCP integration to generate it pre-filled for your project.
# Generate stubs via CLI
specbase init <archetype> --features <features> --dir ./docs
Recommended Reading
- Team Topologies by Matthew Skelton & Manuel Pais — Framework for organizing teams around software architecture and flow of change.
- Accelerate: The Science of Lean Software and DevOps by Nicole Forsgren, Jez Humble & Gene Kim — Research-backed practices that drive software delivery performance.
- An Elegant Puzzle: Systems of Engineering Management by Will Larson — Practical approaches to engineering organization design, processes, and culture.