refactor: condense rules — CLAUDE.md 300→41 lines

[shunkakinoki]

Slim down all rules to essential content only. Generated CLAUDE.md goes from ~11KB to ~1.4KB.

Changes

• commit-push.md: 60→11 lines — kept format + types, removed verbose examples
• ruler-apply.md: 27→10 lines — kept the two commands + when to run
• shell-usage.md: 23→8 lines — kept Fish conventions, removed boilerplate
• tool-search.md: 150→9 lines — kept tool one-liners, removed decision trees/examples
• workspace-file-references.md: 40→3 lines — one rule, one sentence

---

Summary by cubic

Condensed all rules to essential guidance to reduce reading time and shrink generated CLAUDE.md (≈300→41 lines; 11KB→1.4KB). Core commands and conventions remain.

• Refactors
  • commit-push: kept add/commit/push, inline commit types, pre-commit one-liner, concise rules.
  • ruler-apply: kept run sequence; run after rule edits/pulls; commit regenerated files with the change.
  • shell-usage: Fish by default with key patterns; removed boilerplate and compatibility notes.
  • tool-search: one-liners for fd/rg/ast-grep/fzf/jq/yq; prefer ast-grep for code patterns, rg for text.
  • workspace-file-references: single rule—don’t reference ../dotagents; use ".".

^{Written for commit e418266. Summary will update on new commits.}

[coderabbitai]

Warning

Rate limit exceeded

@shunkakinoki has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 8 minutes and 51 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch refactor/condense-rules

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cubic-dev-ai]

No issues found across 5 files

[Copilot]

Pull request overview

This PR reduces the size of the repo’s agent/rules documentation by condensing several rules/*.md files down to minimal “essential” guidance, intended to shrink generated instruction output (e.g., CLAUDE.md) substantially.

Changes:

• Condenses commit/push workflow guidance to a short command block + a few bullets.
• Condenses Ruler regeneration instructions to a minimal “when + commands + commit outputs” note.
• Condenses tool-search and shell-usage guidance to short, high-signal summaries; trims workspace file reference rule to a single sentence.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
rules/workspace-file-references.md	Replaces long rationale/examples with a single directive about not referencing ../dotagents.
rules/tool-search.md	Replaces detailed decision tree/examples with a short tool list and one-line guidance.
rules/shell-usage.md	Condenses Fish conventions to a short checklist.
rules/ruler-apply.md	Condenses “when to run + commands” for regenerating instruction outputs.
rules/commit-push.md	Condenses conventional commit + push workflow guidance to a minimal snippet and bullets.

---

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

[Copilot]

The command examples use pnpm run ..., but this repo is configured with packageManager: bun@... and scripts are intended to be run via the active package manager. Consider switching these lines to bun run ... or using the $PM run ... convention used elsewhere, so the instructions work in a fresh checkout without pnpm installed.

[Copilot]

The fenced block is labeled bash, but the commands shown are shell-agnostic and this repo’s shell rule states Fish is the default. Consider using a neutral fence language like sh (or omit the language) to avoid implying Bash-only syntax.

Suggested change

	```bash
	```sh

[Copilot]

The inline commit type list (feat|fix|docs|refactor|chore|perf|test) appears to omit types that are documented/validated elsewhere in the repo (e.g., /commit-lint includes style, ci, build, revert). To avoid implying those types are invalid, either expand this list or rephrase it as non-exhaustive (e.g., “common types”).

Suggested change

	git commit -m "type: description" # feat|fix|docs|refactor|chore|perf|test
	git commit -m "type: description" # common types: feat|fix|docs|style|refactor|chore|perf|test|ci|build|revert

[Copilot]

This repo doesn’t appear to contain any .ts/.tsx files, but the examples and ast-grep --lang ts guidance are TypeScript-specific. Consider making the examples language-agnostic (e.g., fd '*.md') and using a placeholder like --lang <lang> so the guidance fits the actual repo contents.

Suggested change

	- **Files**: `fd` — `fd '*.ts'`, `fd config.json`
	- **Text**: `rg` — `rg "pattern" -A 3`, `rg -i "todo"`
	- **Code structure**: `ast-grep --lang ts -p 'function $NAME($ARGS) { $$$ }'`
	- **Interactive**: `fzf` — `fd '*.ts' | fzf`
	- **Files**: `fd` — `fd '*.md'`, `fd config.json`
	- **Text**: `rg` — `rg "pattern" -A 3`, `rg -i "todo"`
	- **Code structure**: `ast-grep --lang <lang> -p 'function $NAME($ARGS) { $$$ }'`
	- **Interactive**: `fzf` — `fd '*.md' | fzf`