Client Workspace Recipe

Use client-workspace when a delivery team needs a private, evidence-backed workspace for client projects and repo investigations.

Generate

node generator/create-index.mjs \
  --name "Acme Delivery Index" \
  --slug acme-delivery-index \
  --output ./acme-delivery-index \
  --profile client-workspace \
  --owner "Baker Street Delivery" \
  --services github,slack,notion,linear \
  --skip-install

What Gets Generated

• docs/ for client-facing and team-facing working context.
• repos/index.yaml for client repositories and source systems.
• workspaces/ records for client, project, repository, vendor, contact, communication, opportunity, and next-action context.
• docs/automation-runbooks.md and .codex/automations/ for repeatable delivery operations.
• evals/ smoke tests for prompt, retrieval, and output-format changes.

First Validation

cd acme-delivery-index
npm install
npm run docs:build
npm run validate:workspaces

Next Steps

• Record the client owner, delivery owner, key stakeholders, and active repositories.
• Add links to signed-off docs and current source systems.
• Keep opportunity and next-action records current enough for weekly handoff.
• Add eval fixtures before changing agent prompts or retrieval behavior.

See Validation for the check set.