Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 13 additions & 9 deletions .claude/README.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,24 @@
# `.claude/` — docs-kit engineering toolkit

Slash commands and rules that drive autonomous and semi-autonomous work on
docs-kit. `/lfg` runs the full loop; the others are focused specialists.
docs-kit. The full loop is `/lode:lfg`, from the `lode@zoolutions` plugin enabled
in `settings.json`; the commands below are the repo-specific specialists that
remain here. The plugin reads `../lode/workflow.md` for everything specific to
this repository.

## Commands

| Command | Tier | Purpose |
|---------|------|---------|
| `/plan` | `fable` | Read-only planning → a self-contained GitHub issue or `docs/plans/` markdown that `/lfg` executes |
| `/lfg` | `opus` | Full workflow: branch → understand → explore → plan → TDD → verify → PR |
| `/tdd` | `sonnet` | Enforce RED → GREEN → REFACTOR |
| `/architect` | `opus` | Coordinate a change across config → registry → components → client → generator → CSS |
| `/security` | `opus` | Security audit (HTML escaping, config trust, render path, generated files, deploy secrets) |
| `/review-pr` | `opus` | Review a PR for pattern compliance |
| `/github-review-pr` | `opus` | Full PR pass: CI failures first, then review comments |
| `/github-review-failures` | `sonnet` | Fix failing CI checks until green |
| `/github-review-comments` | `sonnet` | Process unresolved PR review comments |
| `/review-pr` | `opus` | Review a PR for docs-kit pattern compliance |

Retired in favour of the plugin: `/plan` → `/lode:plan`, `/lfg` → `/lode:lfg`,
`/tdd` → `/lode:tdd`, `/github-review-pr` → `/lode:review-pr`,
`/github-review-failures` and `/github-review-comments` → phases of
`/lode:review-pr`. Their repo-specific content — the conflict rules, the CI
quirks, the constraint tables — moved to `../lode/workflow.md`.

## Rules

Expand All @@ -24,6 +27,7 @@ docs-kit. `/lfg` runs the full loop; the others are focused specialists.
- `coding-style.md` — many small files, compose from `DocsUI::` components, read config, progressive enhancement
- `git-workflow.md` — conventional commits, branch naming, PR flow, `rake release`
- `testing.md` — the test layers (config / component render / generator), coverage bars
- `seo.md` — the SEO/OG meta-tag contract
- `agents.md` — when to delegate, parallel exploration, cheaper models for mechanical subagents

## Model-tier convention
Expand All @@ -42,7 +46,7 @@ argument-hint: "..."
- `haiku` — mechanical/config work, diff pattern-scans
- `sonnet` — layer specialists / pattern-following implementation (the default)
- `opus` — orchestration, security, PR/production review
- `fable` — read-only planning that hands execution to cheaper models (`/plan`); otherwise pick it per-session with `/model`
- `fable` — read-only planning that hands execution to cheaper models; otherwise pick it per-session with `/model`

Aliases track the latest model in each tier, so a pin never goes stale the way a
literal `claude-opus-4-8` does. When you author a new command, pick the tier by
Expand Down
237 changes: 0 additions & 237 deletions .claude/commands/github-review-comments.md

This file was deleted.

Loading
Loading