01 / The centre of the framework
Clarity beats ceremony
Software work breaks down when people lose the thread. The goal of OpalSpec is to keep intent, decisions, tradeoffs, and implementation context close enough that developers can act with confidence.
That does not require a heavy process. It requires the right amount of structure at the right time: enough to remove ambiguity, not so much that the process becomes the work.
02 / Flexible by design
The workflow should adapt to the work
Some changes deserve careful requirements before design begins. Some are better explored through questions. Some are small enough to move from design straight into implementation. OpalSpec treats those paths as normal.
The framework gives developers useful places to stop and think, but it does not pretend every project, team, or feature needs the same sequence every time.
03 / Focused, not lightweight for its own sake
Simple is a product decision
Simplicity in OpalSpec means fewer concepts to carry around while building. Requirements describe the feature. Design explains the approach. Tasks appear when sequencing matters. Documentation captures what future maintainers need.
The power comes from keeping those pieces connected. A spec is not a document collection; it is a practical context system for moving from idea to working software.
04 / Context is part of the product
Documentation should be human
A lot of project knowledge disappears after the code lands. The feature works, but the reasons behind it live in a chat thread, a memory, or nowhere at all.
OpalSpec encourages documentation that explains the useful parts plainly: what changed, why it exists, how it behaves, and what a future developer should know before extending it.
05 / Speed with direction
Momentum needs understanding
Shipping matters. But speed without shared understanding often creates rework: unclear scope, fragile decisions, and implementation details that surprise the next person who touches the system.
OpalSpec is designed to preserve momentum by making decisions visible earlier. The framework should help developers move faster because the path is clearer, not slower because there is more administration.