The Hardware Readiness Framework (HRF) defines what must be true before hardware decisions are made.
Most hardware failures are not execution errors. They are the downstream expression of upstream decisions that locked in unexamined assumptions about geometry, tolerance, environment, suppliers, and time.
HRF exists to make those decision points explicit, inspectable, and comparable before commitment.
This repository contains the authoritative source of the Hardware Readiness Framework.
It includes:
- the core concepts and language of HRF
- readiness models that describe where failure is injected
- a high-level failure taxonomy focused on decision origin
- diagnostic modules (e.g. OpenDFM) that probe specific readiness risks
- a static documentation site that renders the framework for public reference
The framework is documentation-first.
The content under content/ is the source of truth.
The site under site/ is a rendering of that content.
HRF is not:
- a manufacturing handbook
- a DFM checklist library
- a supplier directory
- a project management method
- a troubleshooting guide
HRF does not prescribe how to build hardware. It defines when it is unsafe to decide.
content/ index.md Framework definition scope.md Scope and non-scope language.md Shared terminology models/ readiness-model.md failure-taxonomy.md modules/ opendfm/ index.md failure-patterns/ nominal-geometry.md
site/ Static documentation renderer
.github/workflows/ GitHub Pages deployment
OpenDFM is a diagnostic module within HRF.
It exists to surface a specific class of readiness failure: the assumption that nominal design geometry is a sufficient proxy for physical and manufacturing reality.
OpenDFM is intentionally narrow. It is not a toolkit. It is a probe.
HRF is active and evolving, but intentionally constrained.
New concepts, models, or modules are added only when they:
- describe a repeatable upstream failure pattern
- operate at decision time (not execution time)
- can stand without prescribing solutions
HRF is maintained by Yana Sourcing.
The framework is public and referenceable. Commercial implementations and decision tools informed by HRF are developed separately.
For the public framework: → https://hrf.yanasourcing.com
For commercial inquiries: → https://yanasourcing.com