// 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.
| 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)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".