From codebase-wizard
One-time setup for the Codebase Wizard. Use when the user runs /codebase-wizard-setup, says "set up the wizard", "install wizard", or "configure codebase wizard". Installs Agent Rulez hooks, creates storage directories, writes config.json, and sets scoped write permissions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/codebase-wizard:configuring-codebase-wizardThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
One-time onboarding skill. Installs the Codebase Wizard infrastructure:
One-time onboarding skill. Installs the Codebase Wizard infrastructure: Agent Rulez hooks, storage directory, and scoped write permissions.
Run this once before the first /codebase-wizard session.
Ask the user to choose a storage location:
"Where should wizard sessions and docs be stored?"
.code-wizard/— top-level (visible in repo root).claude/code-wizard/— inside .claude/ (hidden from most tools)
Create the chosen directory with subdirectories:
{resolved_storage}/
sessions/
docs/
Save the resolved storage path so all other commands can find it:
{
"resolved_storage": "{chosen_path}"
}
Write to {resolved_storage}/config.json.
Run the setup script to install Agent Rulez and register the hook config:
bash scripts/setup.sh {runtime}
Where {runtime} is claude (default), opencode, gemini, codex, or all.
The script handles:
rulez install to ensure the hook runner is availablescripts/agent-rulez-sample.yaml to {resolved_storage}/agent-rulez.yaml
with {resolved_storage} substituted with the actual pathrulez hook add --config {resolved_storage}/agent-rulez.yamlsettings.local.json with scoped permissions for wizard storage dirsIf runtime is codex: prints manual export instructions and exits 77 (no hook
installation attempted — Codex does not support hooks).
After the script completes:
"Wizard configured. Storage at {resolved_storage}. Hooks registered." "Run /codebase-wizard to start your first session." "After any session, run /codebase-wizard-export to generate docs."
| File | Purpose |
|---|---|
{resolved_storage}/config.json | Storage path record for all wizard commands |
{resolved_storage}/agent-rulez.yaml | Deployed hook config for session capture |
.claude/settings.local.json | Scoped write permissions for wizard storage dirs |
scripts/setup.sh — platform-aware install script.
Usage: bash scripts/setup.sh [claude|opencode|gemini|codex|all]
claudeall: installs for claude, opencode, and gemini; skips codex (exit 77 caught)codex: prints manual export notice and exits 77 (not an error)npx claudepluginhub spillwavesolutions/codebase-mentor --plugin codebase-wizardInteractive wizard configures repositories for Claude Code best practices by creating CLAUDE.md, slash commands, agents, hooks, and permissions. Activates on 'setup claude', 'init claude', or repo setup requests.
Initializes project configuration by auto-detecting framework, replacing CLAUDE.md placeholders, and installing rules, hooks, and scripts.