@jaimevalasek/aioson 1.18.0 → 1.19.0

package/template/.claude/commands/aioson/agent/committer.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Professional Git commit generation from changes and context"
----
-
-Read `.aioson/agents/committer.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Professional Git commit generation from changes and context"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@committer — Professional Git commit generation from changes and context
+Usage: /aioson:agent:committer [task description]
+Requires:
+  (none)
+Produces: git commit(s)
+Instruction file: .aioson/agents/committer.md
+CLI help: aioson agent:help committer
+
+Otherwise: Read `.aioson/agents/committer.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/copywriter.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Conversion-focused marketing copy"
----
-
-Read `.aioson/agents/copywriter.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Conversion-focused marketing copy"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@copywriter — Conversion-focused marketing copy
+Usage: /aioson:agent:copywriter [task description]
+Requires:
+  (none)
+Produces: marketing copy + content assets
+Instruction file: .aioson/agents/copywriter.md
+CLI help: aioson agent:help copywriter
+
+Otherwise: Read `.aioson/agents/copywriter.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/design-hybrid-forge.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Generate a hybrid design skill from two visual parents"
----
-
-Read `.aioson/agents/design-hybrid-forge.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Generate hybrid design skill from two visual parents"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@design-hybrid-forge — Generate hybrid design skill from two visual parents
+Usage: /aioson:agent:design-hybrid-forge [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: .aioson/installed-skills/{hybrid-slug}/SKILL.md + .aioson/installed-skills/{hybrid-slug}/references/ + .aioson/installed-skills/{hybrid-slug}/previews/ + .aioson/installed-skills/{hybrid-slug}/.skill-meta.json
+Instruction file: .aioson/agents/design-hybrid-forge.md
+CLI help: aioson agent:help design-hybrid-forge
+
+Otherwise: Read `.aioson/agents/design-hybrid-forge.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/dev.md

@@ -1,5 +1,18 @@
----
-description: "AIOSON — Feature implementation (any stack)"
----
-
-Read `.aioson/agents/dev.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Feature implementation (any stack)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@dev — Feature implementation (any stack)
+Usage: /aioson:agent:dev [task description]
+Requires:
+  .aioson/context/project.context.md
+  .aioson/context/discovery.md
+  .aioson/context/architecture.md
+Produces: code changes
+Instruction file: .aioson/agents/dev.md
+CLI help: aioson agent:help dev
+
+Otherwise: Read `.aioson/agents/dev.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/deyvin.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Pair programming partner (alias: pair)"
----
-
-Read `.aioson/agents/deyvin.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Pair programming partner for continuity sessions"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@deyvin — Pair programming partner for continuity sessions (aliases: pair)
+Usage: /aioson:agent:deyvin [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: small code changes + continuity notes in spec.md + runtime logs/tasks
+Instruction file: .aioson/agents/deyvin.md
+CLI help: aioson agent:help deyvin
+
+Otherwise: Read `.aioson/agents/deyvin.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/discover.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Semantic knowledge discovery: scan project and generate .aioson/context/bootstrap cache"
----
-
-Read `.aioson/agents/discover.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Semantic knowledge discovery and bootstrap cache generation"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@discover — Semantic knowledge discovery and bootstrap cache generation
+Usage: /aioson:agent:discover [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: .aioson/context/bootstrap/what-is.md + .aioson/context/bootstrap/how-it-works.md + .aioson/context/bootstrap/what-it-does.md + .aioson/context/bootstrap/current-state.md
+Instruction file: .aioson/agents/discover.md
+CLI help: aioson agent:help discover
+
+Otherwise: Read `.aioson/agents/discover.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/discovery-design-doc.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Discovery and design doc generation"
----
-
-Read `.aioson/agents/discovery-design-doc.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Discovery and design doc generation"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@discovery-design-doc — Discovery and design doc generation
+Usage: /aioson:agent:discovery-design-doc [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: .aioson/context/design-doc.md + .aioson/context/readiness.md
+Instruction file: .aioson/agents/discovery-design-doc.md
+CLI help: aioson agent:help discovery-design-doc
+
+Otherwise: Read `.aioson/agents/discovery-design-doc.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/genome.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Domain genome creation and application"
----
-
-Read `.aioson/agents/genome.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Domain genome creation and application"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@genome — Domain genome creation and application
+Usage: /aioson:agent:genome [task description]
+Requires:
+  (none)
+Produces: .aioson/genomes/[slug].md + .aioson/genomes/[slug].meta.json + optional binding in .aioson/squads/{slug}/squad.md or .aioson/squads/{slug}/squad.manifest.json
+Instruction file: .aioson/agents/genome.md
+CLI help: aioson agent:help genome
+
+Otherwise: Read `.aioson/agents/genome.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/neo.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — System router: see the full picture, get guided to the right agent"
----
-
-Read `.aioson/agents/neo.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — System router: see the full picture, get guided to the right agent"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@neo — System router: see the full picture, get guided to the right agent
+Usage: /aioson:agent:neo [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: routing decision + agent handoff
+Instruction file: .aioson/agents/neo.md
+CLI help: aioson agent:help neo
+
+Otherwise: Read `.aioson/agents/neo.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/orache.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Domain investigation and strategic research"
----
-
-Read `.aioson/agents/orache.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Domain investigation and strategic research"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@orache — Domain investigation and strategic research
+Usage: /aioson:agent:orache [task description]
+Requires:
+  (none)
+Produces: squad-searches/{squad-slug}/investigation-{date}.md or squad-searches/standalone/{domain-slug}-{date}.md
+Instruction file: .aioson/agents/orache.md
+CLI help: aioson agent:help orache
+
+Otherwise: Read `.aioson/agents/orache.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/orchestrator.md

@@ -1,5 +1,21 @@
----
-description: "AIOSON — Session protocol and parallel execution (MEDIUM)"
----
-
-Read `.aioson/agents/orchestrator.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Session protocol and parallel execution (MEDIUM)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@orchestrator — Session protocol and parallel execution (MEDIUM)
+Usage: /aioson:agent:orchestrator [task description]
+Requires:
+  .aioson/context/project.context.md
+  .aioson/context/discovery.md
+  .aioson/context/architecture.md
+  .aioson/context/prd.md or .aioson/context/prd-{slug}.md
+  .aioson/context/ui-spec.md (when present)
+  .aioson/context/implementation-plan.md or implementation-plan-{slug}.md (when present)
+Produces: .aioson/context/parallel/*.status.md
+Instruction file: .aioson/agents/orchestrator.md
+CLI help: aioson agent:help orchestrator
+
+Otherwise: Read `.aioson/agents/orchestrator.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/pair.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Pair programming partner (alias: deyvin)"
----
-
-Read `.aioson/agents/deyvin.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Pair programming partner (alias: deyvin)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@deyvin — Pair programming partner for continuity sessions (aliases: pair)
+Usage: /aioson:agent:pair [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: small code changes + continuity notes in spec.md + runtime logs/tasks
+Instruction file: .aioson/agents/deyvin.md
+CLI help: aioson agent:help pair
+
+Otherwise: Read `.aioson/agents/deyvin.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/pentester.md

@@ -1,5 +1,22 @@
----
-description: "AIOSON — Adversarial security review and threat-surface mapping"
----
-
-Read `.aioson/agents/pentester.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Adversarial security review and threat-surface mapping"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@pentester — Adversarial security review and threat-surface mapping
+Usage: /aioson:agent:pentester [task description]
+Requires:
+  .aioson/context/project.context.md
+  .aioson/context/spec-{slug}.md (active feature)
+Produces: .aioson/context/security-findings-{slug}.json
+
+Agent-specific options:
+  --mode=framework_target|app_target  Target mode for security review
+  --feature=<slug>  Feature slug (required for app_target)
+  --scope=<scope>  Target scope (required for app_target)
+Instruction file: .aioson/agents/pentester.md
+CLI help: aioson agent:help pentester
+
+Otherwise: Read `.aioson/agents/pentester.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/pm.md

@@ -1,5 +1,20 @@
----
-description: "AIOSON — Backlog and user stories (MEDIUM only)"
----
-
-Read `.aioson/agents/pm.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Backlog and user stories (MEDIUM only)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@pm — Backlog and user stories (MEDIUM only)
+Usage: /aioson:agent:pm [task description]
+Requires:
+  .aioson/context/project.context.md
+  .aioson/context/prd.md or .aioson/context/prd-{slug}.md
+  .aioson/context/discovery.md
+  .aioson/context/architecture.md
+  .aioson/context/ui-spec.md (when present)
+Produces: .aioson/context/prd.md or prd-{slug}.md (enriched with delivery plan and acceptance criteria)
+Instruction file: .aioson/agents/pm.md
+CLI help: aioson agent:help pm
+
+Otherwise: Read `.aioson/agents/pm.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/product.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Product vision, PRD and feature scoping"
----
-
-Read `.aioson/agents/product.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Product vision, PRD and feature scoping"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@product — Product vision, PRD and feature scoping
+Usage: /aioson:agent:product [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: .aioson/context/prd.md or .aioson/context/prd-{slug}.md (PRD base)
+Instruction file: .aioson/agents/product.md
+CLI help: aioson agent:help product
+
+Otherwise: Read `.aioson/agents/product.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/profiler-enricher.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Clone profiler: enrichment phase"
----
-
-Read `.aioson/agents/profiler-enricher.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Clone profiler: enrichment phase"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@profiler-enricher — Clone profiler: enrichment phase
+Usage: /aioson:agent:profiler-enricher [task description]
+Requires:
+  .aioson/profiler-reports/{person-slug}/research-report.md
+Produces: .aioson/profiler-reports/{person-slug}/enriched-profile.md
+Instruction file: .aioson/agents/profiler-enricher.md
+CLI help: aioson agent:help profiler-enricher
+
+Otherwise: Read `.aioson/agents/profiler-enricher.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/profiler-forge.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Clone profiler: forge and validate"
----
-
-Read `.aioson/agents/profiler-forge.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Clone profiler: forge and validate"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@profiler-forge — Clone profiler: forge and validate
+Usage: /aioson:agent:profiler-forge [task description]
+Requires:
+  .aioson/profiler-reports/{person-slug}/enriched-profile.md
+Produces: .aioson/genomes/{person-slug}-{domain-slug}.md + .aioson/genomes/{person-slug}-{domain-slug}.meta.json + .aioson/advisors/{person-slug}-advisor.md
+Instruction file: .aioson/agents/profiler-forge.md
+CLI help: aioson agent:help profiler-forge
+
+Otherwise: Read `.aioson/agents/profiler-forge.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/profiler-researcher.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Clone profiler: research phase"
----
-
-Read `.aioson/agents/profiler-researcher.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Clone profiler: research phase"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@profiler-researcher — Clone profiler: research phase
+Usage: /aioson:agent:profiler-researcher [task description]
+Requires:
+  (none)
+Produces: .aioson/profiler-reports/{person-slug}/research-report.md
+Instruction file: .aioson/agents/profiler-researcher.md
+CLI help: aioson agent:help profiler-researcher
+
+Otherwise: Read `.aioson/agents/profiler-researcher.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/qa.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Risk-first review and test generation (SMALL/MEDIUM)"
----
-
-Read `.aioson/agents/qa.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Risk-first review and test generation (SMALL/MEDIUM)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@qa — Risk-first review and test generation (SMALL/MEDIUM)
+Usage: /aioson:agent:qa [task description]
+Requires:
+  .aioson/context/discovery.md
+Produces: QA report
+Instruction file: .aioson/agents/qa.md
+CLI help: aioson agent:help qa
+
+Otherwise: Read `.aioson/agents/qa.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/setup.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Project onboarding and context setup"
----
-
-Read `.aioson/agents/setup.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Project onboarding and context setup"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@setup — Project onboarding and context setup
+Usage: /aioson:agent:setup [task description]
+Requires:
+  (none)
+Produces: .aioson/context/project.context.md
+Instruction file: .aioson/agents/setup.md
+CLI help: aioson agent:help setup
+
+Otherwise: Read `.aioson/agents/setup.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/sheldon.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Deep technical analysis and architecture review"
----
-
-Read `.aioson/agents/sheldon.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Deep technical analysis and architecture review"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@sheldon — Deep technical analysis and architecture review
+Usage: /aioson:agent:sheldon [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: enriched PRD or architecture review
+Instruction file: .aioson/agents/sheldon.md
+CLI help: aioson agent:help sheldon
+
+Otherwise: Read `.aioson/agents/sheldon.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/site-forge.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Clone, extract, and forge sites and design skills from any URL"
----
-
-Read `.aioson/agents/site-forge.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Clone, extract, and forge sites and design skills from any URL"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@site-forge — Clone, extract, and forge sites and design skills from any URL
+Usage: /aioson:agent:site-forge [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: src/components/*.tsx + src/app/page.tsx + docs/research/{hostname}/ + public/images/{hostname}/
+Instruction file: .aioson/agents/site-forge.md
+CLI help: aioson agent:help site-forge
+
+Otherwise: Read `.aioson/agents/site-forge.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/squad.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Squad assembly and management"
----
-
-Read `.aioson/agents/squad.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Squad assembly and management"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@squad — Squad assembly and management
+Usage: /aioson:agent:squad [task description]
+Requires:
+  (none)
+Produces: .aioson/squads/{slug}/squad.manifest.json + .aioson/squads/{slug}/squad.md + .aioson/squads/{slug}/agents/ + .aioson/squads/{slug}/workers/ + .aioson/squads/{slug}/workflows/ + .aioson/squads/{slug}/checklists/ + .aioson/squads/{slug}/skills/ + .aioson/squads/{slug}/templates/ + .aioson/squads/{slug}/docs/ + output/{slug}/{session-id}.html + output/{slug}/{content-key}/content.json + output/{slug}/{content-key}/index.html + output/{slug}/latest.html + aioson-logs/{slug}/ + media/{slug}/
+Instruction file: .aioson/agents/squad.md
+CLI help: aioson agent:help squad
+
+Otherwise: Read `.aioson/agents/squad.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/tester.md

@@ -1,5 +1,16 @@
----
-description: "AIOSON — Systematic test engineering for implemented apps (all sizes)"
----
-
-Read `.aioson/agents/tester.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Systematic test engineering for implemented apps (all sizes)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@tester — Systematic test engineering for implemented apps (all sizes)
+Usage: /aioson:agent:tester [task description]
+Requires:
+  .aioson/context/project.context.md
+Produces: .aioson/context/test-inventory.md + .aioson/context/test-plan.md
+Instruction file: .aioson/agents/tester.md
+CLI help: aioson agent:help tester
+
+Otherwise: Read `.aioson/agents/tester.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/ux-ui.md

@@ -1,5 +1,19 @@
----
-description: "AIOSON — UI/UX design system and component spec (SMALL/MEDIUM)"
----
-
-Read `.aioson/agents/ux-ui.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — UI/UX design system and component spec (SMALL/MEDIUM)"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@ux-ui — UI/UX design system and component spec (SMALL/MEDIUM)
+Usage: /aioson:agent:ux-ui [task description]
+Requires:
+  .aioson/context/project.context.md
+  .aioson/context/prd.md or .aioson/context/prd-{slug}.md
+  .aioson/context/discovery.md
+  .aioson/context/architecture.md
+Produces: .aioson/context/ui-spec.md + Visual identity enrichment in prd.md or prd-{slug}.md
+Instruction file: .aioson/agents/ux-ui.md
+CLI help: aioson agent:help ux-ui
+
+Otherwise: Read `.aioson/agents/ux-ui.md` and follow all instructions. $ARGUMENTS

package/template/.claude/commands/aioson/agent/validator.md

@@ -1,5 +1,17 @@
----
-description: "AIOSON — Technical validation against success contract"
----
-
-Read `.aioson/agents/validator.md` and follow all instructions. $ARGUMENTS
+---
+description: "AIOSON — Technical validation against success contract"
+---
+
+If $ARGUMENTS is exactly "--help" or starts with "--help":
+Do NOT activate the agent. Instead, display this help and stop:
+
+@validator — Technical validation against success contract
+Usage: /aioson:agent:validator [task description]
+Requires:
+  .aioson/plans/{slug}/harness-contract.json
+  .aioson/plans/{slug}/progress.json
+Produces: .aioson/plans/{slug}/last-validator-output.json
+Instruction file: .aioson/agents/validator.md
+CLI help: aioson agent:help validator
+
+Otherwise: Read `.aioson/agents/validator.md` and follow all instructions. $ARGUMENTS