Chapter 3 of 10

Project Playbooks

Step-by-Step Guides for Common Projects

Chapter 3: Project Playbooks - Complete Build Sequences

Why You Need Playbooks

Building with AI isn’t one prompt. It’s a sequence of prompts, in the right order, each building on the last.

When I built my cleaning business site, I made every mistake: jumped straight to design without structure, asked for features before defining data, debugged styling before functionality worked. I was three days in before realizing I’d built in the wrong order.

Then I tried again with a sequence: structure first, functionality second, styling third. Built the same site in one day.

This chapter gives you those sequences—playbooks for the most common project types. Not as rules, but as proven paths that work.

The Universal Build Sequence

Regardless of project type, this order works:

  1. Structure (What goes where)
  2. Content (Actual text and data)
  3. Functionality (Making things work)
  4. Styling (Making it look good)
  5. Responsive (Making it work on all devices)
  6. Polish (Transitions, loading states, final touches)

Most builders do it backwards: they start with “make it pretty” then can’t figure out why functionality is hard to add. Structure first, pretty last.

Playbook 1: The Landing Page (For Products/Services)

What This Is: Single-page site promoting one thing, driving to one action.

My Example: The cleaning business site—promote the service, get contact form submissions.

Prompt Sequence:

Step 1: Define Structure

I'm building a landing page for [your product/service].

Create a sitemap showing:
- What sections appear (hero, features, testimonials, etc.)
- What each section contains
- The user flow from arrival to conversion

Target action: [what you want visitors to do]
Target audience: [who this is for]

Step 2: Content Framework

For my landing page structure, provide content templates for:

Hero section:
- Headline formula (value proposition)
- Subheadline formula (who it's for/why it matters)
- CTA button text options

Features section:
- How many features to show
- Structure for each feature (icon + title + description)

Social proof section:
- Testimonial format
- Where to place trust signals

Provide 3 variations I can choose from.

Step 3: Build Structure

Build the HTML structure for my landing page with these sections:
[List sections from step 1]

Requirements:
- Semantic HTML (header, main, section, footer)
- Placeholder content with clear labels
- No styling yet (just structure)
- Commented section dividers
- Responsive meta tags

Deliver as single HTML file.

Step 4: Add Functionality

Add functionality to the contact form:

Form fields:
[List your fields from requirements]

Behavior:
- Validate [specific fields] before submission
- Show loading state during submission
- Handle success: [what happens]
- Handle errors: [what happens]

Submit to: [email/API endpoint/etc.]

Provide JavaScript with error handling.

Step 5: Apply Styling

Style the landing page with this aesthetic:

Reference: [URL or description]
Color palette: [your colors]
Typography: [font choices and sizes]

Specific styling:
- Hero: [full-screen/large, background image/color]
- Features: [card layout/list, icons/no icons]
- CTA buttons: [prominent/subtle, shape, hover effect]

Make it look like [reference] but with [your colors/branding].

Provide complete CSS.

Step 6: Make Responsive

Make the landing page mobile-responsive:

Breakpoints:
- Mobile: < 640px
- Tablet: 640px - 1024px  
- Desktop: > 1024px

Specific adaptations:
- Hero: [how it changes on mobile]
- Features: [3 columns → 1 column on mobile]
- Navigation: [full menu → hamburger on mobile]
- Typography: [size adjustments]

Test at each breakpoint and provide media queries.

Step 7: Polish

Add polish to the landing page:

- Smooth scroll to sections when clicking nav links
- Fade-in animation when sections enter viewport
- Loading state on form submission
- Success message after form submits
- Optimize images (lazy loading, compression)

Keep animations subtle and professional.

Time Estimate: 4-6 hours for someone new to this process.

Real Result from My Site: Following this sequence, I went from zero to deployed landing page in one day. The structure-first approach meant I never had to backtrack.

Playbook 2: The Directory/Listing Site

What This Is: Site displaying many items (products, profiles, locations) with search/filter.

My Example: The designer directory—showing 500+ designer profiles with filtering.

Prompt Sequence:

Step 1: Data Model

I'm building a directory of [items you're listing].

Define the data model for each item:

Required fields:
- [Field name]: [type, example value]
- [Field name]: [type, example value]

Optional fields:
- [Field name]: [type, example value]

How users will filter:
- By [attribute]
- By [attribute]

Provide:
1. JSON structure for one item
2. Recommended data storage (JSON file, API, database)
3. How many items before I need a real database

Step 2: Display Component

Create a card component to display each [item type].

Each card shows:
- [Field 1 - e.g., image]
- [Field 2 - e.g., title]  
- [Field 3 - e.g., description]
- [Action - e.g., "View Details" link]

Card style:
- Size: [dimensions or "fill grid cell"]
- Hover effect: [lift/border change/etc.]
- Layout: [image top/left, text layout]

Provide component code that accepts item data as props/parameters.

Step 3: Grid Layout

Display the cards in a responsive grid:

Desktop: [number] columns
Tablet: [number] columns  
Mobile: [number] columns

Grid specifications:
- Gap between cards: [size]
- Container max-width: [size]
- Cards should be equal height

Provide CSS Grid or Flexbox solution with responsive breakpoints.

Step 4: Filter System

Build filter controls for:

[Filter 1]: [type - dropdown/checkboxes/search]
- Options: [list options]

[Filter 2]: [type]
- Options: [list options]

[Filter 3]: [type]
- Behavior: [e.g., autocomplete, multi-select]

Functionality:
- Filters work together (AND logic)
- Results update in real-time
- Show count of filtered results
- "Clear all filters" button
- Show "no results" state

Provide filtering logic that works with my data structure.

Step 5: Search Functionality

Add search that:

Searches in these fields:
- [Field 1]
- [Field 2]

Behavior:
- Search as user types (debounced by 300ms)
- Case-insensitive matching
- Highlights search terms in results (optional)
- Works together with filters
- Shows "no results" state

Provide search function and UI component.

Step 6: Pagination or Infinite Scroll

Display [items per page/load].

Implement [pagination/infinite scroll]:

Pagination option:
- Show page numbers
- Previous/Next buttons
- Jump to page functionality
- Maintain filters when changing pages

Infinite scroll option:
- Load more on scroll to bottom
- Show loading indicator
- Stop when all items shown

Provide implementation with my existing filter/search.

Step 7: Detail View

Create a detail page/modal for individual items showing:

- All item information (not just card preview)
- [Specific additional fields not shown in card]
- [Call to action - contact, purchase, etc.]
- Back/close navigation

Style consistently with card design.
Provide routing logic or modal implementation.

Time Estimate: 2-3 days for full implementation with 50-100 items.

Real Result: My directory started with 50 designers in a JSON file. Using this sequence, I had a working filter-able directory in two days. Later scaled to 500+ with database migration.

Playbook 3: The Dashboard/Admin Tool

What This Is: Interface for managing data, viewing metrics, admin tasks.

My Example: The admin dashboard for my directory (adding/editing designers).

Prompt Sequence:

Step 1: Define Admin Actions

I need an admin dashboard to manage [what you're managing].

Admin needs to:
- [Action 1 - e.g., view all items in table]
- [Action 2 - e.g., add new item]
- [Action 3 - e.g., edit existing item]
- [Action 4 - e.g., delete item]
- [Action 5 - e.g., view statistics]

For each action, specify:
- What data is shown/modified
- What inputs are needed
- What validation is required

Step 2: Table View

Create a data table showing all [items]:

Columns to display:
- [Column 1]
- [Column 2]
- [Column 3]
- Actions column (edit/delete buttons)

Features:
- Sort by any column
- Search across [specific columns]
- Pagination ([items per page])
- Select multiple items for bulk actions
- Responsive (mobile shows fewer columns)

Provide table component that works with my data.

Step 3: Create/Edit Form

Build a form for adding/editing [items]:

Fields:
- [Field 1]: [input type, validation]
- [Field 2]: [input type, validation]
- [Field 3]: [input type, validation]

Features:
- Pre-populate for editing
- Show validation errors inline
- Save/Cancel buttons
- Auto-save draft (optional)
- Image upload if needed

Provide form component with validation logic.

Step 4: Authentication

Protect admin dashboard with authentication:

Requirements:
- Only [your email/specific users] can access
- Login page before dashboard
- Stay logged in between sessions
- Logout functionality

Recommend:
- Simplest auth service for my needs
- Implementation steps
- How to protect admin routes

I want: simple, secure, minimal setup.

Step 5: CRUD Operations

Implement data operations:

Create:
- Validate new item data
- Add to [database/file]
- Show success confirmation
- Clear form after success

Read:
- Fetch all items for table
- Fetch single item for editing
- Handle loading states

Update:
- Save modified item data
- Optimistic UI update
- Handle save errors

Delete:
- Confirm before deleting
- Remove from data source
- Update UI after deletion

Provide functions for each operation.

Step 6: Dashboard Metrics

Add metrics dashboard showing:

Key metrics:
- [Metric 1 - e.g., total items]
- [Metric 2 - e.g., items added this month]
- [Metric 3 - e.g., most popular category]

Display as:
- Cards with large numbers
- Simple bar/line charts
- Date range filter (optional)

Keep visualizations simple and fast.
Provide metrics calculation and display components.

Step 7: Layout and Navigation

Create admin layout with:

Sidebar navigation:
- [Section 1 - e.g., Dashboard]
- [Section 2 - e.g., Items]
- [Section 3 - e.g., Settings]
- Logout link

Top bar:
- Current page title
- User info/avatar
- Quick actions (optional)

Layout should:
- Sidebar collapses on mobile
- Be clean and functional
- Highlight current section

Provide layout component with routing.

Time Estimate: 3-5 days depending on data complexity.

Real Result: Built a complete admin dashboard for my directory using Retool in 4 hours. But first attempt with custom code took 3 days. Sometimes no-code tools are the right answer.

Playbook 4: The Interactive Web App

What This Is: Single-purpose tool users interact with (calculators, timers, converters).

My Example: The Pomodoro timer—focused work sessions with breaks.

Prompt Sequence:

Step 1: Core Logic First

I'm building [app name] that does [main function].

Define the core logic:

State that needs tracking:
- [State 1 - e.g., current time]
- [State 2 - e.g., is running]
- [State 3 - e.g., session count]

Key functions:
- [Function 1 - e.g., start timer]
- [Function 2 - e.g., pause timer]
- [Function 3 - e.g., reset timer]

Edge cases to handle:
- [Case 1 - e.g., what if tab switches]
- [Case 2 - e.g., what if user closes browser]

Provide pseudocode or plain language logic first.

Step 2: UI State Management

Implement state management for:

State values:
- [List all state from step 1]

State updates:
- When [action], update [state] to [value]
- When [action], update [state] to [value]

State persistence:
- Store [which state] in localStorage
- Restore on page load
- Clear when [condition]

Use [framework/vanilla JS].
Provide state management code with comments.

Step 3: Interface Components

Build interface components:

Main display:
- Shows [primary information]
- Size: [large/prominent]
- Updates every [interval]

Controls:
- [Button 1]: [action and appearance]
- [Button 2]: [action and appearance]
- [Control 3]: [type and behavior]

Settings panel:
- [Setting 1]: [input type, range]
- [Setting 2]: [input type, options]
- Toggle to show/hide

Visual feedback:
- [Action] shows [feedback]
- [State change] triggers [visual update]

Provide component code connected to state.

Step 4: User Interactions

Implement interactions:

Click/tap actions:
- [Element]: [what happens]
- [Element]: [what happens]

Keyboard shortcuts:
- [Key/combo]: [action]
- [Key/combo]: [action]

Drag/swipe (if applicable):
- [Gesture]: [result]

Interactions should:
- Provide immediate feedback
- Be accessible (keyboard + mouse)
- Work on touch devices
- Show disabled states when appropriate

Provide event handlers and accessibility attributes.

Step 5: Background Behavior

Handle background operation:

App should:
- Continue [main function] when tab inactive
- Show correct state when returning to tab
- [Notify/don't notify] when complete
- Persist [what data] between sessions

Specific requirements:
- Works if browser minimized: [yes/no and how]
- Works if device sleeps: [yes/no and how]  
- Recovers if connection lost: [yes/no and how]

Provide background handling code with fallbacks.

Step 6: Visual Polish

Add polish to interface:

Transitions:
- State changes animate smoothly
- Button presses show feedback
- Panel open/close is animated

Visual states:
- [State 1]: [color/appearance]
- [State 2]: [color/appearance]
- Transitions between states: [timing]

Micro-interactions:
- [Action] triggers [subtle animation]
- [Action] provides [haptic feedback on mobile]

Keep animations performant (60fps).
Use CSS transforms and transitions.

Step 7: Progressive Enhancement

Make app work everywhere:

Core functionality without JavaScript:
- Shows [what] if JS disabled
- Provides [fallback behavior]

Offline capability:
- Cache necessary assets
- Works without internet: [yes/no]
- Service worker setup: [yes/no]

Browser support:
- Must work: [list browsers]
- Nice to have: [list browsers]
- Polyfills needed: [list if any]

Provide progressive enhancement layer.

Time Estimate: 2-4 days for a focused single-purpose app.

Real Result: Pomodoro timer took 3 days following this sequence. Core logic first meant UI work was just connecting buttons to working functions.

The Common Prompt Mistakes in Sequences

Mistake 1: Skipping Structure

  • Don’t: “Build a dashboard” (too vague)
  • Do: Step 1 structure, Step 2 components, Step 3 connections

Mistake 2: Styling Too Early

  • Don’t: Make it pretty before it works
  • Do: Function first, form later

Mistake 3: Everything at Once

  • Don’t: “Build steps 1-7 in one go”
  • Do: One step at a time, verify it works, then next

Mistake 4: Not Testing Between Steps

  • Don’t: Generate all code then test
  • Do: Test after each step, fix before continuing

Mistake 5: Ignoring Mobile Until End

  • Don’t: Build for desktop, retrofit for mobile
  • Do: Consider responsive at structure stage

How to Use These Playbooks

  1. Choose the playbook that matches your project type
  2. Customize the prompts with your specific requirements
  3. Follow the sequence in order—don’t skip ahead
  4. Test after each step before moving to the next
  5. Adjust as needed but keep the general order

These aren’t rigid rules. They’re proven paths. Deviate when you have a good reason, but return to the structure when you get stuck.

What This Chapter Gives You

You now have:

  • Four complete build sequences for common project types
  • Prompt-by-prompt instructions for each phase
  • Time estimates to set realistic expectations
  • Common mistakes to avoid
  • Real examples from actual projects

Building complex things becomes manageable when you break them into the right sequence. These playbooks are that sequence.

Next up: Chapter 4 covers the specific moments you get stuck—the prompts for “how do I…?” situations that aren’t full projects.