From 48cdcb6ea7e6eb1978522e1882a631ae85f4cec1 Mon Sep 17 00:00:00 2001 From: Jeffrey Phillips Freeman Date: Thu, 2 Apr 2026 22:00:58 +0000 Subject: [PATCH] docs(spec): remove optional parentheses from required --config flags in command synopsis (#1573) Co-authored-by: Jeffrey Phillips Freeman Co-committed-by: Jeffrey Phillips Freeman --- docs/specification.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/specification.md b/docs/specification.md index 5bc89bc55..684b8707d 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -266,7 +266,7 @@ The following standards are integrated into the architecture: [--strategy <STRATEGY>]... <PROJECT> -agents validation add (--config|-c) <FILE> [--update] +agents validation add --config|-c <FILE> [--update] agents validation attach [--project <PROJECT>|--plan <PLAN_ID>] <RESOURCE> <VALIDATION> [<ARGS>...] agents validation detach [--yes|-y] <ATTACHMENT_ID> @@ -276,7 +276,7 @@ The following standards are integrated into the architecture: [--context-dir <CONTEXT_PATH>] [--load-context <LOAD_CONTEXT_NAME>] [(--temperature|-t) <TEMP>] [--allow-rxpy-in-run-mode] [--skill <SKILL>]... <NAME> <PROMPT> -agents actor add (--config|-c) <FILE> [--update] +agents actor add --config|-c <FILE> [--update] agents actor remove <NAME> agents actor list agents actor show <NAME> @@ -287,24 +287,24 @@ The following standards are integrated into the architecture: agents actor context import [--update] (--input|-i) <FILE> [<NAME>] agents actor context clear [--yes|-y] (--all|-a|<NAME>) -agents skill add (--config|-c) <FILE> [--update] +agents skill add --config|-c <FILE> [--update] agents skill remove [--yes|-y] <NAME> agents skill list [(--namespace|-n) <NS>] [--source <SOURCE>] agents skill show <NAME> agents skill tools <NAME> -agents tool add (--config|-c) <FILE> [--update] +agents tool add --config|-c <FILE> [--update] agents tool remove [--yes|-y] <NAME> agents tool list [(--namespace|-n) <NS>] [--source <SOURCE>] [--type (tool|validation)] [<REGEX>] agents tool show <NAME> -agents lsp add (--config|-c) <FILE> [--update] +agents lsp add --config|-c <FILE> [--update] agents lsp remove [--yes|-y] <NAME> agents lsp list [(--namespace|-n) <NS>] [--language <LANG>] agents lsp show <NAME> agents lsp serve [--log-level <LEVEL>] -agents resource type add (--config|-c) <FILE> [--update] +agents resource type add --config|-c <FILE> [--update] agents resource type remove [--yes|-y] <NAME> agents resource type list [<REGEX>] agents resource type show <NAME> @@ -345,12 +345,12 @@ The following standards are integrated into the architecture: agents plan prompt <PLAN_ID> <GUIDANCE> agents plan rollback [--yes|-y] <PLAN_ID> <CHECKPOINT_ID> -agents action create (--config|-c) <CFG_FILE> +agents action create --config|-c <CFG_FILE> agents action list [(--namespace|-n) <NS>] [(--state|-s) <STATE>] [<REGEX>] agents action show <ACTION_NAME> agents action archive <ACTION_NAME> -agents automation-profile add (--config|-c) <FILE> [--update] +agents automation-profile add --config|-c <FILE> [--update] agents automation-profile remove [--yes|-y] <NAME> agents automation-profile list [<REGEX>] agents automation-profile show <NAME> @@ -4936,7 +4936,7 @@ Saving actor output to a file: ##### agents actor add -
agents actor add (--config|-c) <FILE> [--update]
+
agents actor add --config|-c <FILE> [--update]
**Purpose** Add a new actor configuration, or replace an existing one with `--update`. The actor is fully defined by the YAML configuration file specified with `--config`. If a local actor with the same name already exists, the command fails unless the `--update` flag is provided, which replaces the existing actor. @@ -6359,7 +6359,7 @@ Clear all files from a context but keep the context itself. ##### agents skill add -
agents skill add (--config|-c) <FILE> [--update]
+
agents skill add --config|-c <FILE> [--update]
**Purpose** Register a new skill. The skill is fully defined by the YAML configuration file specified with `--config`. If a skill with the same name already exists, the command fails unless the `--update` flag is provided, which allows overwriting the existing registration with the new configuration. @@ -7544,7 +7544,7 @@ List all tools provided by a skill, including those inherited from included skil ##### agents tool add -
agents tool add (--config|-c) <FILE> [--update]
+
agents tool add --config|-c <FILE> [--update]
**Purpose** Register a new tool. The tool is fully defined by the YAML configuration file specified with `--config`. If a tool with the same name already exists, the command fails unless the `--update` flag is provided, which allows overwriting the existing registration with the new configuration. @@ -9279,7 +9279,7 @@ When multiple attachment scopes apply, the union of all applicable validations i ##### agents validation add -
agents validation add (--config|-c) <FILE> [--required | --informational] [--update]
+
agents validation add --config|-c <FILE> [--required | --informational] [--update]
**Purpose** Register a new validation. The validation is fully defined by the YAML configuration file specified with `--config`. The validation is registered in the shared Tool Registry under the name specified in the config file; the name must not conflict with any existing tool or validation. If a validation with the same name already exists, the command fails unless `--update` is provided. The validation YAML may use `wraps` to reference an existing Tool, reusing its implementation and interpreting its output through a `transform` function (see Tool Wrapping under Core Concepts > Validation). When `wraps` is used, the wrapped Tool must already be registered. @@ -9879,7 +9879,7 @@ Manage resource type definitions. Resource types are schema-level definitions th ##### agents resource type add -
agents resource type add (--config|-c) <FILE> [--update]
+
agents resource type add --config|-c <FILE> [--update]
**Purpose** Register a new custom resource type. The resource type is fully defined by the YAML configuration file specified with `--config`. @@ -16128,7 +16128,7 @@ Provide additional guidance to a plan, typically when it is errored or awaiting ##### agents action create -
agents action create (--config|-c) <CFG_FILE>
+
agents action create --config|-c <CFG_FILE>
**Purpose** Create a new action template from a YAML configuration file. The `--config` file is required and must fully define the action. @@ -16712,7 +16712,7 @@ Archive an action. ##### agents automation-profile add -
agents automation-profile add (--config|-c) <FILE> [--update]
+
agents automation-profile add --config|-c <FILE> [--update]
**Purpose** Register a new custom automation profile from a YAML configuration file. The profile is fully defined by the config file. If a profile with the same name already exists, the command fails unless the `--update` flag is provided.