Cookbook
Hands-on, task-shaped guides. Each page is a complete working example — curl-able, forkable, re-runnable.
Templates
Five starter packs ship with the declaragent init wizard (concierge, oncall-escalator, pr-review, kafka-pipeline, multi-tenant-starter). The fleet-scoped starters (rpc-client, rpc-server, fleet-starter) are added via declaragent init --fleet + fleet add --template <name> or copied from the repo. Each page walks its template end-to-end.
| Template | What it demonstrates |
|---|---|
concierge | Minimal Slack Q&A bot (Socket Mode, provider-default tools) |
oncall-escalator | Alertmanager webhook → Claude triage → Slack DM |
pr-review | GitHub webhook → Claude reviews the diff → inline review comments |
kafka-pipeline | Kafka source + DLQ + daily cost budget |
multi-tenant-starter | Two tenants on one daemon, scoped extensions + quotas |
rpc-client + rpc-server | Paired agents exchanging typed requests over agent-rpc (v1.1) |
fleet-starter | Two agents under one manifest + the full declaragent fleet workflow (v1.2) |
Recipes
Cross-cutting how-tos built on top of the runtime.
| Recipe | Goal |
|---|---|
| Build an agent through conversation | End-to-end builder-toolkit flow — propose, confirm, apply, undo. v0.2. |
| Deploy to GCP Cloud Run | Get the concierge template live on Cloud Run in ten minutes. |
| Rotate a Vault secret | Zero-downtime secret rotation using declaragent secrets rotate. |
| Run two tenants on one daemon | Isolated state, extensions, and quotas — one process. |
| Trace a request in Grafana | End-to-end OTel span from inbound → engine → outbound. |
Enterprise recipes
Platform / SRE / security paths — built on features enterprise buyers ask about first.
Start here if you're evaluating the product: Enterprise — zero to a deployed demo, end to end. A single ~60-minute walkthrough on a developer laptop — the conversational builder, Vault secrets, per-tool rate limits, SIEM audit export, fleet render, and generated Cloud Run deploy artifacts. The standalone recipes below go deeper on individual topics (OIDC control-plane auth, cross-host fleets, GitOps).
| Recipe | Goal |
|---|---|
| Enterprise — zero to deploy | Integrated walkthrough. Empty directory → two-agent fleet with enterprise controls + rendered deploy artifacts. |
| GitOps deploy with ArgoCD or Flux | fleet render → git → your existing Argo/Flux reconciler. Drift detection + rollback for free. |
| Stream audit to Splunk / Elastic / Datadog | Hash-chained audit into your SIEM with back-pressure + adaptive batch. |
| Zero-trust RPC migration (0.8.0) | Pre-flight fleet audit-rpc --strict in CI before the default flip. |
| Cross-host fleet on Kafka | Split a fleet across regions; observe it as one with hosts[] fan-out. |
| Import the Grafana dashboard | Three-row importable dashboard covering MCP, audit, rate limits. |
Missing something?
Open a discussion at github.com/declaragent/declaragent/discussions — cookbook pages are the quickest way to ship knowledge back to the community.