| Tool | Version | Role | Constraints |
|---|---|---|---|
| MkDocs | >=1.6.0 | Static site generator | — |
| mkdocs-material | 9.7.6 | MkDocs theme (Material Design) | — |
| Tool | Version | Role | Constraints |
|---|---|---|---|
| Docker / OrbStack | — | Run MkDocs in a container | On macOS, OrbStack is preferred over Docker Desktop (lighter and easier to use) |
| uv | — | Python package manager | Never use pip install directly |
| make | — | Task runner (sync / serve / build / clean) |
— |
| Tool | Version | Role | Constraints |
|---|---|---|---|
| Claude Code | — | AI coding assistant | Project rules defined in .claude/rules/ |
| RTK | 0.37.2 | CLI proxy that rewrites Bash commands to reduce token usage | Runs automatically via PreToolUse hook in ~/.claude/settings.json. Call rtk directly only for meta commands (e.g. rtk gain) |
| Tool | Version | Role | Constraints |
|---|---|---|---|
| lychee | 0.x (via lychee-action) | Automated link validation (GitHub Actions) | Configuration in lychee.toml (domain patterns) and .lycheeignore (individual URLs). Does NOT support inline HTML comments (<!-- markdown-link-check-disable -->). See .claude/rules/link-checking.md for strategy. Weekly scheduled scan + PR checks. |
| lychee-action | v2.8.0 | GitHub Actions integration for lychee | Used in .github/workflows/ for link checking |