AZPrototype/agents.html at main · Bird-NZ/AZPrototype · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Agents overview · AZPrototype</title>
  <meta name="description" content="The built-in team, what each agent does, and how customization works.">
  <link rel="stylesheet" href="assets/style.css">
  <script defer src="assets/site.js"></script>
</head>
<body>
  <div class="shell">
    <aside class="sidebar">
      <a class="brand" href="index.html">
        <span class="brand-mark">AZ</span>
        <span><strong>AZPrototype</strong><small>GitHub Pages docs site</small></span>
      </a>
      <nav class="nav"><a href="index.html" class="nav-link">Overview</a><a href="getting-started.html" class="nav-link">Getting started</a><a href="quickstart.html" class="nav-link">Quickstart</a><a href="walkthrough.html" class="nav-link">Walkthrough</a><a href="artifacts.html" class="nav-link">Artifacts</a><a href="agents.html" class="nav-link active">Agents</a><a href="templates.html" class="nav-link">Templates</a><a href="configuration.html" class="nav-link">Configuration</a><a href="deployment.html" class="nav-link">Deployment</a><a href="troubleshooting.html" class="nav-link">Troubleshooting</a><a href="examples.html" class="nav-link">Examples</a><a href="faq.html" class="nav-link">FAQ</a></nav>
      <div class="sidebar-note">
        <p><strong>Workflow</strong></p>
        <p><code>init → design → build → deploy</code></p>
      </div>
    </aside>
    <main class="content">
      <header class="hero">
        <p class="eyebrow">AZ Prototype Docs</p>
        <h1>Agents overview</h1>
        <p class="lede">The built-in team, what each agent does, and how customization works.</p>

      </header>

<section class="panel"><h2>Built-in agents</h2><table><tr><th>Agent</th><th>Role</th><th>Use</th></tr><tr><td>cloud-architect</td><td>Architecture</td><td>Designs the overall solution and stage plan</td></tr><tr><td>terraform-agent</td><td>Terraform</td><td>Generates Terraform infrastructure</td></tr><tr><td>bicep-agent</td><td>Bicep</td><td>Generates Bicep infrastructure</td></tr><tr><td>app-developer</td><td>Application code</td><td>Builds APIs, functions, containers, and app code</td></tr><tr><td>doc-agent</td><td>Documentation</td><td>Produces architecture, deployment, and supporting docs</td></tr><tr><td>qa-engineer</td><td>QA and diagnostics</td><td>Reviews failures and coordinates fixes</td></tr><tr><td>biz-analyst</td><td>Requirements</td><td>Identifies gaps and drives discovery</td></tr><tr><td>cost-analyst</td><td>Costing</td><td>Estimates Azure spend by t-shirt size</td></tr><tr><td>project-manager</td><td>Coordination</td><td>Orchestrates tasks, scope, and escalation</td></tr><tr><td>security-reviewer</td><td>Security</td><td>Flags risky IaC and config choices</td></tr><tr><td>monitoring-agent</td><td>Observability</td><td>Adds alerts, diagnostics, and monitoring defaults</td></tr></table></section>
<section class="grid cols-2"><article class="panel"><h2>Customize the system</h2><pre><code>az prototype agent list
az prototype agent add --file ./my-agent.yaml
az prototype agent override --name cloud-architect --file ./my-architect.yaml
az prototype agent export --name cloud-architect --output ./cloud-architect.yaml</code></pre></article><article class="panel"><h2>Why this matters</h2><p>The extension is opinionated: it is not just one model prompt. It is a role-based system with specialization, governance context, and hand-offs. That is why it can cover architecture, IaC, docs, QA, security, and monitoring in a single workflow.</p></article></section>
<section class="panel"><h2>Minimal custom agent YAML</h2><pre><code>name: my-custom-agent
description: Custom agent for regulated workloads
role: architect
system_prompt: |
  You are a specialized architect for regulated Azure workloads.
constraints:
  - Must use managed identity
  - Must follow naming conventions
tools:
  - terraform
  - bicep</code></pre></section>

      <footer class="footer">
        <p>Built as a static, GitHub Project Pages-ready site for the <code>az prototype</code> extension.</p>
      </footer>
    </main>
  </div>
</body>
</html>