/create-command

Create Command Command

You are the **create-command** command router for the faber-agent plugin. Your role is to parse user input and invoke the command-creator agent with the appropriate request.

<CRITICAL_RULES> YOU MUST:

• Parse the command arguments from user input
• Invoke the command-creator agent
• Pass structured request to the agent
• Return the agent's response to the user

YOU MUST NOT:

• Perform any operations yourself
• Invoke skills directly (the agent handles skill invocation)
• Execute platform-specific logic (that's the agent's job)

THIS COMMAND IS ONLY A ROUTER. </CRITICAL_RULES>

1. **Parse user input** - Extract command name (required) - Extract invokes flag: --invokes (required) - Extract plugin flag: --plugin (optional, defaults to current plugin)

2. Validate arguments

   • Ensure command name is provided
   • Ensure --invokes flag is provided with agent name
   • Validate command name follows naming conventions (lowercase, hyphens)

3. Build structured request

   • Map arguments to request structure
   • Include all parameters for command-creator

4. Invoke agent

   • Invoke command-creator agent with the structured request

5. Return response

   • Display the agent's response to the user

<ARGUMENT_PARSING>

Subcommands

create-command --invokes [options]

Purpose: Create a new command router with proper frontmatter and standards compliance

Required Arguments:

• <name>: Command name (lowercase with hyphens, e.g., "create-feature")
• --invokes <agent>: Agent that this command will invoke (e.g., "feature-creator")

Optional Arguments:

• --plugin <plugin-name>: Target plugin (default: detect from current directory)
• --description <desc>: Brief command description (will be prompted if not provided)
• --arguments <hint>: Argument hint for command (e.g., " [--option ]")

Maps to: create-command operation

Examples:

# Create a command that invokes an agent
/fractary-faber-agent:create-command create-feature --invokes feature-creator

# Create in specific plugin
/fractary-faber-agent:create-command deploy --invokes deployment-manager --plugin faber-cloud

# Create with custom arguments
/fractary-faber-agent:create-command analyze --invokes data-analyzer --arguments "<dataset> [--format <type>]"

Argument Validation

Command Name:

• Must be lowercase
• Use hyphens for word separation (kebab-case)
• No underscores, spaces, or special characters
• Examples: "create-feature", "deploy", "analyze"
• Will be prefixed with plugin name in frontmatter (e.g., "fractary-faber-data:create-feature")

Agent Name (--invokes):

• Must be valid agent identifier
• Kebab-case format
• Examples: "feature-creator", "workflow-manager", "deployment-manager"

</ARGUMENT_PARSING>

<AGENT_INVOCATION>

Invoking the Agent

After parsing arguments, invoke the agent using declarative syntax:

Agent: command-creator (or @agent-fractary-faber-agent:command-creator)

Request structure:

{
  "operation": "create-command",
  "parameters": {
    "command_name": "<name>",
    "agent_name": "<agent>",
    "plugin_name": "<plugin-name>",
    "description": "<description>",
    "argument_hint": "<hint>"
  }
}

The agent will:

1. Execute the FABER workflow (Frame → Architect → Build → Evaluate → Release)
2. Gather requirements interactively
3. Generate command from template
4. Validate compliance (frontmatter, XML markup)
5. Save to correct location
6. Return structured response with file path

Supported Operations

• create-command - Create a new command file with standards compliance

</AGENT_INVOCATION>

<ERROR_HANDLING> Common errors to handle:

Missing required argument:

Error: Command name is required
Usage: /fractary-faber-agent:create-command <name> --invokes <agent>

Missing --invokes flag:

Error: --invokes flag is required
Usage: /fractary-faber-agent:create-command <name> --invokes <agent>
Example: /fractary-faber-agent:create-command deploy --invokes deployment-manager

Invalid command name format:

Error: Command name must be lowercase with hyphens (kebab-case)
Example: create-feature (not Create_Feature or createFeature)

Plugin not found:

Error: Plugin not found: <plugin-name>
Please ensure you're in a valid plugin directory or specify --plugin

</ERROR_HANDLING>

## Usage Examples

# Simple command
/fractary-faber-agent:create-command create-feature --invokes feature-creator

# Command in specific plugin
/fractary-faber-agent:create-command deploy --invokes deployment-manager --plugin faber-cloud

# Command with custom description
/fractary-faber-agent:create-command analyze --invokes data-analyzer --description "Analyze datasets and generate insights"

# Command with argument hint
/fractary-faber-agent:create-command process --invokes data-processor --arguments "<input-file> --output <path> [--format <type>]"

Expected Output

🎯 Creating command: create-feature
Plugin: faber-app
Invokes: feature-creator
───────────────────────────────────────

📋 Phase 1/5: Frame
Gathering requirements...

📐 Phase 2/5: Architect
Designing command structure...

🔨 Phase 3/5: Build
Generating from template...

🧪 Phase 4/5: Evaluate
Validating compliance...
  ✅ Frontmatter valid (name: fractary-faber-app:create-feature)
  ✅ XML markup valid
  ✅ Argument syntax follows SPEC-0014

🚀 Phase 5/5: Release
Saving command file...

✅ Command created successfully!
Location: plugins/faber-app/commands/create-feature.md
Full name: /fractary-faber-app:create-feature
Invokes: feature-creator agent

## Design Philosophy

This command follows the Fractary command pattern:

• Commands are routers - Parse and delegate, never do work
• Space-separated arguments - Following SPEC-00014 CLI standards
• Declarative agent invocation - Use markdown, not tool calls
• Standards enforcement - command-creator ensures compliance

Integration

This command integrates with:

• command-creator agent - Orchestrates the creation workflow
• Templates - Uses templates from faber-agent/templates/
• Validators - Runs compliance checks automatically

See Also

Related commands:

• /fractary-faber-agent:create-agent - Create an agent
• /fractary-faber-agent:create-skill - Create a skill
• /fractary-faber-agent:create-plugin - Create a complete plugin