Design Lounge

Call first for any new website, app, screen, or UI. Reads their request the way the method does (flow, mode, named style, calm words), ranks the recipes, reads the project folder and the recent picks, and returns the brief to fill and the steps, each naming the tool to use.

{
  "type": "object",
  "properties": {
    "request": {
      "type": "string",
      "description": "Their message, word for word"
    },
    "product": {
      "description": "The product or brand name, if they gave one",
      "type": "string"
    },
    "history": {
      "description": "Recent pick lines, for a client that keeps its own history. The local server reads ~/.design-lounge/history.jsonl",
      "maxItems": 48,
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "request"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A recipe (start) with its directions: each a complete look (theme, pairing, family, hero, effect, work, footer). Each direction says whether the recent history blocks it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Recipe id, such as saas, restaurant, portfolio. browse_library what=recipes lists them"
    },
    "product": {
      "type": "string"
    },
    "history": {
      "description": "Recent pick lines, for a client that keeps its own history. The local server reads ~/.design-lounge/history.jsonl",
      "maxItems": 48,
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Apply rules 3 to 5 of Pick a direction and the Recent picks check: calm words narrow to quiet, editorial, or sharp families; the history blocks recent directions, heroes, and effects; the group check blocks two-of-three matches; the name number breaks the tie. You judge which directions fit the subject (rules 1, 2, 4) and pass them as `fitting`.

{
  "type": "object",
  "properties": {
    "recipe": {
      "type": "string"
    },
    "product": {
      "description": "Product or brand name, for the name number. Without one, the first noun of their message",
      "type": "string"
    },
    "fitting": {
      "description": "Direction ids whose mood names this subject's world",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "calm": {
      "description": "They used a calm word: clean, simple, professional, plain, calm, quiet, corporate, serious, trustworthy",
      "type": "boolean"
    },
    "history": {
      "description": "Recent pick lines, for a client that keeps its own history. The local server reads ~/.design-lounge/history.jsonl",
      "maxItems": 48,
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "recipe"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The uniqueness check from Recent picks: direction, hero, and effect against this recipe; two of hero, work, footer against the related group; hero shape against the last two; frame against the last three. Returns problems and the Unlike line for the sheet.

{
  "type": "object",
  "properties": {
    "recipe": {
      "type": "string"
    },
    "product": {
      "type": "string"
    },
    "direction": {
      "type": "string"
    },
    "hero": {
      "type": "string"
    },
    "work": {
      "type": "string"
    },
    "footer": {
      "type": "string"
    },
    "effect": {
      "type": "string"
    },
    "shape": {
      "type": "string",
      "enum": [
        "split",
        "object",
        "type",
        "band"
      ]
    },
    "frame": {
      "description": "[header piece, phone piece or \"none\", find-us piece]",
      "minItems": 3,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "reuse": {
      "description": "Reusing a direction because every fitting one is recent: compares shape, frame, work, and footer only",
      "type": "boolean"
    },
    "history": {
      "description": "Recent pick lines, for a client that keeps its own history. The local server reads ~/.design-lounge/history.jsonl",
      "maxItems": 48,
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "recipe"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search 600+ piece briefs by words (job, component, style, tag) and filters. Returns ids, summaries, and demo links. Then get_piece for the brief.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Such as \"pricing toggle\", \"sticky mobile cta\", \"kanban\", \"footer wordmark\"",
      "type": "string"
    },
    "platform": {
      "type": "string",
      "enum": [
        "web",
        "mobile-web",
        "mobile-app",
        "pwa",
        "tablet"
      ]
    },
    "category": {
      "description": "browse_library what=categories lists them",
      "type": "string"
    },
    "style": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    },
    "images": {
      "description": "Attach thumbnails of the first six, to compare them by eye",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The spec for one piece, with a picture of its demo: structure, counts, sizes, motion timing, states, hit targets, acceptance checklist. By default stops at "Optional below this line"; full=true adds the demo's exact paint and motion notes. demo=true adds the demo's HTML source, the acceptance file. Its colours and fonts are the demo's: translate them onto the locked kit.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "full": {
      "type": "boolean"
    },
    "image": {
      "description": "Attach the demo's thumbnail (default true)",
      "type": "boolean"
    },
    "demo": {
      "description": "Add the demo's HTML source",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List themes, pairings, families, recipes, piece categories, collections, or kinds. Themes and pairings can be ranked by a mood ("warm craft", "editorial serif", "dark technical").

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "enum": [
        "themes",
        "pairings",
        "families",
        "recipes",
        "categories",
        "collections",
        "kinds",
        "motion",
        "scales"
      ]
    },
    "mood": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "light",
        "dark"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "what"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A theme's full CSS (primary, secondary, tertiary, feedback, surfaces, link) and its pair for the other mode. Colour only: fonts come from the pairing, radius and shadow from the family.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Theme id, name, or Lounge link"
    },
    "image": {
      "description": "Attach a board of the theme's roles (default true)",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A pairing's CSS (Google Fonts import, --font-display, --font-text, mono if any), its numbers face, and any caution to say before you write.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Pairing id, name, or Lounge link"
    },
    "image": {
      "description": "Attach a type specimen (default true)",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A family's rules: radius, button style, density, shadow, and the sentences that lock them. The family wins over a brief for radius, shadow, button, and density.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

SVG for Lounge Icons by name (24px, stroke 1.75). With no names, lists them by group. Missing names come back as missing: then follow Icon and nav in components.md, never an emoji.

{
  "type": "object",
  "properties": {
    "names": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "group": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sanzo Wada's 348 combinations, by colour or material word (russet, slate, "dark warm") or nearest to a hex. Only for Free colour, a brand board no theme fits, or colours they asked for. Take one line whole; the header says how to map it to roles.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "near": {
      "description": "A hex like #b14f1c",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read a method file or one section of it. Files: SKILL.md, app.md, brief.md, components.md, examples.md, flows.md, locale.md, native.md, practice.md, reference.md, search.md, show.md, styles.md, taste.md, website.md. Give a heading ("Look", "Write the idea", "Recent picks") to get only that section; outline=true lists the headings.

{
  "type": "object",
  "properties": {
    "file": {
      "type": "string"
    },
    "section": {
      "type": "string"
    },
    "outline": {
      "type": "boolean"
    }
  },
  "required": [
    "file"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The tie-break from rule 5 of Pick a direction: the sum of each letter's place in the alphabet, mod the number of fitting directions.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The all-in-one check for a built page: AI giveaways and kit drift (the Look fails), SEO, AEO, GEO, and, when Chromium is available, a rendered pass at 1280×800 and 390×844 with axe accessibility, measured labels, faces, primaries, tap targets, and saved screenshots. Returns scores, fails first, each with its evidence and fix.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "A public URL, such as https://example.com",
      "type": "string",
      "maxLength": 2048
    },
    "html": {
      "description": "Raw HTML, when there is no file or URL",
      "type": "string",
      "maxLength": 2000000
    },
    "kit": {
      "description": "The locked kit, by id, name, or Lounge link. Read from DESIGN.md when omitted",
      "type": "object",
      "properties": {
        "theme": {
          "type": "string"
        },
        "pairing": {
          "type": "string"
        },
        "family": {
          "type": "string"
        },
        "named": {
          "description": "The Named aesthetic line, which lifts the bans it lists",
          "type": "string"
        },
        "free": {
          "description": "Show mode, Free: colour and type are not locked to the library",
          "type": "boolean"
        }
      }
    },
    "render": {
      "description": "Open it in Chromium (default true)",
      "type": "boolean"
    },
    "out_dir": {
      "description": "Where to save screenshots (default: a temp folder)",
      "type": "string"
    },
    "images": {
      "description": "Attach the web and phone frames (default true)",
      "type": "boolean"
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Design only: the tells of a generated page (stock copy, em dashes, buzzwords, icon-card trios, gradients, the indigo palette, emoji icons, numbered eyebrows, placeholder copy, made-up numbers) and drift from the locked kit (faces, colours, radius, shadow). Static by default; render=true adds the measured checks.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "A public URL, such as https://example.com",
      "type": "string",
      "maxLength": 2048
    },
    "html": {
      "description": "Raw HTML, when there is no file or URL",
      "type": "string",
      "maxLength": 2000000
    },
    "kit": {
      "description": "The locked kit, by id, name, or Lounge link. Read from DESIGN.md when omitted",
      "type": "object",
      "properties": {
        "theme": {
          "type": "string"
        },
        "pairing": {
          "type": "string"
        },
        "family": {
          "type": "string"
        },
        "named": {
          "description": "The Named aesthetic line, which lifts the bans it lists",
          "type": "string"
        },
        "free": {
          "description": "Show mode, Free: colour and type are not locked to the library",
          "type": "boolean"
        }
      }
    },
    "render": {
      "type": "boolean"
    },
    "out_dir": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Whether search engines can index the page and show it well (SEO), answer engines can lift a direct answer (AEO), and AI engines can reach it, read it without JavaScript, and name the entity (GEO): title, description, headings, alt, share card and its 1200×630 image, canonical, robots.txt for search and AI crawlers, sitemap, JSON-LD, question headings with short answers, server-rendered text.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "A public URL, such as https://example.com",
      "type": "string",
      "maxLength": 2048
    },
    "html": {
      "description": "Raw HTML, when there is no file or URL",
      "type": "string",
      "maxLength": 2000000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

JSON-LD for the page built only from facts on it: the entity (Organization, LocalBusiness subtypes, Person, Product, SoftwareApplication) with name, url, description, image, phone, email, address, sameAs; and FAQPage from its own questions. Lists the fields it could not find. Never invents ratings, reviews, or prices.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "A public URL, such as https://example.com",
      "type": "string",
      "maxLength": 2048
    },
    "html": {
      "description": "Raw HTML, when there is no file or URL",
      "type": "string",
      "maxLength": 2000000
    },
    "type": {
      "description": "schema.org type, such as Restaurant, Dentist, Person, SoftwareApplication. Default Organization",
      "type": "string"
    },
    "name": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}