docs: workflows

[adityachoudhari26]

generate a workflows.mdx to explain how the workflow engine works.
should include explanations about:

• how to specify inputs
• how to wire in job agents
• how the inputs persist to job agents and the templating
• examples
• the terraform provider

[adityachoudhari26]

@claude resolve this

[claude]

Claude finished @adityachoudhari26's task in 4m 20s —— View job • claude/issue-995-20260415-2002 • Create PR ➔

---

Generating workflows.mdx Documentation

• Gather context and understand the request
• Explore the codebase to understand the workflow engine
• Find existing docs structure and location
• Understand job agents and inputs
• Understand templating system
• Find Terraform provider references
• Create workflows.mdx documentation file
• Update docs.json navigation
• Commit and push changes

---

Created docs/workflows.mdx covering:

• Input types — string, number, boolean, object, and two array variants (manual list vs. CEL-based selector array that resolves from your resource/environment/deployment inventory)
• Input resolution — how provided values are merged with declared defaults at run time
• Job agent wiring — ref, config, and selector fields; how CEL selectors gate which agents run
• Templating — Go text/template syntax in config values using {{.inputs.<key>}} and {{.workflow}}
• Full examples — database migration workflow with GitHub Actions, multi-agent rolling restart with GitHub + Terraform Cloud
• Terraform provider — ctrlplane_workflow resource with input and job_agent blocks
• API reference table and an internal sequence diagram showing the dispatch flow

Also added "workflows" to the Deployment tab in docs.json.