contribute-a-command

General Guidelines

Output Style

• Never explicitly mention TDD in code, comments, commits, PRs, or issues
• Write natural, descriptive code without meta-commentary about the development process
• The code should speak for itself - TDD is the process, not the product

Beads is available for task tracking. Use mcp__beads__* tools to manage issues (the user interacts via bd commands).

Plan File Restriction

NEVER create, read, or update plan.md files. Claude Code's internal planning files are disabled for this project. Use other methods to track implementation progress (e.g., comments, todo lists, or external tools).

Create a new custom command in src/sources/ following the patterns below. Assess the structure carefully using the below info but also researching the repo.

User arguments:

Contribute-a-command: $ARGUMENTS

End of user arguments

File Structure

Create src/sources/<command-name>.md with:

1. Frontmatter (required fields below)
2. INCLUDE directives for shared content

• We always include the docs INCLUDE path='src/fragments/universal-guidelines.md' fragment

1. Command-specific content
2. Exactly ONE [DOLLAR]ARGUMENTS placeholder

After creating, run pnpm build and pnpm vitest run -u to update snapshots.

Frontmatter Template

---
description: Brief description for /help
argument-hint: [optional-arg] or <required-arg> or (no arguments - interactive)
_hint: Short 2-3 word hint
_category: Test-Driven Development | Planning | Workflow | Ship / Show / Ask | Utilities | [Something else]
_order: 1-99
---

Optional: _requested-tools (array), _selectedByDefault: false

Category Patterns

Test-Driven Development (spike, red, green, refactor, cycle)

**User arguments:**

[CommandName]: [DOLLAR]ARGUMENTS

**End of user arguments**

[PHASE] PHASE! Apply the below to the user input above.

< !-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
< !-- /docs -->

< !-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
< !-- /docs -->

< !-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
< !-- /docs -->

< !-- docs INCLUDE path='src/fragments/tdd-fundamentals.md' -->
< !-- /docs -->