Overview
This architecture defines a Contract-Driven Frontend Production System that prioritizes system truth and auditability over development speed. By integrating executable Gherkin specifications with automated code generation and Robot Framework verification, it ensures that implementation strictly adheres to predefined intent.
Hypothesis
A contract-driven frontend production system can shift development from “optimistic coding” to automated enforcement by coupling executable specifications (Gherkin) with deterministic code generation (Plop/Yellicode) and automated verification (Robot Framework). The primary value is truth and auditability — ensuring behavior matches intent at every commit.
Approach
Operating Model: Rigorous causal chain — Behavior → Structure → Verification → Enforcement. Intent defined in Gherkin (plain text), implementation in Angular. This decoupling allows the framework to be theoretically replaceable without invalidating business logic.
Governance Layer: Code generation as constraint rather than productivity hack:
- Tactical Consistency (PlopJS): Micro-level boilerplate, file naming, directory structure — prevents copy-paste drift.
- Architectural Integrity (Yellicode): Macro-level generation from abstract models (.ymn files) — propagates large-scale decisions programmatically.
Verification Layer: Robot Framework as impartial auditor, parsing Gherkin steps and mapping them to Python-driven browser interactions. Produces detailed HTML audit logs. The glue code layer requires disciplined maintenance to prevent test brittleness.
Enforcement Mechanism: CI/CD pipeline as strict gatekeeper: Define (Gherkin) → Scaffold (Plop/Yellicode) → Verify (Robot Framework) → Deploy. Only pass/fail results trigger deployment — no manual QA gates.
Key Findings
- Framing as “Behavior-Locked Frontend Pipeline” or “Executable UX Contracts” communicates the value more effectively than listing tools.
- The governance layer makes the “right way” to build a component the only available way, drastically reducing technical debt.
- Missing link: mature iterations should include explicit state verification (API contract checks, DOM assertions) beyond interaction testing.
- This represents “Ops-Core thinking applied to frontend” — optimizing for system integrity over developer happiness.
Next Steps
- Add API contract checks and DOM assertions to the verification layer.
- Formalize the “Behavior-Locked” branding for internal and client communication.
- Document the Gherkin-to-Robot Framework step mapping conventions.
Related
- behavior-first-frontend — the companion document covering the production system architecture
- alp-automated-delivery — the ALP specification layer that feeds the behavior contracts
- ci-cd-patterns — broader CI/CD patterns that this pipeline implements