Pawbytes Creative Suites Setup

Overview

Installs and configures the Pawbytes Creative Suites module into a project. Module identity (name, code, version) comes from

./assets/module.yaml

. Collects user preferences and writes them to the Pawbytes ecosystem config:

• {project-root}/.pawbytes/config/config.yaml

  — shared project config: core settings at root plus a

  cra:

  section with module-specific values.

• {project-root}/.pawbytes/config/config.user.yaml

  — personal settings intended to be gitignored: API keys and any variable marked

  user_setting: true

  in

  ./assets/module.yaml

  . These values live exclusively here.

• {project-root}/.pawbytes/config/module-help.csv

  — registers module capabilities for the help system.

Both config scripts use an anti-zombie pattern — existing entries for this module are removed before writing fresh ones, so stale values never persist.

{project-root}

is a literal token in config values — never substitute it with an actual path. It signals to the consuming LLM that the value is relative to the project root, not the skill root.

On Activation

1. Read

   ./assets/module.yaml

   for module metadata and variable definitions (the

   code

   field

   cra

   is the module identifier)
2. Check if

   {project-root}/.pawbytes/config/config.yaml

   exists — if a

   cra:

   section is already present, inform the user this is an update
3. Check for existing config at

   {project-root}/_bmad/config.yaml

   (legacy BMad format). If found, inform the user that legacy config can be migrated to the new Pawbytes ecosystem format.

If the user provides arguments (e.g.

accept all defaults

,

--headless

, or inline values like

user name is Alice, fal key is abc123

), map any provided values to config keys, use defaults for the rest, and skip interactive prompting. Still display the full confirmation summary at the end.

Collect Configuration

Ask the user for values. Show defaults in brackets. Present all values together so the user can respond once with only the values they want to change (e.g. "change fal_key to abc123, rest are fine"). Never tell the user to "press enter" or "leave blank" — in a chat interface they must type something to respond.

Default priority (highest wins): existing config values >

./assets/module.yaml

defaults.

Core config (only if no core keys exist yet):

user_name

(default: user),

communication_language

and

document_output_language

(default: English — ask as a single language question, both keys get the same answer). Of these,

user_name

and

communication_language

are written exclusively to

config.user.yaml

.

Module config: Read each variable in

./assets/module.yaml

that has a

prompt

field. Ask using that prompt with its default value.

API Keys (stored in

config.user.yaml

, not committed):

• fal_key

  — Required for image/video generation

• elevenlabs_api_key

  — Optional, for AI voiceover

• pexels_api_key

  — Optional, for stock media research

Write Files

Write a temp JSON file with the collected answers structured as

{"core": {...}, "module": {...}}

. Then run the config merge script:

python3 ./scripts/merge-config.py --config-path "{project-root}/.pawbytes/config/config.yaml" --user-config-path "{project-root}/.pawbytes/config/config.user.yaml" --module-yaml ./assets/module.yaml --answers {temp-file}

Then register capabilities with the help CSV merge:

python3 ./scripts/merge-help-csv.py --target "{project-root}/.pawbytes/config/module-help.csv" --source ./assets/module-help.csv --module-code cra

Both scripts output JSON to stdout with results. If either exits non-zero, surface the error and stop.

Create Output Directories

After writing config, create any output directories that were configured. For filesystem operations, resolve the

{project-root}

token and create each path:

mkdir -p "{project-root}/.pawbytes/creative-suites"
mkdir -p "{project-root}/.pawbytes/creative-suites/brands"
mkdir -p "{project-root}/.pawbytes/creative-suites/knowledge"
mkdir -p "{project-root}/.pawbytes/creative-suites/daily"

Confirm

Use the script JSON output to display what was written — config values set, user settings written to

config.user.yaml

, help entries added, fresh install vs update. Then display the

greeting

from

./assets/module.yaml

.

Outcome

Once the user's

user_name

and

communication_language

are known, use them consistently for the remainder of the session: address the user by their configured name and communicate in their configured language.

File Structure After Setup

{project-root}/
  .pawbytes/
    config/
      config.yaml           # Shared config (committed)
      config.user.yaml      # User settings (gitignored)
      module-help.csv       # Capability registry
    creative-suites/
      index.md              # Agency memory index
      brands/               # Brand guidelines and assets
      knowledge/            # Research and references
      daily/                # Activity logs