Skip to content

Commands

github-actions[bot] edited this page Apr 8, 2026 · 25 revisions

Commands

bluetemberg init [directory]

Interactive wizard that scaffolds AI tooling into a project.

Arguments:

  • directory — target directory (default: current directory)

What it does:

  1. Asks you to pick a team profile (sets smart defaults for all subsequent choices)
  2. Asks for project name, description, and package manager
  3. Asks you to pick platforms, rules, agents, skills, and MCP servers
  4. Creates llm/ directory with selected starter content
  5. Generates bluetemberg.config.json
  6. Creates AGENTS.md and CLAUDE.md (if Claude selected)
  7. Sets up MCP config files (if selected)
  8. Adds sync:llm-config scripts to package.json
  9. Patches .prettierignore with llm/ and docs/wiki/ to protect prose from formatters
  10. Runs an initial sync to generate all platform-specific files

Universal guardrail rules are always included and shown as non-deselectable in the rules step. See Profiles for what each team profile pre-checks.

Example:

npx @prototypdigital/bluetemberg init
npx @prototypdigital/bluetemberg init ./my-project

bluetemberg sync [directory]

Reads vendor-neutral sources from llm/ and generates platform-specific files.

Arguments:

  • directory — project root directory (default: current directory)

Options:

Option Description
--check Dry-run mode; exits with code 1 if any generated files are out of sync
--dry-run Alias for --check
--silent Suppress all output (useful in scripts and CI)

Example:

npx bluetemberg sync
npx bluetemberg sync --check
npx bluetemberg sync --dry-run --silent
npx bluetemberg sync ./my-project

When to run:

  • After creating or editing any file in llm/rules/, llm/agents/, or llm/skills/
  • In CI to verify generated files haven't drifted (use --check)

Package scripts

After running init, these scripts are added to your package.json:

Script Command
sync:llm-config npx bluetemberg sync
sync:llm-config:check npx bluetemberg sync --check

Clone this wiki locally