Platform Recognition Framework
A consistent structure for recognizing and documenting complex platforms.
The Platform Recognition Framework expresses recognized understanding according to the question each observation answers.
The First Principles of Recognition OS guide the framework.
Recognition precedes the framework. The framework gives coherent expression to what has already been recognized.
Recognition
Recognition begins with what is. Recognition reveals the natural structure of understanding as each observation finds its place according to the question it answers. The framework gives this understanding coherent, descriptive expression.
Purpose
The framework provides a common structure for:
- platform assessments
- technical investigations
- architecture documentation
- operational understanding
- engineering decisions
Its goal is to create documentation that reflects coherent understanding.
Recognition Process
Recognition consists of four activities:
- Observe
- Recognize
- Understand
- Recommend
Recognition includes:
- collecting evidence
- validating observations
- identifying unknowns
- distinguishing observations from interpretations
- organizing understanding
Recommendations emerge from recognition.
Fundamental Recognition Questions
What has been recognized naturally belongs to the question it answers.
| Question | Understanding |
|---|---|
| What exists? | Facts |
| How does it work? | Structure |
| What have we learned? | Experience |
| Why is it this way? | Decisions |
Facts
Facts describe observable characteristics of the platform.
Facts begin with what is present. Relevant absences emerge as facts when supported by evidence.
Examples include infrastructure, systems, ownership, integrations, versions, and dependencies.
Structure
Structure describes how the platform operates.
Examples include architecture, data flow, synchronization, runtime behavior, and service interactions.
Experience
Experience captures understanding gained through operating the platform.
Examples include investigations, incidents, operational practices, lessons learned, and recurring patterns.
Decisions
Decisions explain intentional choices.
Examples include architectural decisions, operational policies, accepted trade-offs, and documented rationale.
Relationships
The Fundamental Recognition Questions complement one another.
Facts describe what exists. Structure explains how it works. Experience captures what has been learned. Decisions explain why it is this way.
Together they express a coherent understanding of the recognized platform.
Recognition Artifacts
Recognition artifacts may include:
- platform documentation
- assessment reports
- investigation reports
- architecture documentation
- operational runbooks
- decision records
Each artifact remains faithful to recognized understanding while using the framework.
The Platform Recognition Framework provides a coherent structure for expressing recognized understanding. Implementation, documentation format, and engineering methodology evolve independently while remaining consistent with the First Principles.