@oaklandzoo/ostup 0.3.0 → 0.5.0

package/src/brief/questions.mjs

@@ -0,0 +1,333 @@
+// brief/questions.mjs: the 10 intake questions for `ostup brief`. Uses @clack/prompts.
+
+import * as p from '@clack/prompts';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { SCHEMA_VERSION, AUDIENCES, BUSINESS_MODELS, CORE_FLOWS, DATA_KINDS, DEADLINES, BUDGET_POSTURES, PROFILES } from './schema.mjs';
+import { classify, resolveAddons } from './classify.mjs';
+import { emptyBrief } from './schema.mjs';
+
+const PROFILE_OPTIONS = [
+  { value: 'marketing', label: 'Marketing site' },
+  { value: 'lead-gen', label: 'Lead-gen service company site' },
+  { value: 'booking', label: 'Booking or appointments site' },
+  { value: 'blog', label: 'Blog or content engine' },
+  { value: 'storefront', label: 'Storefront / ecommerce-lite' },
+  { value: 'saas-dashboard', label: 'SaaS MVP with dashboard' },
+  { value: 'directory', label: 'Directory or listings site' },
+  { value: 'portfolio', label: 'Portfolio or case-study site' },
+  { value: '__auto__', label: 'Not sure — classify it from my answers' },
+];
+
+const AUDIENCE_OPTIONS = [
+  { value: 'small_business', label: 'A small business or service company' },
+  { value: 'founder', label: 'A founder validating a SaaS or AI product' },
+  { value: 'agency', label: 'An agency / operator building for clients' },
+  { value: 'creator', label: 'A creator, writer, consultant, or portfolio owner' },
+  { value: 'community', label: 'A marketplace, directory, or community' },
+  { value: 'other', label: 'Other' },
+];
+
+const BUSINESS_MODEL_OPTIONS = [
+  { value: 'lead_capture', label: 'Lead capture' },
+  { value: 'booking_revenue', label: 'Appointment or booking revenue' },
+  { value: 'deposit', label: 'Deposit or full payment at booking' },
+  { value: 'subscription', label: 'Subscription' },
+  { value: 'one_time_sale', label: 'One-time product sale' },
+  { value: 'content_traffic', label: 'Content / search traffic' },
+  { value: 'dashboard', label: 'Member portal or dashboard' },
+  { value: 'operations', label: 'Internal operations tool' },
+  { value: 'brand_awareness', label: 'Brand awareness only' },
+];
+
+const CORE_FLOW_OPTIONS = [
+  { value: 'contact_form', label: 'Submit contact form' },
+  { value: 'booking', label: 'Book appointment or request dates' },
+  { value: 'payment', label: 'Pay deposit or checkout' },
+  { value: 'auth', label: 'Sign up / log in' },
+  { value: 'dashboard', label: 'View dashboard' },
+  { value: 'content_crud', label: 'Create or edit content / listings' },
+  { value: 'search_filter', label: 'Search / filter listings' },
+  { value: 'newsletter', label: 'Subscribe to newsletter' },
+  { value: 'file_upload_download', label: 'Download or upload a file' },
+  { value: 'other', label: 'Other' },
+];
+
+const DATA_OPTIONS = [
+  { value: 'none', label: 'None — static site only' },
+  { value: 'leads', label: 'Leads or contact submissions' },
+  { value: 'bookings', label: 'Appointments, bookings, or availability' },
+  { value: 'products_orders', label: 'Products, orders, or payments' },
+  { value: 'users_accounts', label: 'Users, accounts, profiles, or roles' },
+  { value: 'content', label: 'Blog posts or content entries' },
+  { value: 'listings', label: 'Listings or directory records' },
+  { value: 'files', label: 'Files, images, PDFs, or uploads' },
+  { value: 'unsure', label: 'Not sure — recommend it' },
+];
+
+const DEADLINE_OPTIONS = [
+  { value: 'demo_today', label: 'Demo today' },
+  { value: 'mvp_7_days', label: 'MVP in 7 days' },
+  { value: 'production_2_4_weeks', label: 'Production in 2-4 weeks' },
+  { value: 'none', label: 'No deadline yet' },
+];
+
+const BUDGET_OPTIONS = [
+  { value: 'free_tier_first', label: 'Free-tier only' },
+  { value: 'under_50_month', label: 'Under $50/month' },
+  { value: 'under_250_month', label: 'Under $250/month' },
+  { value: 'paid_ok', label: 'Paid tools okay if justified' },
+];
+
+function isCancel(v) {
+  return p.isCancel ? p.isCancel(v) : false;
+}
+
+export function validateSummary(s) {
+  if (typeof s !== 'string' || s.trim() === '') return 'required';
+  const len = s.trim().length;
+  if (len < 20) return 'too short — at least 20 characters';
+  if (len > 240) return 'too long — under 240 characters';
+  if (/^(website|app|tool|site|landing page|something|stuff)\.?$/i.test(s.trim())) {
+    return 'too generic — be specific about what it does, who for, and what is special';
+  }
+  return null;
+}
+
+function toBullets(text) {
+  if (!text) return [];
+  // Operator may pass comma-separated, semicolon-separated, or newline.
+  return text
+    .split(/[\n,;]+/)
+    .map((s) => s.trim())
+    .filter(Boolean)
+    .slice(0, 12);
+}
+
+function recommendDataModel(dataSelections, brief) {
+  const map = {
+    leads: 'postgres',
+    bookings: 'postgres',
+    products_orders: 'postgres',
+    users_accounts: 'postgres',
+    listings: 'postgres',
+    files: 'blob',
+    content: 'mdx',
+  };
+  const recs = new Set();
+  for (const sel of dataSelections) {
+    if (map[sel]) recs.add(map[sel]);
+  }
+  if (dataSelections.includes('unsure')) {
+    // Suggest based on business model
+    const types = brief.business_model?.types || [];
+    if (types.includes('subscription') || types.includes('dashboard')) recs.add('postgres');
+    if (types.includes('content_traffic')) recs.add('mdx');
+  }
+  return {
+    needs_storage: dataSelections.some((d) => !['none', 'unsure'].includes(d)),
+    recommended_storage: Array.from(recs),
+    raw_selections: dataSelections,
+  };
+}
+
+function entitiesFromDataKinds(dataSelections) {
+  const entities = [];
+  if (dataSelections.includes('leads')) {
+    entities.push({ name: 'Lead', fields: ['name', 'email', 'phone', 'message', 'created_at'], source: 'intake' });
+  }
+  if (dataSelections.includes('bookings')) {
+    entities.push({ name: 'Booking', fields: ['date_start', 'date_end', 'guest_name', 'status', 'deposit_status'], source: 'intake' });
+  }
+  if (dataSelections.includes('products_orders')) {
+    entities.push({ name: 'Product', fields: ['name', 'price', 'description'], source: 'intake' });
+    entities.push({ name: 'Order', fields: ['user_id', 'items', 'total', 'status'], source: 'intake' });
+  }
+  if (dataSelections.includes('users_accounts')) {
+    entities.push({ name: 'User', fields: ['email', 'name', 'created_at'], source: 'intake' });
+  }
+  if (dataSelections.includes('content')) {
+    entities.push({ name: 'Post', fields: ['title', 'slug', 'date', 'tags', 'body_mdx'], source: 'intake' });
+  }
+  if (dataSelections.includes('listings')) {
+    entities.push({ name: 'Listing', fields: ['title', 'description', 'category', 'created_at'], source: 'intake' });
+  }
+  return entities;
+}
+
+export async function runIntake({ defaults = {} } = {}) {
+  const brief = emptyBrief();
+
+  // 1. Summary
+  const summary = await p.text({
+    message: 'What are you building? One sentence (20-240 chars).',
+    placeholder: 'A booking site for a boutique ski lodge with deposits, calendar sync, and a guest dashboard.',
+    validate: (v) => validateSummary(v) || undefined,
+  });
+  if (isCancel(summary)) return { cancelled: true };
+  brief.project.summary = summary.trim();
+
+  // 2. Audience
+  const audience = await p.select({
+    message: 'Who is this primarily for?',
+    options: AUDIENCE_OPTIONS,
+    initialValue: defaults.audience || 'small_business',
+  });
+  if (isCancel(audience)) return { cancelled: true };
+  brief.audience.primary = audience;
+
+  // 3. Site type
+  const siteTypeChoice = await p.select({
+    message: 'Pick the closest app or site type.',
+    options: PROFILE_OPTIONS,
+    initialValue: defaults.profile || 'lead-gen',
+  });
+  if (isCancel(siteTypeChoice)) return { cancelled: true };
+  const explicitProfile = siteTypeChoice === '__auto__' ? null : siteTypeChoice;
+
+  // 4. Business model (multi)
+  const bm = await p.multiselect({
+    message: 'How does this make money or create value? (space to select, enter to confirm)',
+    options: BUSINESS_MODEL_OPTIONS,
+    required: true,
+    initialValues: defaults.business_model || ['lead_capture'],
+  });
+  if (isCancel(bm)) return { cancelled: true };
+  brief.business_model.types = bm;
+
+  // 5. Must-have sections
+  const sections = await p.text({
+    message: 'What must be on the homepage or primary dashboard? Comma-separated or one per line.',
+    placeholder: 'hero, pricing, services, testimonials, contact form',
+    validate: (v) => (toBullets(v).length === 0 ? 'at least one section required' : undefined),
+  });
+  if (isCancel(sections)) return { cancelled: true };
+  brief.scope.must_have_sections = toBullets(sections);
+
+  // 6. Data
+  const data = await p.multiselect({
+    message: 'What data needs to be stored? (space to select)',
+    options: DATA_OPTIONS,
+    required: true,
+    initialValues: ['none'],
+  });
+  if (isCancel(data)) return { cancelled: true };
+  const dm = recommendDataModel(data, brief);
+  brief.data_model.needs_storage = dm.needs_storage;
+  brief.data_model.recommended_storage = dm.recommended_storage;
+  brief.data_model.entities = entitiesFromDataKinds(data);
+
+  // 7. Core flows
+  const flows = await p.multiselect({
+    message: 'Which flows must work on day one? Pick up to 5. (space to select)',
+    options: CORE_FLOW_OPTIONS,
+    required: true,
+    initialValues: defaults.core_flows || ['contact_form'],
+  });
+  if (isCancel(flows)) return { cancelled: true };
+  brief.scope.core_flows = flows;
+
+  // 8. Brand
+  const brandVibe = await p.text({
+    message: 'Three words for vibe (comma-separated). e.g. credible, warm, premium',
+    placeholder: 'credible, warm, premium',
+    validate: (v) => (toBullets(v).length < 1 ? 'at least one word' : undefined),
+  });
+  if (isCancel(brandVibe)) return { cancelled: true };
+  brief.brand.vibe = toBullets(brandVibe).slice(0, 5);
+
+  const brandNotes = await p.text({
+    message: 'Optional: brand notes — colors, fonts, logo direction. (Enter to skip)',
+    placeholder: 'Navy + white. Bold sans for headlines. Mountain logo.',
+  });
+  if (isCancel(brandNotes)) return { cancelled: true };
+  if (brandNotes && brandNotes.trim()) {
+    brief.brand.color_notes = brandNotes;
+  }
+
+  // 9. Inputs
+  const wantsIngest = await p.confirm({
+    message: 'Do you have research, screenshots, brand files, images, or notes to ingest?',
+    initialValue: false,
+  });
+  if (isCancel(wantsIngest)) return { cancelled: true };
+  if (wantsIngest) {
+    const path = await p.text({
+      message: 'Source folder path to copy from:',
+      placeholder: '/path/to/materials',
+      validate: (v) => {
+        if (!v || !v.trim()) return 'required';
+        if (!existsSync(resolve(v))) return `path does not exist: ${v}`;
+        return undefined;
+      },
+    });
+    if (isCancel(path)) return { cancelled: true };
+    brief.inputs = { ingested: true, source_path: path.trim(), manifest_path: 'inputs/INGEST_MANIFEST.md' };
+  }
+
+  // 10. Constraints
+  const deadline = await p.select({
+    message: 'What are the launch constraints?',
+    options: DEADLINE_OPTIONS,
+    initialValue: 'mvp_7_days',
+  });
+  if (isCancel(deadline)) return { cancelled: true };
+  brief.constraints.deadline = deadline;
+
+  const budget = await p.select({
+    message: 'Budget posture:',
+    options: BUDGET_OPTIONS,
+    initialValue: 'free_tier_first',
+  });
+  if (isCancel(budget)) return { cancelled: true };
+  brief.constraints.budget_posture = budget;
+
+  const mustUseRaw = await p.text({
+    message: 'Optional: must-use vendors (comma-separated). Enter to skip.',
+    placeholder: 'Stripe, Resend',
+  });
+  if (isCancel(mustUseRaw)) return { cancelled: true };
+  if (mustUseRaw && mustUseRaw.trim()) brief.constraints.must_use = toBullets(mustUseRaw);
+
+  const mustAvoidRaw = await p.text({
+    message: 'Optional: must-avoid vendors (comma-separated). Enter to skip.',
+    placeholder: 'jQuery, anything Google',
+  });
+  if (isCancel(mustAvoidRaw)) return { cancelled: true };
+  if (mustAvoidRaw && mustAvoidRaw.trim()) brief.constraints.must_avoid = toBullets(mustAvoidRaw);
+
+  // Classify
+  const cls = classify(brief, { explicitProfile });
+  brief.classification = {
+    site_profile: cls.site_profile,
+    confidence: cls.confidence,
+    why: cls.why,
+    secondary_profiles: cls.secondary_profiles,
+  };
+
+  // Scaffold + acceptance
+  brief.scaffold.profile = cls.site_profile;
+  brief.scaffold.addons = cls.addons;
+  brief.scaffold.template_paths = ['templates/base', `templates/profiles/${cls.site_profile}`];
+
+  // Auto-derive acceptance from selected flows
+  brief.verification.acceptance_tests = autoAcceptance(brief);
+  brief.verification.deploy_checks = ['Live URL returns 200', 'OG image renders'];
+
+  return { brief, cancelled: false };
+}
+
+function autoAcceptance(brief) {
+  const tests = [];
+  const flows = brief.scope?.core_flows || [];
+  if (flows.includes('contact_form')) tests.push('Visitor can submit the contact form');
+  if (flows.includes('booking')) tests.push('Visitor can request dates');
+  if (flows.includes('payment')) tests.push('Checkout can be initiated');
+  if (flows.includes('auth')) tests.push('User can sign up and log in');
+  if (flows.includes('dashboard')) tests.push('Authenticated user reaches the dashboard');
+  if (flows.includes('content_crud')) tests.push('A post can be added and rendered');
+  if (flows.includes('search_filter')) tests.push('Listings can be filtered');
+  if (flows.includes('newsletter')) tests.push('Email can be submitted to the newsletter');
+  if (flows.includes('file_upload_download')) tests.push('A file can be uploaded and retrieved');
+  return tests;
+}

package/src/brief/render-brief.mjs

@@ -0,0 +1,232 @@
+// brief/render-brief.mjs: render docs/brief.md from a brief.json object.
+
+export function renderBrief(brief) {
+  const p = brief.project || {};
+  const c = brief.classification || {};
+  const a = brief.audience || {};
+  const bm = brief.business_model || {};
+  const scope = brief.scope || {};
+  const dm = brief.data_model || {};
+  const brand = brief.brand || {};
+  const inputs = brief.inputs || {};
+  const constraints = brief.constraints || {};
+  const sc = brief.scaffold || {};
+  const v = brief.verification || {};
+
+  const lines = [];
+  lines.push('# Project Brief');
+  lines.push('');
+  lines.push('> Source of truth for this project. Governs scaffold profile, downstream PRDs, and brand decisions.');
+  lines.push(`> Schema version: ${brief.schema_version}`);
+  lines.push('');
+
+  lines.push('## 1. Summary');
+  lines.push('');
+  lines.push(p.summary || '_(missing)_');
+  lines.push('');
+
+  lines.push('## 2. Classification');
+  lines.push('');
+  lines.push(`- **Profile:** \`${c.site_profile}\``);
+  lines.push(`- **Confidence:** ${c.confidence}`);
+  lines.push(`- **Why:**`);
+  for (const reason of c.why || []) lines.push(`  - ${reason}`);
+  if (c.secondary_profiles?.length) {
+    lines.push(`- **Secondary profiles:** ${c.secondary_profiles.map((s) => `\`${s}\``).join(', ')}`);
+  }
+  lines.push('');
+
+  lines.push('## 3. Audience');
+  lines.push('');
+  lines.push(`- **Primary:** ${a.primary}`);
+  if (a.buyer) lines.push(`- **Buyer:** ${a.buyer}`);
+  if (a.end_users?.length) lines.push(`- **End users:** ${a.end_users.join(', ')}`);
+  lines.push('');
+
+  lines.push('## 4. Business model');
+  lines.push('');
+  if (bm.types?.length) {
+    for (const t of bm.types) lines.push(`- ${t.replace(/_/g, ' ')}`);
+  } else {
+    lines.push('_(none specified)_');
+  }
+  if (bm.pricing_notes) {
+    lines.push('');
+    lines.push(`_Pricing notes:_ ${bm.pricing_notes}`);
+  }
+  lines.push('');
+
+  lines.push('## 5. Must-have experience');
+  lines.push('');
+  if (scope.must_have_sections?.length) {
+    for (const s of scope.must_have_sections) lines.push(`- ${s}`);
+  } else {
+    lines.push('_(none specified)_');
+  }
+  lines.push('');
+
+  lines.push('## 6. Core day-one flows');
+  lines.push('');
+  if (scope.core_flows?.length) {
+    for (const f of scope.core_flows) lines.push(`- ${f.replace(/_/g, ' ')}`);
+  } else {
+    lines.push('_(none specified)_');
+  }
+  if (scope.non_goals?.length) {
+    lines.push('');
+    lines.push('**Non-goals for v1:**');
+    for (const ng of scope.non_goals) lines.push(`- ${ng}`);
+  }
+  lines.push('');
+
+  lines.push('## 7. Data model');
+  lines.push('');
+  lines.push(`- **Needs storage:** ${dm.needs_storage ? 'yes' : 'no'}`);
+  if (dm.entities?.length) {
+    lines.push('- **Entities:**');
+    for (const ent of dm.entities) {
+      lines.push(`  - **${ent.name}** — fields: ${(ent.fields || []).join(', ')}`);
+    }
+  }
+  if (dm.recommended_storage?.length) {
+    lines.push(`- **Recommended storage:** ${dm.recommended_storage.join(', ')}`);
+  }
+  lines.push('');
+
+  lines.push('## 8. Brand direction');
+  lines.push('');
+  if (brand.vibe?.length) lines.push(`- **Vibe:** ${brand.vibe.join(', ')}`);
+  if (brand.color_notes) lines.push(`- **Color notes:** ${brand.color_notes}`);
+  if (brand.font_notes) lines.push(`- **Font notes:** ${brand.font_notes}`);
+  if (brand.logo_notes) lines.push(`- **Logo notes:** ${brand.logo_notes}`);
+  if (brand.inspiration_urls?.length) {
+    lines.push(`- **Inspiration:** ${brand.inspiration_urls.join(', ')}`);
+  }
+  lines.push('');
+
+  lines.push('## 9. Inputs and materials');
+  lines.push('');
+  if (inputs.ingested) {
+    lines.push(`- **Ingested:** yes`);
+    if (inputs.source_path) lines.push(`- **Source path:** \`${inputs.source_path}\``);
+    if (inputs.manifest_path) lines.push(`- **Manifest:** \`${inputs.manifest_path}\``);
+  } else {
+    lines.push('_No materials ingested. Operator can drop files in `inputs/` anytime._');
+  }
+  lines.push('');
+
+  lines.push('## 10. Constraints');
+  lines.push('');
+  lines.push(`- **Deadline:** ${constraints.deadline?.replace(/_/g, ' ')}`);
+  lines.push(`- **Budget posture:** ${constraints.budget_posture?.replace(/_/g, ' ')}`);
+  if (constraints.must_use?.length) lines.push(`- **Must use:** ${constraints.must_use.join(', ')}`);
+  if (constraints.must_avoid?.length) lines.push(`- **Must avoid:** ${constraints.must_avoid.join(', ')}`);
+  lines.push('');
+
+  lines.push('## 11. Scaffold decision');
+  lines.push('');
+  lines.push(`- **Base:** ${sc.base}`);
+  lines.push(`- **Profile:** \`${sc.profile}\``);
+  lines.push(`- **Add-ons:** ${(sc.addons || []).map((a) => `\`${a}\``).join(', ') || '_(none)_'}`);
+  lines.push(`- **Template overlays:** ${(sc.template_paths || []).map((t) => `\`${t}\``).join(', ')}`);
+  lines.push('');
+
+  lines.push('## 12. Acceptance tests');
+  lines.push('');
+  if (v.acceptance_tests?.length) {
+    for (const t of v.acceptance_tests) lines.push(`- [ ] ${t}`);
+  } else {
+    lines.push('_(none specified)_');
+  }
+  lines.push('');
+
+  if (v.visual_checks?.length) {
+    lines.push('## 13. Visual checks');
+    lines.push('');
+    for (const c of v.visual_checks) lines.push(`- [ ] ${c}`);
+    lines.push('');
+  }
+
+  if (v.deploy_checks?.length) {
+    lines.push('## 14. Deploy checks');
+    lines.push('');
+    for (const c of v.deploy_checks) lines.push(`- [ ] ${c}`);
+    lines.push('');
+  }
+
+  lines.push('## First PRD seed');
+  lines.push('');
+  lines.push('See `tasks/prd-initial-build.md` for the auto-generated PRD seed from this brief.');
+  lines.push('');
+
+  lines.push('---');
+  lines.push('');
+  lines.push('_Generated by `ostup brief`. Edit by hand to refine. Re-run with `--brief` to regenerate JSON from this file._');
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+export function renderInitialPrdSeed(brief) {
+  const p = brief.project || {};
+  const sc = brief.scaffold || {};
+  const v = brief.verification || {};
+  const scope = brief.scope || {};
+  const brand = brief.brand || {};
+  const constraints = brief.constraints || {};
+
+  const lines = [];
+  lines.push(`# Initial build PRD: ${p.display_name || p.name}`);
+  lines.push('');
+  lines.push('> Auto-seeded from `docs/brief.md`. Edit freely; the agent reads this as the first PRD.');
+  lines.push('');
+  lines.push('## What we are building');
+  lines.push('');
+  lines.push(p.summary || '_(missing — fill in from brief)_');
+  lines.push('');
+  lines.push(`## Profile: \`${sc.profile}\``);
+  lines.push('');
+  lines.push(`**Add-ons enabled:** ${(sc.addons || []).map((a) => `\`${a}\``).join(', ') || '_(none)_'}`);
+  lines.push('');
+  lines.push('## Day-one scope');
+  lines.push('');
+  lines.push('### Must-have sections');
+  for (const s of scope.must_have_sections || []) lines.push(`- ${s}`);
+  lines.push('');
+  lines.push('### Core flows');
+  for (const f of scope.core_flows || []) lines.push(`- ${f.replace(/_/g, ' ')}`);
+  lines.push('');
+  if (scope.non_goals?.length) {
+    lines.push('### Non-goals (v1 explicitly defers)');
+    for (const ng of scope.non_goals) lines.push(`- ${ng}`);
+    lines.push('');
+  }
+  lines.push('## Brand');
+  lines.push('');
+  if (brand.vibe?.length) lines.push(`- Vibe: ${brand.vibe.join(', ')}`);
+  if (brand.color_notes) lines.push(`- Color: ${brand.color_notes}`);
+  if (brand.font_notes) lines.push(`- Font: ${brand.font_notes}`);
+  if (brand.logo_notes) lines.push(`- Logo: ${brand.logo_notes}`);
+  lines.push('');
+  lines.push('## Constraints');
+  lines.push('');
+  lines.push(`- Deadline: ${constraints.deadline?.replace(/_/g, ' ')}`);
+  lines.push(`- Budget posture: ${constraints.budget_posture?.replace(/_/g, ' ')}`);
+  if (constraints.must_use?.length) lines.push(`- Must use: ${constraints.must_use.join(', ')}`);
+  if (constraints.must_avoid?.length) lines.push(`- Must avoid: ${constraints.must_avoid.join(', ')}`);
+  lines.push('');
+  lines.push('## Acceptance');
+  lines.push('');
+  for (const t of v.acceptance_tests || []) lines.push(`- [ ] ${t}`);
+  lines.push('');
+  lines.push('## How to start');
+  lines.push('');
+  lines.push('1. Run `/prompt-start` to load this PRD into context.');
+  lines.push(`2. Read \`templates/profiles/${sc.profile}/README.md\` (in the scaffold) for profile-specific guidance.`);
+  lines.push('3. Build the must-have sections in the order listed above.');
+  lines.push('4. After each visual change, run `scripts/screenshot.sh <url>` and Read the PNG per CLAUDE.md Part 19.');
+  lines.push('5. Mark acceptance tests as you complete them.');
+  lines.push('');
+
+  return lines.join('\n');
+}