client-workspace-scaffolder git:20260710.88e305cA

Immutable. This exact content never changes and is served at /api/v1/blob/24532fa4f8c54fdb.

---
name: client-workspace-scaffolder
description: Scaffold a complete client project folder from your own reusable structure template, with a filled-in brief file and feedback log. Never overwrites existing work. Use when the user says "new client", "set up a client folder", "onboard this client", or "create a project workspace for".
---

# Client Workspace Scaffolder

Every client engagement starts with the same folder dance. This skill does it once, correctly, from a structure you define one time and reuse forever.

## Step 0: Load the workspace template (once)

Look for a `client-workspace.template.md` file in the project root. If it does not exist, ask the user how they structure a client project, then offer to save the answers. The template defines:

```
CLIENTS_ROOT    The parent folder where client folders live
FOLDERS         The subfolders every client gets, e.g. Assets, Context, Strategy, Website
BRIEF_TEMPLATE  The markdown skeleton for the brief file (status, scope checklist, references, billing section)
EXTRA_FILES     Other starter files, e.g. Feedback.md with a feedback-round table
```

A sensible default when the user has no opinion yet:

```
CLIENTS_ROOT: ./Clients
FOLDERS: 01_Assets, 02_Context, Strategy
BRIEF_TEMPLATE: title, Status (Active/Completed/On hold), Started date,
  Brief paragraph, Scope checklist, References, Files note, Billing section
EXTRA_FILES: Feedback.md with a Date/Round/Notes table
```

## Step 1: Collect the essentials

From the user's message: client name (required) and project scope. Anything else they volunteer (industry, contact, deadline) goes into the brief. Ask at most one short round of questions.

## Step 2: Check for collisions

List CLIENTS_ROOT first. If a folder with the same or a very similar name exists, stop and ask whether to use it or create a variant. Never overwrite an existing client folder or brief.

## Step 3: Scaffold

Create the folder tree from FOLDERS, write the brief from BRIEF_TEMPLATE with everything known filled in (status Active, started today, scope boxes ticked), and create EXTRA_FILES. Leave unknowns as visible placeholders rather than fabricated values. Empty folders are correct; do not create filler files inside them.

## Step 4: Report

Show the created tree and the brief contents. Mention the natural next step if the brief has gaps (a discovery conversation or intake questionnaire).

## Rules

- Never overwrite anything that exists.
- Never invent client details to fill template fields.
- No em dashes in any generated content.

## Output

A ready client folder under CLIENTS_ROOT with a filled brief, a feedback log, and the standard subfolders.