// 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.
Universal explainer for codebases, specs, design docs, and markdown files. Activates when a user wants to understand how their code works, explore a new codebase, document an existing one, or get walked through any markdown artifact (specs, roadmaps, design docs, milestone plans). Trigger on: "explain this codebase", "walk me through this", "describe this code", "I'm new to this repo", "how does X work", "what calls this", "where does this get used", "explain this spec", "walk me through this roadmap", "what does this milestone mean", "explain this design doc", "--describe", "--explore", "--file <path>". Also triggers when user pastes code or a markdown file and asks questions about it — treat as a micro-artifact. Produces (written to {resolved_storage}/docs/{session_id}/): - SESSION-TRANSCRIPT.md (all modes — always generated) - CODEBASE.md (describe mode) - TOUR.md (explore mode) - FILE-NOTES.md (file mode)
Universal explainer for codebases, specs, design docs, and markdown files. Activates when a user wants to understand how their code works, explore a new codebase, document an existing one, or get walked through any markdown artifact (specs, roadmaps, design docs, milestone plans). Trigger on: "explain this codebase", "walk me through this", "describe this code", "I'm new to this repo", "how does X work", "what calls this", "where does this get used", "explain this spec", "walk me through this roadmap", "what does this milestone mean", "explain this design doc", "--describe", "--explore", "--file <path>". Also triggers when user pastes code or a markdown file and asks questions about it — treat as a micro-artifact. Produces (written to {resolved_storage}/docs/{session_id}/): - SESSION-TRANSCRIPT.md (all modes — always generated) - CODEBASE.md (describe mode) - TOUR.md (explore mode) - FILE-NOTES.md (file mode)
Synthesizes raw wizard session JSON into structured documentation. Use when the user runs /codebase-wizard-export, says "export session", "generate docs", "create CODEBASE.md", or "turn the session into docs".
| name | configuring-codebase-wizard |
| description | 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. |
| version | 1.0.0 |
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)