Cookbook

New Client — Full Pipeline

Complete go-vandoko cold start walkthrough with Meridian Robotics at growth tier

New Client — Full Pipeline

This recipe walks through a complete cold-start run of /go-vandoko with a fictional client: Meridian Robotics — a B2B industrial automation company, Series B, 50 employees, headquartered in Austin TX. We will select the growth tier and exercise every stage of the 10-stage pipeline, all 4 decision points, and validate every artifact along the way.


Prerequisites

Claude Code + vandoko-agency plugin

Claude Code installed with the vandoko-agency plugin active

OMC Harness

OMC harness running — verify with state_read('team:vandoko-agency:status')

Gemini CLI + Nanobanana

Gemini CLI installed with nanobanana extension: gemini --list-extensions | grep nanobanana

Exa MCP Server

Exa MCP server connected — check via mcps/catalog.md

Playwright

Playwright available: npx playwright --version

Output directory

Output directory writable: ./output/


Command

Terminal
/go-vandoko meridianrobotics.com

Or equivalently: type "go vandoko" or "start vandoko pipeline" and provide the URL when prompted.


Pipeline

Stage 0: Client Interview

The system presents 5 fast-path questions in sequence:

#QuestionYour Test Answer
Q1"What is the URL of the business?"meridianrobotics.com
Q2"Enter tier [starter / growth / premium] (default: growth):"growth
Q3"Anything else we should know?"Series B industrial automation company. 50 employees in Austin TX. We sell robotic welding cells and cobot integration services to mid-market manufacturers. Our main competitors are Universal Robots and FANUC.
Q4"Which deliverables do you need?"Select: brand_guidelines, website, email_templates, social_content, content_copy
Q5"What's your brand status?"refresh

After Q4, the tier auto-suggestion fires: website = true AND content_copy = true triggers a growth suggestion, which matches Q2 — no change prompt appears.

After Q5, the system asks: "Want to go deeper? A few more questions help us produce better results." For this test, answer y to exercise the extended path.

Extended questions (answer a subset):

#QuestionYour Test Answer
Q6Target launch dateJune 2026
Q7Hard deadline?no
Q8Budget rangemid
Q9Existing logo?yes
Q10Existing brand guidelines?no
Q14Inspiration URLsuniversalrobots.com, fanuc.com, veo.com
Q15Competitor URLsuniversalrobots.com, fanuc.com
Q16Color preferenceIndustrial blue and steel gray. Avoid bright colors.
Q17Brand moodprofessional
Q19Avoidplayful, cartoonish, stock photos of handshakes
Q20Target audienceVP Operations and Plant Managers at mid-market US manufacturers

The system shows a confirmation summary:

Output
──────────────────────────────────────────
  Vandoko Intake Summary
──────────────────────────────────────────
  URL:          meridianrobotics.com
  Tier:         growth
  Deliverables: Brand Guidelines, Website, Email Templates, Social Content, Content Copy
  Brand status: refresh
  Context:      Series B industrial automation company...
  Timeline:     standard (no hard deadline)
  Inspiration URLs: 3 provided
──────────────────────────────────────────
  [Enter] to confirm and begin pipeline
  Type 'restart' to re-enter answers

Press Enter to confirm.

Verification checklist:

  • InterviewResult JSON is assembled with all 7 categories populated
  • meta.question_count reflects the actual count of questions answered
  • interview_path is "extended"
  • deliverable_selections.website is true

Stage 1: INTAKE

The system scrapes meridianrobotics.com via Playwright (client-intake skill, researcher worker, haiku model):

  • Homepage, /about, /services — up to 4 pages
  • Extracts brand colors (primary, secondary from CSS custom properties)
  • Detects typography (heading + body font families)
  • Classifies industry using taxonomy: matches manufacturing or b2b-general
  • Detects tech stack from HTML markers (WordPress, Next.js, etc.)
  • Finds social links (LinkedIn, Twitter/X)
  • Computes site quality score (0–100)
  • Sets extraction confidence (e.g., 0.85 if Playwright succeeded on 3 pages)

Verification checklist:

  • vandoko-pipeline-state.json exists with currentStage: "INTAKE" then updated to "DISCOVERY"
  • history array has an entry: { stage: "INTAKE", status: "completed" }
  • ClientProfile artifact contains: brand.colors.primary (hex), brand.typography.headings, business.industry (canonical enum), business.tech_stack[], has_social.linkedin
  • extraction_confidence is >= 0.5
  • StageOutputEnvelope wraps the ClientProfile with stage: "INTAKE", status: "complete"

Stage 2: DISCOVERY

The system conducts research using Claude + Gemini + Exa (discovery-research skill, researcher worker, haiku model):

  1. Exa searches for 3–5 competitors (Universal Robots, FANUC will appear since we named them)
  2. Claude synthesizes market landscape: trends, opportunities, threats
  3. Gemini researches design trends for manufacturing/industrial websites
  4. Claude compares Meridian's current brand against competitors (brand gap analysis)
  5. Exa discovers 5–8 inspiration references (best manufacturing website designs)
  6. Gemini visually analyzes top 3–5 inspiration URLs (extracts color palettes, typography, layout patterns)
  7. Exa researches Meridian's brand perception (reviews, press mentions)
  8. Context7 looks up framework docs if tech stack was detected

Verification checklist:

  • DiscoveryReport artifact contains: competitors[] (3–5 entries), market_landscape.trends[] (3+ items), design_trends.industry_specific[] (3+ items), brand_gaps (positioning_gap, visual_gap, messaging_gap as non-null strings)
  • inspiration[] has 5–8 entries with relevance_score values
  • visual_references[] has entries with color_palette_extracted hex arrays
  • generated_by is "combined" (Claude + Gemini)
  • Pipeline state history shows DISCOVERY as completed

Stage 3: STRATEGY

Claude crafts a complete brand strategy (brand-strategy skill, strategist worker, opus model). No external tools — pure synthesis.

The system produces and presents a Strategy Summary Card:

Output
Brand Direction: Meridian Robotics

Positioning Statement
> For VP Operations and Plant Managers at mid-market manufacturers,
> Meridian Robotics is the automation partner that bridges the gap
> between complex robotic technology and practical factory-floor results.

Value Proposition
Precision automation that works on day one -- no PhD required.

Tagline Candidates
1. Precision at Work
2. Built for the Factory Floor
3. Automation, Simplified

Color Palette
- Primary: #1E3A5F — communicates industrial trust and engineering precision
- Secondary: #4A6FA5 — lighter steel blue for depth
- Accent: #FF6B35 — safety orange signals action and energy
- Neutrals: #0D1117 (background), #1A2332 (card), #E8ECF0 (text), #8B95A3 (muted)

Typography
- Display: Space Grotesk, 700 — geometric, technical, modern
- Body: Inter, 400 — clean readability

Template Recommendation
streamline — optimized for logistics and manufacturing verticals

Tone of Voice
professional-warm — short declarative sentences, technical but accessible

Decision Point 1: The system asks: "Approve this brand direction, or provide revision notes?"

For this test, answer: approve

Verification checklist:

  • BrandStrategy artifact has: positioning.statement (filled template), visual_direction.color_system (all hex, no oklch), visual_direction.template_recommendation (valid slug), tone_of_voice.em_dash_policy = "never"
  • voice_spectrum has 5 integer scores (1–5 each)
  • decisions[] in pipeline state has: { stage: "STRATEGY", selected: "approve" }
  • Lineage entry recorded with creative_selections[]

Stage 4: CONCEPT

Gemini/Nanobanana generates 3 visual concepts (growth tier) via the concept-gallery skill, concept-maker worker, sonnet model:

  1. Meridian — Clean (template: streamline) — Hero, cards, buttons images
  2. Meridian — Bold (template: plasma) — Hero, cards, buttons images
  3. Meridian — Authentic (template: relative) — Hero, cards, buttons images

Plus shared assets: background pattern + icon set (2 more Nanobanana calls). Plus per-concept: typography specimen, gradient options, icon grid. Plus voice signal extraction (text-based radar).

Total Nanobanana calls: ~15–20.

The system builds {output_root}/concepts/gallery.html — a single self-contained HTML file with inline CSS showing all concepts side-by-side. Concept enhancement runs: mood boards, palette visualizations, inspiration lineage added to each concept.

Decision Point 2: The system presents a numbered list and says: "Which concept speaks to your brand? Select [1-3] or describe what you'd like to change."

For this test, answer: 2 (select Bold concept)

Verification checklist:

  • {output_root}/concepts/ directory contains: concept-clean/, concept-bold/, concept-authentic/, shared/
  • Each concept directory has: hero.png, cards.png, buttons.png
  • gallery.html opens in a browser and shows 3 cards with images, color swatches, and template badges
  • ConceptSelection artifact: selected: "concept-bold", selectedAt is ISO-8601
  • BrandReference assembled at {output_root}/brand-reference.json

Stages 5–8: Parallel Execution

After concept selection, the pipeline fans out across BRAND, SOCIAL, WEBSITE, and CONTENT simultaneously:

Pipeline Fan-Out
CONCEPT (approved) ──┬── BRAND ──── EMAIL ──┐
                     ├── SOCIAL             ├── LAUNCH
                     ├── WEBSITE ── QA ─────┤
                     └── CONTENT ───────────┘

BRAND (brand-guidelines skill, brand-builder worker, haiku): Generates brand guidelines PPTX (10+ slides via PptxGenJS), design tokens directory.

SOCIAL (social-pack skill, content-creator worker, sonnet): Produces platform banners for LinkedIn, Facebook, Instagram, Twitter (growth tier). Post templates PPTX, content calendar markdown.

WEBSITE (website-build skill, site-builder worker, sonnet): Translates BrandStrategy + ConceptSelection into ClientBrief format, delegates to website-autopilot. Installs vandoko-theme if vandoko-branded. Resolves component registry. Generates design token CSS. Captures e2e baseline screenshots. Scaffolds deliverables portal.

CONTENT (content stage, via ben-hamine/copywriter): SEO pages, GEO content, blog posts, articles, whitepapers, lead magnets.

When BRAND completes: EMAIL (email-pack skill, content-creator worker, sonnet) launches. Produces welcome + follow-up sequences (2 sequences, 2 personas for growth tier) in Zoho + HubSpot ESP formats.

Decision Point 3: When WEBSITE completes, the system asks: "Preview the website build. Approve for QA or request changes?"

For this test, answer: approve

Then QA runs.

Verification checklist:

  • Pipeline state history shows BRAND, SOCIAL, WEBSITE, CONTENT all started before any completed
  • Each parallel stage has its own history entry with timestamps
  • BRAND: {output_root}/brand/ contains PPTX file + tokens directory
  • SOCIAL: {output_root}/social/ contains banner images + templates
  • WEBSITE: {output_root}/website/ contains built site, deployUrl in artifacts
  • EMAIL: {output_root}/email/ contains HTML email files + ESP import instructions
  • CONTENT: contentPack artifact has seoPages, blogPosts, articles counts

Stage 9: QA

The QA orchestrator (cross-team call to marketing-website-qa) runs 7 audit dimensions against the built website:

DimensionWeightPass Threshold
Visual Quality25%70
SEO20%75
Accessibility20%75
Brand Consistency15%80
Conversion10%n/a
Content Quality10%75
Production Readinesspass/fail80

Produces a QualityReport with overall_score, grade (A–F), pass (boolean), and top 10 issues sorted by severity.

Verification checklist:

  • QualityReport exists with overall_score (0–100), grade, pass
  • Each dimension has a sub-score
  • Top issues array contains up to 10 items with location and fix fields
  • If score >= 80: pass = true, proceed to LAUNCH
  • If score < 80: launch-prep halts, recommends site-polish

Stage 10: LAUNCH

The launch-prep skill (launch-gatekeeper worker, sonnet model):

  1. Delegates QA to qa-orchestrator (if not already run)
  2. Compiles handoff document at {output_root}/launch/handoff.md
  3. Prepares deployment commands (does NOT execute them)
  4. Computes lineage scoring aggregates

Decision Point 4: "All deliverables are ready. QA score: 85/100. Approve launch, or request changes?"

For this test, answer: approve

Verification checklist:

  • handoff.md exists with all sections populated: Pipeline Summary, Decision History, Deliverables (Brand, Social, Website, Email, Content), Quality, Maintenance Notes
  • Pipeline state status = "completed"
  • completedAt is ISO-8601
  • project-lineage.json has scoring object with: tooling_performance, anti_pattern_score, revision_rate
  • Deployment commands are printed but NOT executed

Output Artifacts

ArtifactLocationFormat
Pipeline state{output_root}/vandoko-pipeline-state.jsonJSON
Project lineage{output_root}/project-lineage.jsonJSON
Client profileIn pipeline state artifactsJSON
Discovery reportIn pipeline state artifactsJSON
Brand strategyIn pipeline state artifactsJSON
Concept gallery{output_root}/concepts/gallery.htmlHTML
Concept images{output_root}/concepts/{id}/*.pngPNG
Brand reference{output_root}/brand-reference.jsonJSON
Brand guidelines{output_root}/brand/*.pptxPPTX
Design tokens{output_root}/brand/tokens/CSS/JSON
Social banners{output_root}/social/banners/PNG
Social templates{output_root}/social/*.pptxPPTX
Content calendar{output_root}/social/calendar.mdMarkdown
Website build{output_root}/website/Next.js project
E2E baselines{output_root}/website/screenshots/baseline/PNG
Email sequences{output_root}/email/HTML
Content pack{output_root}/content/Markdown
QA reportIn pipeline state artifactsJSON
Handoff document{output_root}/launch/handoff.mdMarkdown
Portal{output_root}/portal/Next.js route

Troubleshooting

SymptomLikely CauseFix
"Playwright unavailable" in INTAKEPlaywright not installedRun npx playwright install chromium
Nanobanana fails in CONCEPTAPI key not in KeychainRun security add-generic-password -s nanobanana -a default -w YOUR_KEY
Exa returns fewer than 3 competitors in DISCOVERYNiche industry, narrow searchSystem auto-broadens queries; if still thin, provide competitor URLs in Q15
QA score below 80 at LAUNCHVisual or SEO issuesSystem recommends site-polish; run /qa polish the site
Stage fails with schema validation errorMalformed artifact outputCheck error message for specific field; pipeline pauses with resumeFromStage set
Pipeline hangs at WEBSITEwebsite-autopilot timeout (>20 min)Check innerPipelineState for last known stage; resume with --resume flag

On this page