Topic guides

Deep dives beyond the adoption paths. Use these after you know which job you are doing (demo, export, or compose).

New term? Check the Glossary first.

Tutorials

Guide When to read
Agent as Code — Zero to Hero Basic Terraform → first agent, knowledge, integration, models, skills, workflows, and runbooks — progressive lessons with runnable step folders.

Reference

Guide When to read
Glossary Plain-English lookup for StackGen, Aiden OS, agents, workflows, IaC, and other concepts on this site.
Persona agents, workflows, and skills When to use each building block, how they compose, and field best practices.
Skills sync Why tofu apply does not upload skill card bodies — skill source + skillsync + verify.
Agent mute — models & tools FAQ Chat fails or “won’t use Jira/tools”: prove LLMs with /api/v1/models/{name}/test, fix tools: 0 / missing model registry rows.
Custom LLM provider URLs Azure OpenAI, Foundry, LiteLLM, OpenRouter, or corporate proxy: set base URL + API version in UI or Terraform.
Telemetry, PII & vault secrets FAQ Diligence: vault secrets vs metrics vs Langfuse; scrub/delete paths for vendor vs local data.

Deployment and rollout

Guide When to read
Architecture Layer diagram — foundation → integrations → agents — and how modules depend on each other.
Enterprise deployment profile Post-PoC enterprise rollout: module choice, webhooks, skills sync, LLM egress, milestones.
Migration guide Refactor monolithic terraform/guild/main.tf into aios-* modules.
aios-export Capture a UI-configured Aiden OS tenant as HCL (PoC handoff).

Agent workflows

Guide When to read
CloudFormation Author Intent → CFN PR, compliance preflight, drift management.
Monorepo services split Monolith → microservices: analysis PR, optional extract.
Spec-driven orchestration Stage 5 SDD factory (aios-agent-spec-symphony).
CCE enterprise workflows Seven enterprise superpowers with demo scenarios.
CCE × AIOS integrations Code Context Engine usage mapped to agent modules.
Omnichannel triage Slack / Teams Event Subscription wiring for chat intake.
Kinded YAML apply stackgen ai apply for Agent / Workflow / Skill without Terraform (CLI ≥ v0.82.0-rc.1).

Governance and module selection

Guide When to read
Use-case catalog Customer situation → agent + integration modules.
Writing Rego policies Policy evaluation, sample input JSON, OPA Playground.
HITL approval authority and role-based Rego Who may approve vs who may invoke tools; intervention + approval_authorization Rego; what to expect on Approve.

Customer POC / Trust

Guide When to read
Aiden POC — Accuracy, Memory, SLOs & Privacy Customer-facing FAQ for POC stakeholders: scorecard accuracy, memory TTL, SLO/error budget, PII and privacy.
Telemetry, PII & vault secrets FAQ Whether vault secrets appear in telemetry; vendor sinks; how to scrub/delete.

Community

Guide When to read
SE feedback / office hours Slack channel, scenario-request issues, weekly cadence.
Onboarding (compose deep dive) Compose path (steps 1–5) plus author a package for requirement → module/scenario.