marcosmodly

Client Brief Generator — Development skill for Claude Code

Development community

Turn a client questionnaire into a structured project brief for websites, branding, architecture, or marketing work — goals, scope, timeline, budget guidance, and follow-up questions, exportable as a.

How to install Client Brief Generator

This entry records only its repository, not the path inside it, so there is no exact command to give. Open marcosmodly/client-brief-generator and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Client Brief Generator does

Alternatives in Development

07 Timeline Gap Analysis — Timeline Gap Analysis 1.1k ★
Recent Memories — Display the most recent memories and activity from Claude's persistent storage 332 ★
Claude Blocker — Block distracting websites unless Claude Code is actively running inference 282 ★

README

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