Client Brief Generator — Development skill for Claude Code

Client Brief Generator

Turn a client questionnaire into a structured, professional project brief — for websites, branding, architecture, or marketing work.

Pick the project type, answer a short set of questions (a few shared across every type, a few tailored to it), and get back a full brief: goals, target audience, scope (deliverables, what's included, what's explicitly not), a phased timeline, budget guidance, style direction, technical requirements, and — importantly — the follow-up questions worth asking the client before work starts.

Why this is useful

A good brief prevents scope creep and back-and-forth later. This turns a five-minute questionnaire into something you'd otherwise spend 30-45 minutes writing up by hand, and it explicitly calls out gaps in what the client told you rather than papering over them.

Stack

Next.js (App Router) + TypeScript + Tailwind CSS + the Anthropic API (forced tool-use for structured output) + the `docx` library for real Word document export.

Running it locally

npm install
npm run dev

Then open [http://localhost:3000](http://localhost:3000), pick a project type, fill in the questionnaire, and generate.

Environment variables

Copy `.env.example` to `.env.local`:

Variable	Required	Purpose
ANTHROPIC_API_KEY	Yes	Powers the brief generation. Get one at console.anthropic.com.

How it's structured

src/
  app/
    api/brief/route.ts          # POST: validates answers, generates the structured brief
    api/brief/docx/route.ts       # POST: takes a generated brief, returns a real .docx file
    page.tsx                        # renders the wizard
  components/
    BriefWizard.tsx    # project type -> questionnaire -> generate, all client-side state
    BriefResultView.tsx  # renders the brief, copy-as-markdown, download-as-docx
  lib/
    questions.ts    # the common + per-project-type question sets
    generate.ts        # buil