{"version":"2.1.183","anchor":"init-command-major-guided-setup-overhaul","canonical_anchor":"init-command-major-guided-setup-overhaul","heading":"\/init command \u2014 major guided-setup overhaul","tier":null,"area":null,"scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.183\/e\/init-command-major-guided-setup-overhaul","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.183","markdown":"### \/init command \u2014 major guided-setup overhaul\n\nThe `\/init` slash command has been significantly expanded. It now runs a structured 8-phase guided interview that covers far more than creating a CLAUDE.md.\n\n**Usage**\n\n`\/init` The new flow works as follows:\n\nPhase 0: Checks whether a CLAUDE.md already exists and branches accordingly \u2014 offering to review and improve it, leave it alone, or start fresh.\n\nPhase 1: Asks what to set up, with four options:\n\n- Project `CLAUDE.md` (team-shared, committed to source control)\n- Personal `CLAUDE.local.md` (private, gitignored)\n- Both project and personal files\n- \"Let Claude decide\" \u2014 fastest path, no follow-on questions\n\nA second question asks whether to also set up skills and\/or hooks.\n\nPhase 2: Launches a subagent to survey the codebase \u2014 manifest files, README, CI config, existing AI tool configs (`.cursor\/rules`, `.github\/copilot-instructions.md`, AGENTS.md, `.devin\/rules\/`, `.windsurf\/rules\/`, `.clinerules`), formatter config, and git worktree layout.\n\nPhase 3: Asks targeted follow-up questions about anything the code scan couldn't determine \u2014 non-standard commands, branch conventions, required env vars, testing quirks, or personal workflow preferences. Synthesizes a proposal listing exactly which files, skills, and hooks will be created, and asks for approval before proceeding.\n\nPhase 4: Writes the project `CLAUDE.md` using a strict \"would removing this cause Claude to make mistakes?\" test to keep it concise. Handles the \"review and improve\" path with diff proposals rather than silent overwrites. For large projects, suggests organizing into `.claude\/rules\/` subdirectory files.\n\nPhase 5: Writes `CLAUDE.local.md` for personal preferences (role, sandbox URLs, communication style). For repos using sibling\/external git worktrees, it writes the content to `~\/.claude\/<project-name>-instructions.md` and creates a one-line stub import in each worktree's `CLAUDE.local.md`.\n\nPhase 6: Creates skills from the proposal \u2014 both skills the user requested during the interview and additional suggestions that fit the codebase (reference knowledge, repeatable deploy or release workflows, etc.). Places each at `.claude\/skills\/<name>\/SKILL.md`. Distinguishes between skills that can be model-invoked vs. user-only skills with side effects (`disable-model-invocation: true`).\n\nPhase 7: Checks for GitHub CLI (`which gh`) and offers to explain its benefits if missing; checks for a lint config and offers to set one up if absent; wires up any requested hooks by calling the `update-config` skill for proper schema validation and live testing.\n\nPhase 8: Recaps all files written and suggests next steps, including relevant official plugins (frontend-design, playwright, skill-creator) based on what was found in the codebase.\n\n**Details**\n\n- The \"Review and improve\" path in Phase 0 skips the interview and goes straight to proposing specific diffs against the existing file.\n- The \"Leave it\" path in Phase 0 skips CLAUDE.md entirely and jumps to skills and hooks setup.\n- Q2 (skills\/hooks) is a hint rather than a hard filter \u2014 if no hook-shaped work exists, `\/init` says so and proposes better-fitting artifacts instead.\n- Hook target file defaults: project choice \u2192 `.claude\/settings.json`; personal choice \u2192 `.claude\/settings.local.json`. Only asks if the user picked \"both\".\n- Git pre-commit hooks are correctly distinguished from Claude Code `PostToolUse` hooks \u2014 if a user asks to \"gate before committing\", `\/init` routes that to a git hook or husky rather than silently creating a mismatched Claude Code hook.\n\n**Evidence**\n\nNew `qKp` string literal contains the full 8-phase guided setup instructions (search for `\"Phase 0: Check for an existing CLAUDE.md\"`). New `WKp` string literal contains the standalone CLAUDE.md creation instructions for non-interactive contexts (search for `\"Please analyze this codebase and create a CLAUDE.md file\"`)."}