govard.
Discuss a project
AI-first Web Generation

Website Engine

Awwwards-level HTML direction

Project Init sys_vars.json
Context
SYS>Website Engine shows how deterministic AI-first website generation becomes a working production system with clear responsibilities, constraints, and evidence.
Role
USR>AI Workflow Architect / Fullstack Engineer
Problem
ERR>The core problem is avoiding one-off AI output and keeping the workflow traceable, reviewable and production-oriented.

Constraints

  • ■ Route briefs, section packs, and compiled prompts must remain connected to the generated Astro/static page artifact.
  • ■ The pipeline needs browser review and scoring before a generated layout can be treated as production-ready.
  • ■ Every generated section has to keep its purpose, proof role, and acceptance criteria traceable.
  • ■ Regeneration must be possible without losing the original strategy, structure, or content contract.

Fragment Database

Variability Engine (XML Repository)

SYS_OK
niches/*.xml
34 Niches
>Defines brand archetype, tone of voice, audience structure, and business-specific trust triggers.
SYS_OK
styles/*.xml
12 Styles & DNA
>Defines the visual language: palettes, typography, border radius, spacing, and the resulting UI kit.
SYS_OK
presets/*.xml
8 Presets
>Controls interface density, animation style, and page weight for B2B or B2C scenarios.
SYS_OK
sections/*.xml
45 Sections
>Stores each block's atomic composition, interactivity requirements, and nesting rules.
SYS_OK
molecules/*.xml
120 Molecules
>Describes component states, properties, and behavior across different design systems.
SYS_OK
ux-psychology
15 UX Rules
>Captures cognitive patterns such as Hick's Law and the Von Restorff effect for emphasis and cognitive load.
Dynamic Injection
20+ Content Packs
niche_team, faq
PAYLOAD_DESC: JSON content arrays for FAQ, testimonials, and services that are injected at assembly time to produce unique SEO pages.
Prompt Assembler assemble_prompt.py

Deterministic Assembler

The Website Engine core. A Python script compiles the final prompt from dozens of XML fragments, resolves dependencies such as niche_name and injects content packs before the request is sent to the LLM.

1
PARSE
READING
📂 Parsing niche ✓
🎨 Parsing style ✓
🎨 Parsing preset ✓
🔤 Resolving fonts ✓
✨ Enrichments +CSS
🖱️ Micro-interactions +JS
🧠 UX rules ✓
🌙 Dark Mode ✓
🖼️ Assets library shuffled
Loaded: 14 modules
2
SELECT
MATCHING
34 × 12 × 8 = 3,264
unique combinations
Section matrix selection:
✅ hero: hero_3d_v2 s=92
✅ services: bento_grid s=87
✅ pricing: tier_cards ✓matrix
✅ testimonials: carousel_v3 ✓matrix
⏭️ blog: skipped
Selected: 12 sections of 45
3
COMPILE
BUILDING
Markdown prompt assembly:
01 Header + Prompt ID ✓
02 Niche identity block ✓
03 Visual DNA + colors ✓
04 Sections with HTML refs ✓
05 Molecules + enrichments ✓
06 Content pack injection merge
07 Traceability meta ✓
PROMPT COMPILED
14.2 KB • Markdown • Ready for LLM
$ python assemble_prompt.py dental corporate cream-gold --seed 42

Track 1: Single-Page

generate-v7.md

Step 0

Build Context

Loads ux-psychology-rules.xml (Gestalt, Hick's Law), marketing-widgets, Style DNA, and reference-implementations before generation.

Step 1

Create HTML Shell

Generates the base shell with 3-tier design tokens, Swiper initialization, and Lucide icons.

Step 2

Section Assembly

Builds UI sections iteratively, applies the Von Restorff effect, and validates FAQ, mobile menu, and lightbox logic.

Step 3

Quality Gates

Runs code_analyzer.py and auto_fix.py, then checks the output with score_bundle.py.

Step 4

Visual QA

Checks Responsive Grade B+ (≥75), Structural Score ≥70, and mapping from Style DNA.

Step 5 EXIT

Final Report

Summarizes applied UX rules, auto-fix results, final scoring, and writes the run into generation_log.md.

6 steps • ~45 sec

Track 2: Multi-Page

generate-multipage-v2.md

Step 0

Assemble Context

Runs assemble_multipage_prompt.py, prepares dynamic content packs, and builds _shared_context.md.

Step 1

Generate Landing

Renders index.html and extracts ,

Step 2

Inner Pages

Runs the --pages routing loop, injects content packs such as team and FAQ data, and generates unique SEO metadata.

Step 3

Bundle QA

Runs auto_fix.py in bundle mode, validates links with validate_bundle.py, and applies unified bundle scoring.

Step 4 EXIT

Final Report

Reports generated pages, content-pack integration status, and the final unified score.

5 steps • ~90 sec

Generation gallery

100+ premium landings
Beauty Salon
Editorial

Beauty Salon

style: editorial_magazine

Elegant Pass ≥ 88
Fitness Club
Cyber HUD

Fitness Club

style: cyber_hud

Neon Dark Pass ≥ 92
Handyman
Industrial

Handyman

style: industrial_tech

Bold Pass ≥ 90
Interior Design
Organic

Interior Design

style: organic_natural

Natural Pass ≥ 95
Law Firm
Luxury Dark

Law Firm

style: luxury_dark

Premium Pass ≥ 93
Medical Clinic
Glassmorphism

Medical Clinic

style: soft_glassmorphism

Mint Pass ≥ 89
Real Estate
Corporate

Real Estate

style: high_end_corporate

Monochrome Pass ≥ 94
Restaurant Cafe
Organic

Restaurant Cafe

style: organic_natural

Terracotta Pass ≥ 91
W3C Valid HTML5 Tailwind CSS v4 Lighthouse B+ (75+) Swiper & Lightbox Responsive Ready
Architectural approach

Synthesis of technology and meaning

Website Engine combines four key product dimensions, generating not just markup but a launch-ready commercial asset.

Tailwind v4 Base
Zero Runtime Errors
Code

Reliable foundation

Predictable HTML structure without AI drift. Clean responsive code and stable layout out of the box.

Design

Visual DNA

Deep rebuild of design tokens: accent colors, typography, and distinctive micro-interactions.

Content

Meaningful copy

No Lorem Ipsum. Smart copywriting and relevant imagery selected for the specific niche.

Marketing

Conversion

Audience analysis and positioning built in. A commercial asset, not just a website.

01
Foundation

Engine evolution through 7 iterations

From deep research of top design systems to autonomous pipelines for production-ready interface generation.

33 / 20
Niches & Styles
94.5
A-Grade Avg Score
7 Gates
Quality Assurance
Multi
Page Bundles
Envato Templates & Builders
Top #1 Top #2 Top #3
Analyzed
Container
Column
Element

Research and source analysis

Mapped the source brief, domain signals, design constraints, and route goals before any generation step.

Prompt contract assembly

Assembled XML fragments, page briefs, section rules, and proof requirements into a reusable generation prompt.

Initial HTML generation

Generated the first complete HTML artifact with explicit layout, copy, component boundaries, and route intent.

02
Architecture

Scaling and modularity

Moving to multi-page generation required a modular extension architecture.

Automatic expansion

Libraries expand automatically when new XML files are added to the corresponding folders. The engine picks up new niches, styles, and presets without changing assembler code.

📁 output/sites/my_bundle/site/
├─ 📄 index.html ✓ 42KB
├─ 📄 about.html ✓ 28KB
├─ 📄 services.html ✓ 35KB
└─ 📄 styles.css shared variables

Design and copy iteration

Separated visual polish, marketing copy, responsive fixes, and structural cleanup into deliberate review passes.

GEMINI 3.1 PRO KIMI 2.5
GLM 5
94.5 A Grade / Score

Quality scoring experiments

Validated output with scoring scripts, browser inspection, hierarchy checks, and acceptance thresholds.

# Claude Code Workspace
$ agent start --env opencode
> Initializing Antigravity core...
> Loaded 100KB design knowledge [OK]

Agent-ready route harness

Adapted the same route contract so future pages can be regenerated with context, gates, and artifact proof.

Reference Artifacts
docs/system-analysis-all-models html-gen-agents/workflows scripts/score_bundle.py
Project Conclusion

What this proves

The Truth

The case proves that AI-first delivery works when it is constrained by architecture, content models and verification gates.

Methodology

The method combines Astro-style static delivery discipline, route-level artifacts, browser review, and scoring gates instead of relying on a single generative prompt.

Use the same approach for production systems that need AI acceleration without losing control.

Need a website engine that turns briefs into controlled production pages?

I can help design a deterministic AI-first pipeline for landing pages, case pages, content systems, and QA gates without turning delivery into guesswork.