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
/go-vandoko meridianrobotics.comOr 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:
| # | Question | Your 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):
| # | Question | Your Test Answer |
|---|---|---|
| Q6 | Target launch date | June 2026 |
| Q7 | Hard deadline? | no |
| Q8 | Budget range | mid |
| Q9 | Existing logo? | yes |
| Q10 | Existing brand guidelines? | no |
| Q14 | Inspiration URLs | universalrobots.com, fanuc.com, veo.com |
| Q15 | Competitor URLs | universalrobots.com, fanuc.com |
| Q16 | Color preference | Industrial blue and steel gray. Avoid bright colors. |
| Q17 | Brand mood | professional |
| Q19 | Avoid | playful, cartoonish, stock photos of handshakes |
| Q20 | Target audience | VP Operations and Plant Managers at mid-market US manufacturers |
The system shows a confirmation summary:
──────────────────────────────────────────
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 answersPress Enter to confirm.
Verification checklist:
- InterviewResult JSON is assembled with all 7 categories populated
meta.question_countreflects the actual count of questions answeredinterview_pathis"extended"deliverable_selections.websiteistrue
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
manufacturingorb2b-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.jsonexists withcurrentStage: "INTAKE"then updated to"DISCOVERY"historyarray 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_confidenceis >= 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):
- Exa searches for 3–5 competitors (Universal Robots, FANUC will appear since we named them)
- Claude synthesizes market landscape: trends, opportunities, threats
- Gemini researches design trends for manufacturing/industrial websites
- Claude compares Meridian's current brand against competitors (brand gap analysis)
- Exa discovers 5–8 inspiration references (best manufacturing website designs)
- Gemini visually analyzes top 3–5 inspiration URLs (extracts color palettes, typography, layout patterns)
- Exa researches Meridian's brand perception (reviews, press mentions)
- 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 withrelevance_scorevaluesvisual_references[]has entries withcolor_palette_extractedhex arraysgenerated_byis"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:
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 accessibleDecision 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_spectrumhas 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:
- Meridian — Clean (template: streamline) — Hero, cards, buttons images
- Meridian — Bold (template: plasma) — Hero, cards, buttons images
- 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.htmlopens in a browser and shows 3 cards with images, color swatches, and template badges- ConceptSelection artifact:
selected: "concept-bold",selectedAtis 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:
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
historyshows 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,deployUrlin artifacts - EMAIL:
{output_root}/email/contains HTML email files + ESP import instructions - CONTENT:
contentPackartifact hasseoPages,blogPosts,articlescounts
Stage 9: QA
The QA orchestrator (cross-team call to marketing-website-qa) runs 7 audit dimensions against the built website:
| Dimension | Weight | Pass Threshold |
|---|---|---|
| Visual Quality | 25% | 70 |
| SEO | 20% | 75 |
| Accessibility | 20% | 75 |
| Brand Consistency | 15% | 80 |
| Conversion | 10% | n/a |
| Content Quality | 10% | 75 |
| Production Readiness | pass/fail | 80 |
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
locationandfixfields - 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):
- Delegates QA to qa-orchestrator (if not already run)
- Compiles handoff document at
{output_root}/launch/handoff.md - Prepares deployment commands (does NOT execute them)
- 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.mdexists with all sections populated: Pipeline Summary, Decision History, Deliverables (Brand, Social, Website, Email, Content), Quality, Maintenance Notes- Pipeline state
status="completed" completedAtis ISO-8601project-lineage.jsonhasscoringobject with:tooling_performance,anti_pattern_score,revision_rate- Deployment commands are printed but NOT executed
Output Artifacts
| Artifact | Location | Format |
|---|---|---|
| Pipeline state | {output_root}/vandoko-pipeline-state.json | JSON |
| Project lineage | {output_root}/project-lineage.json | JSON |
| Client profile | In pipeline state artifacts | JSON |
| Discovery report | In pipeline state artifacts | JSON |
| Brand strategy | In pipeline state artifacts | JSON |
| Concept gallery | {output_root}/concepts/gallery.html | HTML |
| Concept images | {output_root}/concepts/{id}/*.png | PNG |
| Brand reference | {output_root}/brand-reference.json | JSON |
| Brand guidelines | {output_root}/brand/*.pptx | PPTX |
| Design tokens | {output_root}/brand/tokens/ | CSS/JSON |
| Social banners | {output_root}/social/banners/ | PNG |
| Social templates | {output_root}/social/*.pptx | PPTX |
| Content calendar | {output_root}/social/calendar.md | Markdown |
| 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 report | In pipeline state artifacts | JSON |
| Handoff document | {output_root}/launch/handoff.md | Markdown |
| Portal | {output_root}/portal/ | Next.js route |
Troubleshooting
| Symptom | Likely Cause | Fix |
|---|---|---|
| "Playwright unavailable" in INTAKE | Playwright not installed | Run npx playwright install chromium |
| Nanobanana fails in CONCEPT | API key not in Keychain | Run security add-generic-password -s nanobanana -a default -w YOUR_KEY |
| Exa returns fewer than 3 competitors in DISCOVERY | Niche industry, narrow search | System auto-broadens queries; if still thin, provide competitor URLs in Q15 |
| QA score below 80 at LAUNCH | Visual or SEO issues | System recommends site-polish; run /qa polish the site |
| Stage fails with schema validation error | Malformed artifact output | Check error message for specific field; pipeline pauses with resumeFromStage set |
| Pipeline hangs at WEBSITE | website-autopilot timeout (>20 min) | Check innerPipelineState for last known stage; resume with --resume flag |