Skip to content

Add Claude commands from shrinkage repo#4

Closed
tschm wants to merge 1 commit into
masterfrom
add-claude-commands
Closed

Add Claude commands from shrinkage repo#4
tschm wants to merge 1 commit into
masterfrom
add-claude-commands

Conversation

@tschm

@tschm tschm commented Jun 17, 2026

Copy link
Copy Markdown
Owner

Adds the three Claude slash commands from the shrinkage repo:

  • /rhiza_book
  • /rhiza_quality
  • /rhiza_update

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added new command guides for building the documentation site locally, running a code-quality check, and updating pinned project versions.
    • The new guides include step-by-step workflows, validation checks, and clear next steps for handling build or sync issues.
  • Documentation

    • Expanded the command reference with standardized instructions for local documentation builds, quality gates, and version updates.
    • Added guidance for reporting results and resolving conflicts during update workflows.

Copilot AI review requested due to automatic review settings June 17, 2026 12:27
@coderabbitai

coderabbitai Bot commented Jun 17, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3e6e52b3-8142-4cd6-b829-b326210b659b

📥 Commits

Reviewing files that changed from the base of the PR and between 5c69e67 and 1b17bd5.

📒 Files selected for processing (3)
  • .claude/commands/rhiza_book.md
  • .claude/commands/rhiza_quality.md
  • .claude/commands/rhiza_update.md

📝 Walkthrough

Walkthrough

Added three .claude/commands docs defining workflows for building the documentation book, running quality gates, and updating Rhiza pins. The docs specify make-based execution, version selection, sync/conflict handling, coverage/reporting expectations, and PR completion steps.

Changes

Rhiza command docs

Layer / File(s) Summary
Book build and serve
.claude/commands/rhiza_book.md
rhiza_book defines the book build target, _book/index.html verification, static server startup, OS-specific browser opening, and $ARGUMENTS overrides.
Quality gate procedure
.claude/commands/rhiza_quality.md
rhiza_quality defines the ordered make gate sequence, coverage handling, validation reporting, scoring scope, and final scorecard format.
Version selection and pin bump
.claude/commands/rhiza_update.md
rhiza_update defines template version selection, CLI pin checks, clean-tree and branch requirements, and updating the pinned refs.
Sync resolution and PR output
.claude/commands/rhiza_update.md
rhiza_update defines sync conflict handling, gate execution, workflow variable and secret checks, commit/push steps, and PR body requirements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A bunny hopped through docs so bright,
With make and books and gates in sight.
I twitch my nose at sync and pin,
Then open pages, grin a grin.
🐇✨

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-claude-commands

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds three Claude Code slash-command definitions under .claude/commands/ to help run Rhiza-related workflows (book build, quality assessment, and template sync/update) from within Claude Code.

Changes:

  • Introduce /rhiza_update workflow instructions for bumping .rhiza/template.yml, syncing, resolving conflicts, and verifying gates.
  • Introduce /rhiza_quality workflow instructions for running Rhiza quality gates and producing a scorecard.
  • Introduce /rhiza_book workflow instructions for building and serving the MkDocs/zensical book locally.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 7 comments.

File Description
.claude/commands/rhiza_update.md New slash command doc for updating/syncing the Rhiza template and validating gates.
.claude/commands/rhiza_quality.md New slash command doc for running quality gates and producing a scoped scorecard.
.claude/commands/rhiza_book.md New slash command doc for building and locally serving the documentation book.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +1 to +3
---
description: Update the pinned Rhiza version in .rhiza/template.yml, sync, resolve conflicts, and verify
---
Comment on lines +72 to +73
**Conflict-marked files.** Resolve by the ownership rule (see `CLAUDE.md` and the
`files:` block of `.rhiza/template.lock` for the authoritative managed-file list):
Comment on lines +75 to +80
- **Rhiza-managed files** (the `.github/workflows/*`, `Makefile`,
`.pre-commit-config.yaml`, `pytest.ini`, the `.rhiza/` engine, etc.): take the
**incoming/upstream** side — these are owned by the template and should match
it (`git checkout --theirs -- <file>` then `git add`).
- **Locally-owned or locally-hardened files** (notably `ruff.toml`, plus
`pyproject.toml`, `README.md`, `src/`, your `tests/`): **merge by hand** —
Comment on lines +1 to +3
---
description: Run the Rhiza code-quality gate and score the repo (lint, types, docs, deps, security, tests)
---
Comment on lines +56 to +60
**Scope the scorecard to locally-owned items — not what the mother repo (Rhiza)
owns.** This project syncs its dev infrastructure from `jebel-quant/rhiza`; see
`CLAUDE.md` for the authoritative split and the `files:` block of
`.rhiza/template.lock` for the machine-generated list of synced files. Score
only what this repo actually controls — `src/`, `tests/`, `pyproject.toml`,
Comment on lines +60 to +65
only what this repo actually controls — `src/`, `tests/`, `pyproject.toml`,
`README.md`, project-specific docs, `.rhiza/template.yml`, and any
locally-hardened config. Do **not** let Rhiza-managed files (the
`.github/workflows/*`, `Makefile`, `.pre-commit-config.yaml`, `pytest.ini`,
`ruff.toml`, the typecheck/mutation/fuzzing targets, etc.) drive the marks — a
gap there is fixed upstream in Rhiza, not here. If a relevant signal is
Comment on lines +27 to +31
for the built folder **in the background** so it does not block the session:

```
(cd _book && uv run python -m http.server 8000)
```
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tschm tschm force-pushed the add-claude-commands branch from 98f91f2 to 1b17bd5 Compare June 25, 2026 16:14
@tschm

tschm commented Jun 25, 2026

Copy link
Copy Markdown
Owner Author

Superseded by alihaskar#39, which targets the upstream repo.

@tschm tschm closed this Jun 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants