docs(specification): reorder command synopsis to separate validation commands (#1552)
CI / build (push) Successful in 17s
CI / lint (push) Failing after 19s
CI / helm (push) Successful in 23s
CI / typecheck (push) Failing after 50s
CI / security (push) Failing after 50s
CI / coverage (push) Has been skipped
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Failing after 1m46s
CI / docker (push) Has been skipped
CI / quality (push) Successful in 3m43s
CI / benchmark-publish (push) Has been cancelled
CI / e2e_tests (push) Has been cancelled
CI / integration_tests (push) Has been cancelled
CI / status-check (push) Has been cancelled

Implements issue #1552. Reorders the command synopsis in the specification to logically group validation commands separately from regular commands for better clarity.

Co-authored-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
Co-committed-by: Jeffrey Phillips Freeman <the@jeffreyfreeman.me>
This commit was merged in pull request #1554.
This commit is contained in:
2026-04-02 21:30:26 +00:00
committed by Forgejo
parent 09be821a38
commit 71ce95fdf6
+5 -4
View File
@@ -229,10 +229,6 @@ The following standards are integrated into the architecture:
<span style="color: cyan; font-weight: 600;">agents</span> project unlink-resource [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;PROJECT&gt;</span> <span style="color: #66cc66;">&lt;RESOURCE_NAME&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> project list [(<span style="color: magenta;"><span style="color: cyan;">--namespace</span>|<span style="color: yellow;">-n</span></span>) NS] [<span style="color: #66cc66;">&lt;REGEX&gt;</span>]
<span style="color: cyan; font-weight: 600;">agents</span> project show <span style="color: #66cc66;">&lt;PROJECT&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> validation add (<span style="color: magenta;"><span style="color: cyan;">--config</span>|<span style="color: yellow;">-c</span></span>) <span style="color: #66cc66;">&lt;FILE&gt;</span> [<span style="color: cyan;">--update</span>]
<span style="color: cyan; font-weight: 600;">agents</span> validation attach [<span style="color: cyan;">--project</span> <span style="color: #66cc66;">&lt;PROJECT&gt;</span>|<span style="color: cyan;">--plan</span> <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span>]
<span style="color: #66cc66;">&lt;RESOURCE&gt;</span> <span style="color: #66cc66;">&lt;VALIDATION&gt;</span> [<span style="color: #66cc66;">&lt;ARGS&gt;</span>...]
<span style="color: cyan; font-weight: 600;">agents</span> validation detach [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;ATTACHMENT_ID&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> project delete [<span style="color: cyan;">--force</span>|<span style="color: yellow;">-f</span>] [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;NAME&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> project context set[<span style="color: cyan;">--view</span> (<span style="color: magenta;">strategize|execute|apply|default</span>)]
[<span style="color: cyan;">--include-resource</span> <span style="color: #66cc66;">&lt;INCLUDE_RESOURCE&gt;</span>]...
@@ -270,6 +266,11 @@ The following standards are integrated into the architecture:
[<span style="color: cyan;">--strategy</span> <span style="color: #66cc66;">&lt;STRATEGY&gt;</span>]...
<span style="color: #66cc66;">&lt;PROJECT&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> validation add (<span style="color: magenta;"><span style="color: cyan;">--config</span>|<span style="color: yellow;">-c</span></span>) <span style="color: #66cc66;">&lt;FILE&gt;</span> [<span style="color: cyan;">--update</span>]
<span style="color: cyan; font-weight: 600;">agents</span> validation attach [<span style="color: cyan;">--project</span> <span style="color: #66cc66;">&lt;PROJECT&gt;</span>|<span style="color: cyan;">--plan</span> <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span>]
<span style="color: #66cc66;">&lt;RESOURCE&gt;</span> <span style="color: #66cc66;">&lt;VALIDATION&gt;</span> [<span style="color: #66cc66;">&lt;ARGS&gt;</span>...]
<span style="color: cyan; font-weight: 600;">agents</span> validation detach [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;ATTACHMENT_ID&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> actor run [(<span style="color: magenta;"><span style="color: cyan;">--output</span>|<span style="color: yellow;">-o</span></span>) <span style="color: #66cc66;">&lt;OUTPUT_FILE&gt;</span>]
[<span style="color: yellow;">-v</span>...] [<span style="color: cyan;">--unsafe</span>|<span style="color: yellow;">-u</span>] [<span style="color: cyan;">--context</span> <span style="color: #66cc66;">&lt;CONTEXT_NAME&gt;</span>]
[<span style="color: cyan;">--context-dir</span> <span style="color: #66cc66;">&lt;CONTEXT_PATH&gt;</span>] [<span style="color: cyan;">--load-context</span> <span style="color: #66cc66;">&lt;LOAD_CONTEXT_NAME&gt;</span>]