agent: add make-command for interactive command scaffolding

[p-iknow]

Requirement

Resolves #11

Create a /make-command slash command to scaffold new Claude Code commands following the official guide. The command should help users create properly structured command files with correct frontmatter, tool permissions, and workflow structure without requiring prior knowledge of the command structure.

Implementation

Interactive 4-Question Workflow:

• Created guided workflow with 4 key questions:
  • Q1: Command purpose (generates description)
  • Q2: Workflow steps (infers tools and structures workflow)
  • Q3: User input requirements (none/arguments/interactive)
  • Q4: External system interaction (determines tool permissions)

AI-Powered Generation:

• AI analyzes user responses to generate concise, action-oriented descriptions
• Smart tool inference from keywords:
  • "GitHub"/"gh"/"PR" → Bash(gh *:*)
  • "git"/"branch"/"commit" → Bash(git *:*)
  • "npm"/"package.json" → Bash(npm *:*), Read
  • "read"/"analyze"/"search" → Read, Grep, Glob
  • "create file"/"generate" → Write
  • "modify"/"update file" → Edit
• AI structures workflow from user's step descriptions
• Shows generated content (description, tools, workflow) to user for approval
• Supports iteration until user is satisfied

Command File Generation:

• Generates complete command file at .claude/commands/{command-name}.md
• Includes proper YAML frontmatter (description, argument-hint, allowed-tools)
• Creates structured sections: Usage, Workflow, Examples, Best Practices, References
• Adds inline comments about argument patterns and tool usage
• Includes quality guidelines for workflow and documentation

Comprehensive Documentation:

• 4 detailed examples showing different scenarios:
  1. Simple command (no arguments, hello-world)
  2. GitHub PR review with arguments
  3. npm dependency analyzer with iteration flow
  4. Fully interactive (no command name provided)
• Enhanced Best Practices section with:
  • Information gathering guidelines
  • AI inference patterns
  • Description generation rules
  • Tool selection best practices
  • Workflow generation guidelines

Files Added:

• .claude/commands/make-command.md (653 lines)

Test

• Command file structure validated (frontmatter, sections, examples)
• Interactive workflow documented with clear Q&A flow
• AI analysis section includes tool inference patterns
• 4 comprehensive examples cover different use cases
• Best practices include information gathering guidance
• References official Claude Code slash commands guide

Reference

• Official guide: https://docs.claude.com/en/docs/claude-code/slash-commands
• Existing commands for pattern reference: make-branch, make-commit, make-pr, make-task-issue, plan-issue

Human Check

🤖 Generated with Claude Code

• I reviewed it