Cookbook

vandoko.agency — Agency Site

Self-referential agency showcase that demonstrates the go-vandoko pipeline as a product

vandoko.agency — Agency Site

The agency site IS a demonstration of the go-vandoko pipeline. It showcases the pipeline as a product, displays portfolio and case studies from client work, and is itself audited by the QA pipeline it advertises. This self-referential loop is intentional — the site's QA score becomes a credibility signal.

Prerequisites: Same as vandoko.com — Parent Brand (vandoko brand tokens, vandoko-theme component) plus:

  • Portfolio data from completed client engagements — Recipe 1 (New Client — Full Pipeline) outputs serve as case studies
  • go-vandoko pipeline state files (vandoko-pipeline-state.json) from prior client runs, used for portfolio generation

Command

Terminal
/go-vandoko vandoko.agency --tier premium

Expected Flow

Stage 1 — Interview

Because this is a Vandoko property, answers are known constants:

  • URL: vandoko.agency
  • Tier: premium
  • Context: "Agency site showcasing the Vandoko creative pipeline. Must demonstrate the pipeline itself as a case study. Portfolio section features client work."
  • brand_maturity: established

Brand strategy carries forward from vandoko.com — Decision Point 1 is pre-approved.

Stage 2 — Self-Referential Pipeline

The site USES the go-vandoko pipeline to build a site that DESCRIBES the go-vandoko pipeline. Key sections to build:

SectionDescription
Hero"One command. Complete digital presence." — primary value proposition
Pipeline visualizationInteractive diagram of the 10-stage flow (INTAKE → DISCOVERY → STRATEGY → WEBSITE → QA → ...)
PortfolioCase studies generated from completed vandoko-pipeline-state.json files
ServicesStarter / Growth / Premium tier comparison table
ProcessHow the interview, concept gallery, and QA pipeline work — educational for prospects

The pipeline visualization must accurately reflect the real 10-stage flow from go-vandoko-orchestrator. It is not illustrative — it is documentation rendered as UI.

Stage 3 — Portfolio from Client Work

Prior client engagement artifacts feed the portfolio section automatically. From a completed Recipe 1 run (e.g., Meridian Robotics), the pipeline extracts:

  • Before/after screenshots from the e2e visual baseline captures
  • QA score improvements — delta between the client's original site score and the post-pipeline score
  • Concept gallery samples — selected frames from the 3 or 5 generated concepts
  • Decision point narrative — the strategic choices made at each of the 4 decision points, surfaced as case study copy

Each vandoko-pipeline-state.json from a prior engagement is a portfolio record. The more completed engagements exist, the richer the portfolio section.

Stage 4 — QA Auditing Its Own Site

The same qa-orchestrator that runs inside every client pipeline is used to audit vandoko.agency:

QA Flow
vandoko.agency → qa-orchestrator → 7 dimensions → QualityReport

The 7 dimensions (visual, SEO, accessibility, brand, conversion, content, production readiness) run against the deployed preview URL. The resulting score:

  • Must meet the premium threshold (>= 90) for launch clearance
  • Is displayed on the site itself as a credibility data point ("Our own site scores 94/100")
  • Is saved to {output_root}/qa/QualityReport.json for auditability

Decision Point: QA score display: The score shown publicly on vandoko.agency must match the actual overall_score in QualityReport.json. Do not round up or display a target score — display the real number. If the score is below 90, a mandatory polish pass runs before the score is published.

Stage 5 — Live Demo Route

The site includes a /demo route that shows a truncated pipeline walkthrough with a fictional client. This serves as an interactive product demo for prospects evaluating the service.

The demo uses concept gallery HTML from a real prior engagement (with client identity anonymized or replaced with the fictional client name) as an embedded example. The demo route:

  • Shows the interview Q1–Q5 flow as a step-by-step UI
  • Displays a simplified concept selection with 2–3 options
  • Renders a before/after QA score comparison
  • Links to the full portfolio for real engagement results

Verification Checklist

  • Site deploys at vandoko.agency domain (and future.now.agency alias if configured)
  • Portfolio section renders at least one case study with real pipeline data from a prior vandoko-pipeline-state.json
  • QA score displayed on the site matches the actual overall_score in QualityReport.json — not a target or rounded value
  • Pipeline visualization matches the real 10-stage flow from go-vandoko-orchestrator
  • vandoko-theme applied with same oklch tokens as vandoko.com (hue-285 surfaces, cyan primary, lime decorative only)
  • /demo route loads and completes the truncated pipeline walkthrough without errors
  • Services tier table shows accurate Starter / Growth / Premium feature differentiation

On this page