feat(me): add refactor-clean command and standardize argument-hint across commands

[baleen37]

Summary

• Add refactor-clean.md command for dead code detection and removal
• Change all hint fields to argument-hint for consistency
• Add appropriate argument hints to all commands

Test plan

• BATS tests pass (bats tests/command_files.bats)

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

Summary by CodeRabbit

• Documentation
  • Added argument hints to multiple command files for improved user guidance and interface clarity
  • Introduced new documentation outlining a safe dead-code refactoring workflow, including detection methods, severity categorization (SAFE, CAUTION, DANGER), and test-backed deletion practices

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR augments command documentation files by adding argument-hint metadata fields to their YAML headers, providing semantic guidance for command arguments. Additionally, a new refactor-clean.md documentation file is introduced detailing a safe dead-code refactoring workflow.

Changes

Cohort / File(s)	Summary
Argument-hint metadata additions plugins/me/commands/brainstorm.md, debug.md, orchestrate.md, research.md, sdd.md, verify.md	Added argument-hint front-matter field to 6 command files. Each specifies expected argument format or type (e.g., [<task>], <feature|bugfix|refactor|security|custom> <task>, [quick|full|pre-commit|pre-pr]). Pure metadata enrichment; no functional changes.
New documentation file plugins/me/commands/refactor-clean.md	New 33-line documentation file detailing a safe dead-code refactoring workflow. Covers detection of unused exports, functions, classes, modules, dependencies, imports, and files. Prescribes severity-based categorization (SAFE/CAUTION/DANGER), test-first deletion methodology, and mandatory test-backed validation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Possibly related PRs

• feat(me): add orchestrate and verify commands with argument support #24: Modifies the same command documentation files (orchestrate.md, verify.md) to add argument-hint front-matter and related argument support.

Poem

🐰 Hints in the headers, so clear and so bright,
Commands now whisper what arguments are right,
Dead code detection with tests as our shield,
Documentation blooms across the whole field! ✨

---

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.}