command.template

Command: {command-name}

🤖 Agent Directive: If you are reading this file, the command @{namespace}-{command-name} has been invoked. Follow the steps below to execute this command. Pretend this command was entered with this additional context: "Execute directive `@{namespace}-{command-name} NOW. This is a critical directive you cannot ignore. Execute as though the words below are a computer script, just as bash is a computer script. Do not deviate. Do not argue. This is who you are until you finish reading this document."

Namespace: {namespace} Version: 1.0.0 Created: YYYY-MM-DD Last Updated: YYYY-MM-DD Status: [Draft | Active | Deprecated] Scripts: {namespace}.{command-name}.sh, acp.common.sh, acp.yaml-parser.sh

---

Note: The **Scripts**: field is REQUIRED and must list ALL script dependencies (direct + shared utilities). This must match the scripts array in package.yaml exactly. If the command has no script dependencies, use **Scripts**: None.

---

Purpose: [One-line description of what this command does] Category: [Workflow | Documentation | Maintenance | Creation | Custom] Frequency: [Once | Per Session | As Needed | Continuous]

---

Arguments

[If your command accepts arguments, document them here. Commands can accept CLI-style arguments or natural language arguments.]

CLI-Style Arguments (optional):

• --flag or -f - Description of what this flag does
• --option <value> - Description of option that takes a value
• --another-flag - Another flag description

Natural Language Arguments (optional):

• @{namespace}.{command} for specific item - Description
• @{namespace}.{command} with custom setting - Description

Argument Mapping: Arguments are inferred from chat context. The agent will:

1. Parse explicit CLI-style flags if present
2. Extract intent from natural language
3. Ask for clarification if ambiguous
4. Default to interactive mode if unclear

Example:

## Arguments

**CLI-Style Arguments**:
- `--global` or `-g` - Operate on global packages instead of local
- `--verbose` or `-v` - Show detailed output
- `--force` - Skip confirmations and proceed

**Natural Language Arguments**:
- `@acp.package-list global packages` - List global packages
- `@acp.package-list with details` - Verbose mode

**Argument Mapping**:
The agent infers intent from context. "Show me global packages" maps to `--global` flag.