ProficientNowTechRFCs
RFC Standards/RFC Kinds/Specification/RFC RFCSTD 0003

2. Normative Requirements

RFC-RFCSTD-0003                                                   Section 2
Category: Standards Track                          Normative Requirements

2. Normative Requirements

← Scope | Index | Next →


2.1 Architecture Reference Requirement

Specification RFCs MUST reference their governing Architecture RFC.

RequirementFormat
Reference in metadataImplements: RFC-<ARCH-ID> v<VERSION>
Reference in introductionLink to Architecture RFC
Invariant complianceState which invariants this spec satisfies

2.2 Prerequisites Requirement

Specification RFCs MUST document prerequisites in tabular form:

ColumnRequirementDescription
PrerequisiteREQUIREDWhat is needed
TypeREQUIREDRequired or Optional
VersionREQUIREDMinimum version if applicable
VerificationREQUIREDHow to verify prerequisite is met

Prerequisites MUST be categorized:

CategoryExamples
InfrastructureKubernetes cluster, network access
AccessCredentials, permissions, certificates
KnowledgeDocumentation familiarity, training
ToolingCLI tools, IDE plugins

2.3 Phased Implementation Requirement

Specification RFCs MUST organize implementation into phases.

Each phase MUST follow the structure:

Phase N: <Phase Name>
├── Tasks (what to do)
├── Test (how to verify)
└── Iterate (what to check before proceeding)

Phase requirements:

RequirementDescription
SequentialPhases MUST be completed in order
CheckpointEach phase ends with verification
IsolationPhase failure does not corrupt previous phases
RollbackEach phase documents rollback procedure

2.4 Resource Definition Requirement

Specification RFCs MUST define resources in tabular form.

ColumnRequirementDescription
ResourceREQUIREDWhat to create
TypeREQUIREDResource type (ConfigMap, Secret, Service, etc.)
PurposeREQUIREDWhy this resource exists
DependenciesCONDITIONALWhat must exist first (if any)
ValidationREQUIREDHow to verify correct creation

Resource definitions MUST NOT contain:

ProhibitedPermitted Alternative
YAML/JSON contentTable describing structure
Actual valuesPlaceholder descriptions
Implementation codeConceptual descriptions

2.5 Validation Criteria Requirement

Specification RFCs MUST define deterministic validation criteria.

Each criterion MUST:

RequirementDescription
Be observableCan be verified by inspection or test
Be binaryEither passes or fails (no partial pass)
Be objectiveDifferent validators reach same conclusion
Include methodHow to perform the validation

2.6 Test Requirements Requirement

Specification RFCs MUST define test requirements.

ComponentRequirementDescription
Test CategoriesREQUIREDTypes of tests (unit, integration, e2e)
Acceptance CriteriaREQUIREDWhat defines passing
Test EnvironmentRECOMMENDEDWhere tests run
Test DataRECOMMENDEDWhat data is needed

2.7 Risk Documentation Requirement

Specification RFCs MUST document risks.

ComponentRequirementDescription
FeaturesREQUIREDWhat the implementation provides
CaveatsREQUIREDKnown limitations or constraints
LoopholesRECOMMENDEDEdge cases that may not be covered
RisksREQUIREDWhat can go wrong
MitigationsREQUIREDHow risks are addressed

2.8 Non-Code Requirement

Specification RFCs MUST NOT contain working code.

PermittedNot Permitted
Structural descriptionsYAML/JSON content
Table-based resource definitionsConfiguration files
Conceptual pseudocodeShell scripts
Mermaid diagramsAPI implementations

End of Section 2 — RFC-RFCSTD-0003