bsamiee [H1][COMMAND-BUILDER]
Dictum: Reusable prompt templates reduce repetition and enforce consistency.
Load commands from .claude/commands/ (project) or ~/.claude/commands/ (user). Filename becomes command name.
Tasks:
- Read workflow.md — 5-phase creation process
- Read variables.md — Argument capture, file references, skill loading
- Read hints.md — Argument-hint syntax, enum patterns
- (prose) Load
style-standardsskill — Voice, formatting, constraints - Execute per workflow — UNDERSTAND, ACQUIRE, RESEARCH, AUTHOR, VALIDATE
- Validate — Quality gate; see §VALIDATION
References:
| Domain | File |
|---|---|
| Workflow | workflow.md |
| Variables | variables.md |
| Hints | hints.md |
| Validation | validation.md |
| Template | command.template.md |
[1][FRONTMATTER]
Dictum: Declarative constraints gate command execution.
---
description: Brief description shown in /help menu
argument-hint: [required-arg] [optional-arg?]
allowed-tools: Read, Write, Edit, Glob, Grep, Task, Bash, TaskCreate
model: opus
---
| [INDEX] | [FIELD] | [TYPE] | [PURPOSE] | [SYNTAX] |
|---|---|---|---|---|
| [1] | description |
string | /help menu text |
Verb-first. <80 chars. Outcome-focused. |
| [2] | argument-hint |
string | Autocomplete guidance | [required] [optional?] [--flag]. |
| [3] | allowed-tools |
list | Scoped tool permissions | Comma-separated tool names. |
| [4] | model |
string | Override default model | Full model ID or alias. |
[IMPORTANT]:
- [ALWAYS] Use
---delimiters (three dashes, no spaces). - [ALWAYS] Quote strings containing
:,#,[,],{,}. - [NEVER] Use tabs; YAML requires spaces.
[CRITICAL]:
- [ALWAYS] Declare
Readfor every@pathreference. - [ALWAYS] Declare
Bashfor every!commandreference. - [NEVER] Omit required tools—command fails without output.
[2][MODELS]
Dictum: Model selection balances capability against cost and latency.
[CRITICAL] Session inherits default model. Override for specific capability requirements.
| [INDEX] | [ALIAS] | [STRENGTH] | [LATENCY] | [COST] |
|---|---|---|---|---|
| [1] | opus |
Complex reasoning | High | High |
| [2] | sonnet |
Balanced performance | Medium | Medium |
| [3] | haiku |
Fast, simple tasks | Low | Low |
| [INDEX] | [CHARACTERISTIC] | [OPUS] | [SONNET] | [HAIKU] |
|---|---|---|---|---|
| [1] | Multi-file scope | X | ||
| [2] | Architectural impact | X | ||
| [3] | Standard development | X | ||
| [4] | Speed priority | X | ||
| [5] | Deep analysis | X | X |
[3][VARIABLES]
Dictum: Dynamic substitution enables reusable commands.
| [INDEX] | [SYNTAX] | [CAPTURES] | [REQUIRED_TOOL] | [USE_WHEN] |
|---|---|---|---|---|
| [1] | $ARGUMENTS |
All args as string | None | Free-form input |
| [2] | $1, $2... |
Positional (1-based) | None | Structured multi-arg |
| [3] | $ARGUMENTS[N] |
Positional (0-based) | None | Indexed access |
| [4] | $N |
Shorthand for $ARGUMENTS[N] (0-based) |
None | Indexed shorthand |
| [5] | ${1:-val} |
Default if missing | None | Optional parameters |
| [6] | ${CLAUDE_SESSION_ID} |
Current session ID | None | Session-specific |
| [7] | @path |
Include file contents | Read |
File analysis |
| [8] | !`command` |
Shell preprocessing | Bash |
Dynamic context |
[CRITICAL]:
- [NEVER] Mix
$ARGUMENTSand positional$1-$Nin same command. - [ALWAYS] Declare required tools for
@pathand!command.
→references/variables.md: Complete reference—examples, skill loading, anti-patterns.
[4][PATTERNS]
Dictum: Canonical patterns accelerate development.
[4.1][FILE_ANALYSIS]
---
description: Analyze file for issues
argument-hint: [file-path]
allowed-tools: Read
---
## Target
@$1
## Task
Identify security, performance, and code quality issues.
[4.2][MULTI_FILE_OPERATION]
---
description: Process files matching pattern
argument-hint: [glob-pattern]
allowed-tools: Read, Edit, Glob, TaskCreate
---
## Task
Match files via $1. Analyze content. Apply fixes. Track progress via TaskCreate.
[4.3][AGENT_WORKFLOW]
---
description: Multi-agent analysis
argument-hint: [target-folder]
allowed-tools: Task, Read, Glob, TaskCreate
---
## Task
1. Match files in $1 via Glob
2. Spawn analysis agents via Task
3. Synthesize findings, track via TaskCreate
[4.4][SKILL_CONTEXT]
---
description: Validate target against skill standards
argument-hint: [target] [focus?]
allowed-tools: Read, Task, Glob, Edit, TaskCreate
---
## Skill Context
@.claude/skills/[skill-name]/SKILL.md
@.claude/skills/[skill-name]/references/[domain]/*.md
## Task
Load context above. Spawn Task agents. Verify findings against loaded context. Apply corrections.
→templates/command.template.md — canonical template.
[5][ORGANIZATION]
Dictum: Namespaces prevent command collision.
| [INDEX] | [SCOPE] | [LOCATION] | [USE_CASE] |
|---|---|---|---|
| [1] | Personal | ~/.claude/commands/ |
Individual workflows |
| [2] | Project | .claude/commands/ |
Shared team workflows |
| [INDEX] | [CONVENTION] | [PATTERN] | [EXAMPLE] |
|---|---|---|---|
| [1] | Verb-first | action-target |
create-component |
| [2] | Lowercase | No capitals | review-pr |
| [3] | Hyphen-separated | No underscores | run-tests |
| [4] | Descriptive | Clear purpose | analyze-coverage |
.claude/commands/
├── git/
│ ├── commit.md -> /git:commit
│ └── pr.md -> /git:pr
└── test/
└── unit.md -> /test:unit
[6][VALIDATION]
Dictum: Validation gates prevent incomplete artifacts.
[VERIFY] Completion:
- Workflow: All 5 phases executed (UNDERSTAND → VALIDATE).
- Frontmatter: Valid YAML, description present, tools declared.
- Variables: No
$ARGUMENTS+ positional mixing. - Tools: All
@pathhaveRead, all!commandhaveBash. - Quality: LOC < 125, verb-first naming.
[REFERENCE] Operational checklist: →validation.md