docs: add docs for docs site

Author: jtieri

docs/commands/completion.md

@@ -0,0 +1,47 @@
+# mold completion
+
+Generate shell completion scripts.
+
+## Usage
+
+```sh
+mold completion <shell>
+```
+
+## Supported shells
+
+### Bash
+
+Add to `~/.bashrc`:
+
+```sh
+eval "$(mold completion bash)"
+```
+
+Then restart your shell or run `source ~/.bashrc`.
+
+### Zsh
+
+Add to `~/.zshrc`:
+
+```sh
+eval "$(mold completion zsh)"
+```
+
+Then restart your shell or run `source ~/.zshrc`.
+
+### Fish
+
+```sh
+mold completion fish > ~/.config/fish/completions/mold.fish
+```
+
+Then restart your shell or start a new session.
+
+## What gets completed
+
+Shell completions work for:
+
+- All commands and subcommands
+- Flag names (`--stack`, `--tools`, `--kit`, etc.)
+- Flag values (kit names, stack names, tool names)

docs/commands/config.md

@@ -0,0 +1,100 @@
+# mold config
+
+Manage mold's global configuration.
+
+## Usage
+
+```sh
+mold config <subcommand> [args]
+```
+
+## Subcommands
+
+### `config set`
+
+Set a configuration value.
+
+```sh
+mold config set <key> <value>
+```
+
+### `config get`
+
+Read a single configuration value.
+
+```sh
+mold config get <key>
+```
+
+### `config list`
+
+Show all configuration values.
+
+```sh
+mold config list
+```
+
+### `config reset`
+
+Restore all settings to defaults.
+
+```sh
+mold config reset
+```
+
+## Valid keys
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `default_kit` | `original` | Kit used when `--beads`/`--kit` is not passed |
+| `default_stack` | `bare` | Stack used when `--stack` is not passed |
+| `author` | (empty) | Author name injected into templates |
+| `git_init` | `true` | Whether `mold new` runs `git init` |
+| `tools` | `claude` | Comma-separated default AI tools |
+
+## Examples
+
+Set your default stack and tools:
+
+```sh
+mold config set default-stack go
+mold config set tools claude,cursor,aider
+```
+
+Check the current default kit:
+
+```sh
+mold config get default-kit
+```
+
+```
+original
+```
+
+List all settings:
+
+```sh
+mold config list
+```
+
+```
+default_kit     = original
+default_stack   = bare
+author          =
+git_init        = true
+tools           = claude
+```
+
+Reset everything:
+
+```sh
+mold config reset
+```
+
+## Config file location
+
+Configuration is stored at `~/.config/mold/config.toml`. The file is created automatically on first use.
+
+## See also
+
+- [Configuration](../configuration.md) -- full config file reference

docs/commands/doctor.md

@@ -0,0 +1,49 @@
+# mold doctor
+
+Check the health of an AI project setup.
+
+## Usage
+
+```sh
+mold doctor
+```
+
+## Description
+
+Inspects the current directory and verifies that AI project configuration is correct. Checks for required files, valid JSON, git initialization, and tool-specific configuration.
+
+## Example
+
+```sh
+cd my-app
+mold doctor
+```
+
+```
+Checking project health...
+
+  [OK] CLAUDE.md exists
+  [OK] .claude/settings.json exists and is valid JSON
+  [OK] .git directory found
+  [OK] .gitignore exists
+
+Summary: 4 passed, 0 warnings, 0 errors
+```
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | All checks passed |
+| `1` | One or more checks failed |
+
+## What it checks
+
+- `CLAUDE.md` exists
+- `.claude/settings.json` exists and contains valid JSON
+- `.git` directory is present
+- `.gitignore` exists
+
+## See also
+
+- [mold upgrade](upgrade.md) -- update kit files to the latest version

docs/commands/init.md

@@ -0,0 +1,60 @@
+# mold init
+
+Add AI config to an existing project.
+
+## Usage
+
+```sh
+mold init [flags]
+```
+
+## Description
+
+Adds kit files (CLAUDE.md, settings.json, etc.) to the current working directory. Unlike `mold new`, this command does not create a new directory, initialize git, or create an initial commit.
+
+## Flags
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--beads` | `false` | Use the Beads kit |
+| `--stack <name>` | `bare` | Tech stack template (`go`, `rust`, `next`, `bare`) |
+| `--tools <list>` | `claude` | Comma-separated AI tools, or `all` |
+| `--force` | `false` | Overwrite existing config files |
+| `--dry-run` | `false` | Preview without writing files |
+
+## Examples
+
+Add Original kit to current directory:
+
+```sh
+mold init
+```
+
+Add Beads kit with extra AI tool files:
+
+```sh
+mold init --beads --tools copilot,gemini
+```
+
+Overwrite existing config files:
+
+```sh
+mold init --force
+```
+
+Preview changes:
+
+```sh
+mold init --dry-run
+```
+
+## Behavior
+
+1. Scans the current directory for conflicting files
+2. If conflicts exist and `--force` is not set, lists them and exits
+3. Renders kit, stack, and tool template files into the current directory
+4. Does **not** run `git init` or create commits
+
+## See also
+
+- [mold new](new.md) -- create a brand new project

docs/commands/kit.md

@@ -0,0 +1,111 @@
+# mold kit
+
+Manage project scaffolding kits.
+
+## Usage
+
+```sh
+mold kit <subcommand> [args]
+```
+
+## Subcommands
+
+### `kit list`
+
+List all available kits (built-in and custom).
+
+```sh
+mold kit list
+```
+
+```
+Available kits:
+  beads     Git-backed issue tracking via bd CLI
+  original  Standard Claude Code workflow (default)
+```
+
+### `kit info`
+
+Show detailed information about a kit, including all files it generates.
+
+```sh
+mold kit info <name>
+```
+
+```sh
+mold kit info original
+```
+
+```
+Kit: original
+Description: Standard Claude Code workflow
+
+Files:
+  CLAUDE.md
+  .claude/settings.json
+  docs/TODO.md
+  .repomixignore
+  repomix.config.json
+  .claude/commands/review.md
+  .claude/commands/test.md
+  .claude/commands/doc.md
+  .claude/commands/refactor.md
+```
+
+### `kit add`
+
+Register a custom kit from a local directory.
+
+```sh
+mold kit add <path>
+```
+
+The directory must contain a `kit.toml` file:
+
+```toml
+name = "my-kit"
+description = "My custom project template"
+```
+
+### `kit remove`
+
+Unregister a custom kit.
+
+```sh
+mold kit remove <name>
+```
+
+## Custom kits
+
+Custom kits let you define your own project templates. Create a directory with:
+
+1. A `kit.toml` metadata file (required)
+2. Template files that will be rendered into new projects
+
+Register it:
+
+```sh
+mold kit add ~/my-kits/react-kit
+```
+
+Use it:
+
+```sh
+mold new my-app --kit react-kit
+```
+
+Set it as default:
+
+```sh
+mold config set default-kit react-kit
+```
+
+Remove it:
+
+```sh
+mold kit remove react-kit
+```
+
+## See also
+
+- [Kits](../concepts/kits.md) -- what kits are and how they work