arrow_back Back to Catalog
workflows Governance

Workflow /para-workflow

Manage, install, and standardize execution workflows for AI Agents.

The /para-workflow command is a specialized management tool for the Workflow Library. Unlike daily execution commands, this workflow is used to maintain, install, and design the “blueprints” that guide AI behavior.

Command List

/para-workflow [action] [name]
ActionDescription
listCompare Local workflows against the Governed Catalog.
addInitialize a new PARA-compliant workflow draft.
standardizeUpgrade workflows to meet the latest architecture.
installFetch official workflows from the Catalog.
validateCheck for syntax errors and compliance issues.

Workflow Standardization (8-Point Checklist)

To ensure a workflow is both efficient and safe, it must pass an 8-point quality check:

  1. YAML Frontmatter: Must include a mandatory description field.
  2. Version Label: Must accurately display the current version.
  3. Language: Core instructions should prioritize English for optimal Agent reasoning.
  4. Relative Paths: Strictly no absolute paths allowed.
  5. Project Placeholders: Use [project-name] variables instead of hardcoded strings.
  6. Catalog Paths: Must point to the correct administrative Catalog source.
  7. Turbo Annotations: Use // turbo for safe steps the Agent can auto-execute.
  8. No Duplicate Scope: Ensure logic doesn’t overlap with existing system commands.

Critical Notes

  • Source of Truth: The catalog.yml file defines the only officially supported workflows.
  • Untracked Workflows: You can create custom workflows; they remain functional but are labeled “untracked” and won’t receive automatic system updates.
  • Maintenance: Run validate regularly to identify legacy paths or deprecated instructions.

Relationships

  • /para — Overall Workspace Master Controller.
  • /para-rule — Management of behavioral rules.
  • /merge — Merging custom logic when a new Catalog version is available.