Add acreadiness-cockpit plugin (AgentRC measure -> generate -> maintain) 🤖🤖🤖 (#1593)

* Add acreadiness-cockpit plugin

Adds a new plugin that drives Microsoft AgentRC from Copilot chat,
framing every interaction inside AgentRC's Measure -> Generate ->
Maintain loop.

Custom agent (agents/ai-readiness-reporter.agent.md):
  Runs `agentrc readiness --json`, interprets every result against
  the 9-pillar / 5-level maturity model, then renders a self-contained
  reports/index.html from a fixed HTML/CSS template (bundled with the
  acreadiness-assess skill) so every user gets an identically styled
  dashboard. Honours policies (disabled criteria, overrides, pass-rate
  thresholds) and surfaces extras separately.

Skills:
  - acreadiness-assess: Measure step. Wraps `agentrc readiness --json`
    and hands off to the @ai-readiness-reporter agent. Bundles the
    canonical report-template.html.
  - acreadiness-generate-instructions: Generate step. Wraps
    `agentrc instructions`. Defaults to .github/copilot-instructions.md
    (Copilot-native). Asks flat vs nested. For monorepos, emits per-area
    .github/instructions/<area>.instructions.md files with applyTo
    globs taken from agentrc.config.json.
  - acreadiness-policy: Maintain step. Helps pick, scaffold, or apply an
    AgentRC policy (criteria.disable, criteria.override, extras,
    thresholds) and wire it into CI via --fail-level.

Plugin (plugins/acreadiness-cockpit/):
  Declarative plugin.json referencing the agent and three skills.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address PR review feedback

- Align documented slash-command names with plugin manifest:
  /acreadiness-assess, /acreadiness-generate-instructions,
  /acreadiness-policy (was /assess, /generate-instructions, /policy
  inside SKILL bodies and argument-hints).
- Move the literal % from the report template into the substituted
  values for {{passRate}} and {{threshold}} so an N/A value of '—'
  no longer renders as '—%'. Updated the agent placeholder contract
  accordingly.
- Point the report footer at the canonical plugin folder under
  github/awesome-copilot instead of the personal source fork.
- Add explicit HTML-escaping rules to the agent: HTML-escape every
  {{placeholder}} substitution, and replace </script with <\/script
  inside the embedded JSON block so untrusted repo content cannot
  break the markup or inject scripts.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

skills/acreadiness-assess/report-template.html

@@ -0,0 +1,227 @@
+<!--
+  AI Readiness Report — canonical template
+  --------------------------------------------
+  This file is the single source of truth for the look & feel of the
+  reports/index.html output. The @ai-readiness-reporter agent MUST load
+  this file, substitute the {{placeholders}} with real data from
+  `agentrc readiness --json`, and write the result to reports/index.html.
+
+  Rules for the agent:
+  - Do NOT change the HTML structure, class names, CSS variables or the
+    inline <style> block. The template is intentionally fixed so every
+    consumer of this plugin gets an identical-looking report.
+  - Replace every {{placeholder}} with concrete data. Repeat the marked
+    blocks (pillar cards, plan rows, maturity rows, extra rows) for
+    each item. Remove blocks that don't apply (e.g. policy section if
+    no policy is active).
+  - Keep the file self-contained: no external CSS/JS, no network fonts.
+  - Preserve the <script type="application/json" id="raw-data"> block
+    and embed the compact AgentRC JSON inside it.
+
+  Placeholders used:
+    {{repoName}}       repository name
+    {{date}}           ISO date the report was generated
+    {{level}}          maturity level number (1-5)
+    {{levelName}}      maturity level name (Functional, Documented, ...)
+    {{overallPct}}     overall readiness as integer percent
+    {{grade}}          letter grade A-F
+    {{passRatePct}}    pass rate as integer percent (or "—" if N/A)
+    {{thresholdPct}}   policy pass-rate threshold (or "—")
+    {{policyName}}     active policy name (omit policy section if none)
+    {{policySummary}}  one-paragraph summary of disabled/overridden criteria
+    {{rawJsonCompact}} compact JSON for embedding
+    {{rawJsonPretty}}  pretty JSON for the <details> view
+
+  Pillar card placeholders (repeat per pillar):
+    {{pillarName}} {{pillarScore}} {{pillarRelevance}} (high|medium|low)
+    {{pillarStatus}} (good|warn|bad — drives bar + dot colour)
+    {{pillarWhat}} {{pillarWhyAi}} {{pillarCurrent}} {{pillarRecommendation}}
+-->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>AI Readiness — {{repoName}}</title>
+  <style>
+    :root {
+      --bg:#0f1115; --panel:#161a22; --panel-2:#1d2230; --border:#262c3a;
+      --text:#e6e9ef; --muted:#8a93a6; --accent:#6ea8ff;
+      --good:#4ade80; --warn:#fbbf24; --bad:#f87171;
+    }
+    * { box-sizing: border-box; }
+    html,body { margin:0; background:var(--bg); color:var(--text);
+      font:14px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif; }
+    a { color: var(--accent); }
+    header { padding: 28px 32px; border-bottom: 1px solid var(--border);
+      background: linear-gradient(180deg,#141823,#0f1115); }
+    header h1 { margin: 0 0 4px; font-size: 22px; }
+    header .meta { color: var(--muted); font-size: 13px; }
+    main { max-width: 1180px; margin: 0 auto; padding: 24px 32px 80px; }
+    .panel { background:var(--panel); border:1px solid var(--border);
+      border-radius:10px; padding:20px; margin-bottom:18px; }
+    .grid { display:grid; gap:16px; }
+    .grid.cols-3 { grid-template-columns: repeat(3, 1fr); }
+    .grid.cols-2 { grid-template-columns: 1fr 1fr; }
+    .kpi .num { font-size: 30px; font-weight: 700; }
+    .kpi .lbl { color: var(--muted); font-size: 11px; text-transform: uppercase; letter-spacing: .8px; }
+    .badge { display:inline-block; padding:3px 10px; border-radius:999px;
+      font-size:12px; font-weight:600; }
+    .lvl-1 { background:#3a1f24; color:#f87171; }
+    .lvl-2 { background:#3b2c1d; color:#fbbf24; }
+    .lvl-3 { background:#2c3119; color:#d3e85e; }
+    .lvl-4 { background:#1d3325; color:#4ade80; }
+    .lvl-5 { background:#1c2c3d; color:#6ea8ff; }
+    .bar { height:8px; background:var(--panel-2); border-radius:4px; overflow:hidden; }
+    .bar > span { display:block; height:100%; background: var(--accent); }
+    .bar.good > span { background: var(--good); }
+    .bar.warn > span { background: var(--warn); }
+    .bar.bad  > span { background: var(--bad); }
+    table { width:100%; border-collapse:collapse; }
+    th,td { text-align:left; padding:8px 10px; border-bottom:1px solid var(--border); font-size:13px; }
+    th { color:var(--muted); font-weight:500; text-transform:uppercase; font-size:11px; letter-spacing:.8px; }
+    code { background:#0a0c11; padding:1px 6px; border-radius:4px; }
+    h2 { font-size:14px; color:var(--muted); text-transform:uppercase; letter-spacing:.8px; margin:0 0 12px; }
+    .dot { width:8px; height:8px; border-radius:50%; display:inline-block; }
+    .dot.good { background:var(--good); } .dot.warn { background:var(--warn); } .dot.bad { background:var(--bad); }
+    footer { color: var(--muted); font-size: 12px; text-align: center; padding: 20px; }
+
+    /* Pillar cards */
+    .pillar { background:var(--panel-2); border:1px solid var(--border);
+      border-radius:8px; padding:14px 16px; }
+    .pillar h3 { margin:0 0 6px; font-size:15px; display:flex; align-items:center; gap:10px; flex-wrap:wrap; }
+    .pillar .why  { color:var(--muted); font-size:13px; margin:8px 0 0; }
+    .pillar .what { font-size:13px; margin:6px 0 0; }
+    .pillar .rec  { font-size:13px; margin:8px 0 0; }
+    .rel { font-size:10px; padding:2px 8px; border-radius:999px; text-transform:uppercase; letter-spacing:.6px; font-weight:600; }
+    .rel.high   { background:#1c2c3d; color:#6ea8ff; }
+    .rel.medium { background:#2c3119; color:#d3e85e; }
+    .rel.low    { background:#262c3a; color:#8a93a6; }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>AI Readiness Report</h1>
+    <div class="meta">
+      <strong>{{repoName}}</strong> · Assessed {{date}} ·
+      <span class="badge lvl-{{level}}">L{{level}} — {{levelName}}</span> ·
+      Overall <strong>{{overallPct}}%</strong> · Grade <strong>{{grade}}</strong>
+      <!-- if a policy is active, append: · Policy <code>{{policyName}}</code> -->
+    </div>
+  </header>
+
+  <main>
+
+    <!-- 1. What is AI Readiness? -->
+    <section class="panel">
+      <h2>What is AI Readiness?</h2>
+      <p>AI coding agents are only as effective as the context they receive. AgentRC measures how AI-ready a repo is across <strong>9 pillars</strong> in two categories — Repo Health and AI Setup — and maps the result to a <strong>5-level maturity model</strong>. This report is the <em>Measure</em> step in AgentRC's <em>Measure → Generate → Maintain</em> loop.</p>
+      <p style="color:var(--muted);font-size:13px;margin-top:8px">Each pillar carries an <strong>AI relevance</strong> rating (High / Medium / Low) so you can tell at a glance which gaps most directly affect Copilot's output and which are general engineering hygiene.</p>
+    </section>
+
+    <!-- 2. KPIs -->
+    <section class="grid cols-3">
+      <div class="panel kpi"><span class="lbl">Maturity</span><div class="num"><span class="badge lvl-{{level}}">L{{level}} — {{levelName}}</span></div></div>
+      <div class="panel kpi"><span class="lbl">Overall Score</span><div class="num">{{overallPct}}%</div><div style="color:var(--muted);font-size:12px">Grade {{grade}}</div></div>
+      <div class="panel kpi"><span class="lbl">Pass rate</span><div class="num">{{passRate}}</div><div style="color:var(--muted);font-size:12px">Threshold {{threshold}}</div></div>
+    </section>
+
+    <!-- 3. Maturity progression -->
+    <section class="panel">
+      <h2>Maturity Progression</h2>
+      <table>
+        <thead><tr><th>Level</th><th>Name</th><th>Status</th></tr></thead>
+        <tbody>
+          <!-- Render levels 5 → 1. Mark the current level with "◼ You are here". Example row:
+            <tr><td>L3</td><td>Standardized</td><td>◼ You are here</td></tr>
+          -->
+        </tbody>
+      </table>
+    </section>
+
+    <!-- 4. Active policy (omit this section entirely when no policy is active) -->
+    <section class="panel">
+      <h2>Active Policy</h2>
+      <p><code>{{policyName}}</code> — {{policySummary}}</p>
+    </section>
+
+    <!-- 5. Repo Health Pillars -->
+    <section class="panel">
+      <h2>Repo Health Breakdown</h2>
+      <div class="grid cols-2">
+        <!--
+          Repeat one .pillar block per Repo Health pillar (8 pillars):
+          Style, Build, Testing, Docs, Dev Environment, Code Quality, Observability, Security.
+
+          <div class="pillar">
+            <h3>
+              <span class="dot {{pillarStatus}}"></span>
+              {{pillarName}}
+              <span class="rel {{pillarRelevance}}">AI relevance: {{pillarRelevance}}</span>
+              <span style="margin-left:auto;color:var(--muted);font-size:13px">{{pillarScore}}%</span>
+            </h3>
+            <div class="bar {{pillarStatus}}"><span style="width:{{pillarScore}}%"></span></div>
+            <p class="what"><strong>What it measures:</strong> {{pillarWhat}}</p>
+            <p class="why"><strong>Why it matters for AI:</strong> {{pillarWhyAi}}</p>
+            <p class="rec"><strong>Current state:</strong> {{pillarCurrent}}</p>
+            <p class="rec"><strong>Recommendation:</strong> {{pillarRecommendation}}</p>
+          </div>
+        -->
+      </div>
+    </section>
+
+    <!-- 6. AI Setup Pillars -->
+    <section class="panel">
+      <h2>AI Setup Breakdown</h2>
+      <div class="grid cols-2">
+        <!-- AI Tooling pillar block — same structure as above, AI relevance is always "high". -->
+      </div>
+    </section>
+
+    <!-- 7. Extras -->
+    <section class="panel">
+      <h2>Extras (informational, do not affect score)</h2>
+      <table>
+        <thead><tr><th></th><th>Extra</th><th>Status</th></tr></thead>
+        <tbody>
+          <!-- agents-doc, pr-template, pre-commit, architecture-doc rows. Use ✅ or ◻. -->
+        </tbody>
+      </table>
+    </section>
+
+    <!-- 8. Prioritised Remediation Plan -->
+    <section class="panel">
+      <h2>Prioritised Remediation Plan</h2>
+      <h3 style="color:var(--bad)">🔴 Fix First (high impact / low effort)</h3>
+      <table><thead><tr><th>#</th><th>Finding</th><th>File / config</th><th>Why it matters</th></tr></thead><tbody><!-- rows --></tbody></table>
+      <h3 style="color:var(--warn)">🟡 Fix Next (medium impact / low effort)</h3>
+      <table><thead><tr><th>#</th><th>Finding</th><th>File / config</th><th>Why</th></tr></thead><tbody><!-- rows --></tbody></table>
+      <h3 style="color:var(--accent)">🔵 Plan (medium impact / medium effort)</h3>
+      <table><thead><tr><th>#</th><th>Finding</th><th>File / config</th><th>Why</th></tr></thead><tbody><!-- rows --></tbody></table>
+    </section>
+
+    <!-- 9. Next steps -->
+    <section class="panel">
+      <h2>Next Steps</h2>
+      <ol>
+        <li>Generate or refresh instructions: <code>agentrc instructions --output .github/copilot-instructions.md</code> (or use the <code>generate-instructions</code> skill).</li>
+        <li>Address each item under <strong>🔴 Fix First</strong>; re-run this report to confirm score improvement.</li>
+        <li>Codify org standards via a JSON policy (<code>strict.json</code>, <code>ai-only.json</code>, …) and re-run with <code>--policy</code>.</li>
+        <li>Wire <code>agentrc readiness --fail-level &lt;n&gt;</code> into CI to prevent regressions.</li>
+      </ol>
+    </section>
+
+    <!-- 10. Raw data -->
+    <details class="panel">
+      <summary style="cursor:pointer;color:var(--muted)">Raw AgentRC JSON</summary>
+      <pre style="overflow:auto;font-size:11px;color:#b8c0d2">{{rawJsonPretty}}</pre>
+    </details>
+    <script type="application/json" id="raw-data">{{rawJsonCompact}}</script>
+  </main>
+
+  <footer>
+    Generated by <a href="https://github.com/github/awesome-copilot/tree/main/plugins/acreadiness-cockpit">acreadiness-cockpit</a>
+    · powered by <a href="https://github.com/microsoft/agentrc">microsoft/agentrc</a>.
+  </footer>
+</body>
+</html>