Skip to main content

actio validate

Check that the Actio sidecar is present, valid, and consistent. Fails with a non-zero exit code if there are issues.

Synopsis​

actio validate

Runs in the current directory.

What it checks​

  1. actio/router.yaml exists and is valid YAML.
  2. Schema: version, project.name, domains, rules.coding, and task references are set and valid.
  3. Referential integrity: Every file path in router.yaml (architecture, interfaces, patterns, rules, task guides) exists under actio/.
  4. Required layout: Directories actio/architecture/, actio/interfaces/, actio/rules/, actio/tasks/ exist.
  5. Default files: architecture/system.md, rules/rules.md, tasks/task.md exist (or whatever your index references).
  6. Plugins: Any YAML plugins under actio/plugins/ are run; their required files are checked.

Output​

Success:

Actio validation passed

Failure: Lists each issue, then exits with non-zero status.

Actio validation issues:
- missing actio/router.yaml
- router.yaml: project.name must be set
- router.yaml: tasks.deploy.guide references missing file: actio/tasks/deploy.md

Use in CI​

# GitHub Actions example
- name: Validate Actio
  run: actio validate

Use this to keep the sidecar correct and prevent broken references from being merged.

See also​