npm - @forwardimpact/outpost - Versions diffs - 3.0.3 - Mend

@forwardimpact/outpost 3.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (120) hide show

package/templates/.claude/skills/candidate-report/references/report-template.html ADDED Viewed

@@ -0,0 +1,203 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>Candidate Report — {{CANDIDATE_NAME}}</title>
+    <!--
+  candidate-report template
+  ─────────────────────────
+  This is the structural skeleton for the A4 one-page candidate assessment.
+  Replace all {{PLACEHOLDER}} tokens with candidate-specific data.
+  The stylesheet is in references/report.css — inline it here with a <style>
+  tag (required for PDF rendering).
+  LAYOUT BUDGET (fits 297mm A4 height):
+    Header:      ~60px
+    Verdict:     ~36px
+    Body:        ~680px  (6 sections at ~110px avg)
+    Footer:      ~28px
+  When customising, test with Ctrl+P (print preview) in a browser to verify
+  the report fits on a single page. If content overflows, reduce the number
+  of benchmark skills shown or shorten the strengths list.
+-->
+    <style>
+      {{INLINE_CSS}}
+    </style>
+  </head>
+  <body>
+    <!-- ── Header ── -->
+    <div class="hdr">
+      <div class="hdr-left">
+        <h1>{{CANDIDATE_NAME}}</h1>
+        <p>
+          {{CANDIDATE_TITLE}} &mdash; {{CANDIDATE_ORG}} &bull;
+          {{CANDIDATE_LOCATION}}
+        </p>
+      </div>
+      <div class="hdr-right">
+        {{REPORT_DATE}}<br />
+        {{TARGET_POD_OR_TEAM}}<br />
+        {{TARGET_DOMAIN}}
+      </div>
+    </div>
+    <!-- ── Verdict Banner ──
+     Classes: verdict-caution (amber), verdict-pass (red), verdict-proceed (green)
+-->
+    <div class="verdict {{VERDICT_CLASS}}">
+      <strong>{{VERDICT_ICON}} {{VERDICT_HEADLINE}}</strong>
+      <span>&mdash; {{VERDICT_DETAIL}}</span>
+    </div>
+    <div class="body">
+      <!-- ── Row 1: Snapshot + Strengths (two columns) ── -->
+      <div class="cols">
+        <div class="col">
+          <div class="stitle">Snapshot</div>
+          <dl class="snap">
+            <!--
+          Typical fields: Experience, Education, Source, Stack.
+          Add/remove <dt>/<dd> pairs as needed for the candidate.
+        -->
+            {{SNAPSHOT_DL_ITEMS}}
+          </dl>
+        </div>
+        <div class="col">
+          <div class="stitle">Key Strengths</div>
+          <ul class="str-list">
+            <!--
+          3-5 bullet points. Each: <li><strong>Label.</strong> Detail.</li>
+        -->
+            {{STRENGTHS_LI_ITEMS}}
+          </ul>
+        </div>
+      </div>
+      <!-- ── Row 2: Level Gauge ── -->
+      <div>
+        <div class="stitle">
+          Level Calibration &mdash; estimated {{ESTIMATED_LEVEL}} vs target
+          {{TARGET_LEVEL}}
+        </div>
+        <div class="gauge">
+          <!--
+        Render one <div> per level on the gauge.
+        Add class="cand" to the estimated level, class="tgt" to the target.
+        Show 5 levels centred around the candidate/target range.
+        Example:
+        <div>J050<small>Level I</small></div>
+        <div class="cand">J060<small>Candidate</small></div>
+        <div class="tgt">J070<small>Target</small></div>
+        <div>J080<small>Level IV</small></div>
+        <div>J090<small>Staff</small></div>
+      -->
+          {{GAUGE_DIVS}}
+        </div>
+      </div>
+      <!-- ── Row 3: Benchmark Grid (2×2) ── -->
+      <div>
+        <div class="stitle">
+          Benchmark vs {{TARGET_LEVEL_LABEL}} {{DISCIPLINE_LABEL}} &mdash;
+          {{TRACK_LABEL}} ({{TOTAL_SKILLS}} skills)
+        </div>
+        <div class="bm">
+          <!--
+        Four .bm-area blocks in a 2×2 grid. Each contains:
+          <h4>🚀 Area Name</h4>
+          <div class="bm-row">
+            <span class="bm-skill">Skill Name</span>
+            <span class="p p-g">Gap</span>   ← or p-a / p-p / p-u
+          </div>
+        Group the framework's capability areas into 4 visual blocks.
+        If there are 6 capability areas, combine the smallest two.
+        Show only skills where evidence exists or the gap is notable —
+        aim for 4-6 rows per block to stay within A4 height.
+        Pill classes:
+          p-g  = Gap (red)
+          p-a  = Partial (amber)
+          p-p  = Positive / Met (green)
+          p-u  = Unknown (grey)
+      -->
+          {{BENCHMARK_AREAS}}
+        </div>
+      </div>
+      <!-- ── Row 4: Behaviours + Coverage Counters (two columns) ── -->
+      <div class="cols">
+        <div class="col">
+          <div class="stitle">Behaviours</div>
+          <div class="beh">
+            <!--
+          One .beh-item per behaviour. Bar fill width = evidence strength (0-100%).
+          Colour: var(--green) positive, var(--amber) partial, var(--red) gap,
+                  var(--s300) unknown.
+          <div class="beh-item">
+            <div class="beh-name">Behaviour Name</div>
+            <div class="beh-bar"><div style="width:70%; background:var(--green);"></div></div>
+            <div class="beh-tag">Assessment — short note</div>
+          </div>
+        -->
+            {{BEHAVIOUR_ITEMS}}
+          </div>
+        </div>
+        <div class="col">
+          <div class="stitle">Coverage Summary</div>
+          <div class="counters">
+            <!--
+          Four counter boxes. Colours are fixed:
+            Gap:     background:#FEE2E2  text:#991B1B
+            Partial: background:#FEF3C7  text:#92400E
+            Unknown: background:var(--s100) text:var(--s500)
+            Met:     background:#D1FAE5  text:#065F46
+        -->
+            <div class="ctr" style="background: #fee2e2">
+              <div class="n" style="color: #991b1b">{{COUNT_GAP}}</div>
+              <div class="l" style="color: #991b1b">Gap</div>
+            </div>
+            <div class="ctr" style="background: #fef3c7">
+              <div class="n" style="color: #92400e">{{COUNT_PARTIAL}}</div>
+              <div class="l" style="color: #92400e">Partial</div>
+            </div>
+            <div class="ctr" style="background: var(--s100)">
+              <div class="n" style="color: var(--s500)">{{COUNT_UNKNOWN}}</div>
+              <div class="l" style="color: var(--s500)">Unknown</div>
+            </div>
+            <div class="ctr" style="background: #d1fae5">
+              <div class="n" style="color: #065f46">{{COUNT_MET}}</div>
+              <div class="l" style="color: #065f46">Met</div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <!-- ── Row 5: Recommendation ── -->
+      <div>
+        <div class="stitle">Recommendation</div>
+        <div class="reco">
+          <ol>
+            <!--
+          2-4 numbered action items. Each:
+          <li><strong>Action.</strong> Detail explaining the step.</li>
+        -->
+            {{RECOMMENDATION_LI_ITEMS}}
+          </ol>
+        </div>
+      </div>
+    </div>
+    <!-- ── Footer ── -->
+    <div class="ftr">
+      <b>FORWARD IMPACT TEAM</b>
+      <span
+        >Confidential &mdash; prepared by {{AUTHOR_NAME}}, {{AUTHOR_ROLE}}</span
+      >
+    </div>
+  </body>
+</html>

package/templates/.claude/skills/candidate-report/references/report.css ADDED Viewed

@@ -0,0 +1,438 @@
+/*
+ * candidate-report — A4 single-page candidate assessment report
+ *
+ * This stylesheet is designed for a 210mm × 297mm page.
+ * It is loaded into the HTML template by the candidate-report skill.
+ *
+ * IMPORTANT: All colours must use print-color-adjust: exact so they survive
+ * PDF rendering via Playwright. Avoid box-shadow and fixed positioning.
+ */
+@import url("https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap");
+:root {
+  --blue: #0072ce;
+  --dark: #003087;
+  --accent: #00a3e0;
+  --green: #10b981;
+  --amber: #f59e0b;
+  --red: #ef4444;
+  --s50: #f8fafc;
+  --s100: #f1f5f9;
+  --s200: #e2e8f0;
+  --s300: #cbd5e1;
+  --s400: #94a3b8;
+  --s500: #64748b;
+  --s600: #475569;
+  --s700: #334155;
+  --s800: #1e293b;
+  --s900: #0f172a;
+}
+@page {
+  size: A4;
+  margin: 0;
+}
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+body {
+  font-family: "Inter", -apple-system, BlinkMacSystemFont, sans-serif;
+  color: var(--s800);
+  line-height: 1.45;
+  -webkit-font-smoothing: antialiased;
+  width: 210mm;
+  min-height: 297mm;
+  max-height: 297mm;
+  overflow: hidden;
+  margin: 0 auto;
+  background: white;
+}
+/* ── Header ── */
+.hdr {
+  background: linear-gradient(
+    135deg,
+    var(--dark),
+    var(--blue) 60%,
+    var(--accent)
+  );
+  padding: 22px 32px 18px;
+  color: white;
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-end;
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.hdr-left h1 {
+  font-size: 22px;
+  font-weight: 800;
+  letter-spacing: -0.3px;
+}
+.hdr-left p {
+  font-size: 11px;
+  opacity: 0.8;
+  margin-top: 2px;
+}
+.hdr-right {
+  text-align: right;
+  font-size: 10px;
+  opacity: 0.75;
+  line-height: 1.5;
+}
+/* ── Verdict Banner ── */
+.verdict {
+  border-left: 4px solid var(--amber);
+  padding: 8px 32px;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  font-size: 11px;
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.verdict strong {
+  color: var(--s900);
+  font-size: 12px;
+}
+.verdict span {
+  color: var(--s600);
+}
+/* Verdict colour variants — set on the element via class */
+.verdict-caution {
+  background: #fef3c7;
+}
+.verdict-pass {
+  background: #fee2e2;
+}
+.verdict-proceed {
+  background: #d1fae5;
+}
+/* ── Body ── */
+.body {
+  padding: 16px 32px 14px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+/* ── Section Titles ── */
+.stitle {
+  font-size: 10px;
+  font-weight: 700;
+  letter-spacing: 1.5px;
+  text-transform: uppercase;
+  color: var(--blue);
+  margin-bottom: 6px;
+  padding-bottom: 4px;
+  border-bottom: 1.5px solid var(--s200);
+}
+/* ── Two-Column Layout ── */
+.cols {
+  display: flex;
+  gap: 20px;
+}
+.col {
+  flex: 1;
+}
+/* ── Snapshot (definition list) ── */
+.snap {
+  font-size: 11px;
+  line-height: 1.6;
+}
+.snap dt {
+  font-weight: 600;
+  color: var(--s400);
+  font-size: 9px;
+  letter-spacing: 0.5px;
+  text-transform: uppercase;
+}
+.snap dd {
+  margin-bottom: 4px;
+  color: var(--s800);
+}
+/* ── Strengths List ── */
+.str-list {
+  list-style: none;
+  font-size: 11px;
+  color: var(--s600);
+}
+.str-list li {
+  padding: 3px 0;
+  padding-left: 14px;
+  position: relative;
+}
+.str-list li::before {
+  content: "";
+  position: absolute;
+  left: 0;
+  top: 10px;
+  width: 6px;
+  height: 6px;
+  border-radius: 2px;
+  background: var(--blue);
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.str-list li strong {
+  color: var(--s800);
+}
+/* ── Level Gauge ── */
+.gauge {
+  display: flex;
+  gap: 0;
+  border-radius: 6px;
+  overflow: hidden;
+  border: 1px solid var(--s200);
+  margin-top: 2px;
+}
+.gauge div {
+  flex: 1;
+  text-align: center;
+  padding: 7px 4px;
+  font-size: 11px;
+  font-weight: 700;
+  background: var(--s50);
+  border-right: 1px solid var(--s200);
+  color: var(--s400);
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.gauge div:last-child {
+  border-right: none;
+}
+.gauge div small {
+  display: block;
+  font-size: 8px;
+  font-weight: 500;
+  margin-top: 1px;
+}
+.gauge .cand {
+  background: #fef3c7;
+  color: #92400e;
+  box-shadow: inset 0 0 0 2px var(--amber);
+}
+.gauge .tgt {
+  background: #dbeafe;
+  color: var(--dark);
+  box-shadow: inset 0 0 0 2px var(--blue);
+}
+/* ── Benchmark Grid ── */
+.bm {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 6px 16px;
+  font-size: 10.5px;
+}
+.bm-area h4 {
+  font-size: 10px;
+  font-weight: 700;
+  color: var(--s700);
+  margin-bottom: 3px;
+}
+.bm-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 2px 0;
+  border-bottom: 1px solid var(--s100);
+}
+.bm-row:last-child {
+  border-bottom: none;
+}
+.bm-skill {
+  color: var(--s700);
+}
+/* Status pills */
+.p {
+  display: inline-block;
+  padding: 1px 7px;
+  border-radius: 4px;
+  font-size: 9px;
+  font-weight: 600;
+  white-space: nowrap;
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.p-g {
+  background: #fee2e2;
+  color: #991b1b;
+} /* Gap         */
+.p-a {
+  background: #fef3c7;
+  color: #92400e;
+} /* Partial     */
+.p-p {
+  background: #d1fae5;
+  color: #065f46;
+} /* Positive    */
+.p-u {
+  background: var(--s100);
+  color: var(--s500);
+} /* Unknown */
+/* ── Behaviour Bars ── */
+.beh {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+.beh-item {
+  flex: 1;
+  min-width: 90px;
+}
+.beh-name {
+  font-size: 9px;
+  font-weight: 600;
+  color: var(--s700);
+  margin-bottom: 2px;
+}
+.beh-bar {
+  height: 4px;
+  border-radius: 2px;
+  background: var(--s100);
+  overflow: hidden;
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.beh-bar div {
+  height: 100%;
+  border-radius: 2px;
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.beh-tag {
+  font-size: 8px;
+  color: var(--s400);
+  margin-top: 1px;
+}
+/* ── Coverage Counters ── */
+.counters {
+  display: flex;
+  gap: 8px;
+  margin-top: 4px;
+}
+.ctr {
+  flex: 1;
+  text-align: center;
+  padding: 8px 4px;
+  border-radius: 6px;
+  border: 1px solid var(--s200);
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.ctr .n {
+  font-size: 18px;
+  font-weight: 800;
+}
+.ctr .l {
+  font-size: 8px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}
+/* ── Recommendation Box ── */
+.reco {
+  background: var(--s50);
+  border: 1.5px solid var(--s200);
+  border-radius: 8px;
+  padding: 10px 14px;
+}
+.reco ol {
+  list-style: none;
+  counter-reset: s;
+  font-size: 11px;
+  color: var(--s600);
+}
+.reco li {
+  counter-increment: s;
+  display: flex;
+  gap: 8px;
+  margin-bottom: 4px;
+}
+.reco li:last-child {
+  margin-bottom: 0;
+}
+.reco li::before {
+  content: counter(s);
+  width: 18px;
+  height: 18px;
+  border-radius: 5px;
+  background: var(--blue);
+  color: white;
+  font-size: 10px;
+  font-weight: 700;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  margin-top: 1px;
+  print-color-adjust: exact;
+  -webkit-print-color-adjust: exact;
+}
+.reco li strong {
+  color: var(--s800);
+}
+/* ── Footer ── */
+.ftr {
+  padding: 8px 32px;
+  border-top: 1px solid var(--s200);
+  display: flex;
+  justify-content: space-between;
+  font-size: 9px;
+  color: var(--s400);
+}
+.ftr b {
+  color: var(--blue);
+  letter-spacing: 1px;
+}
+/* ── Print Overrides ── */
+@media print {
+  body {
+    width: 210mm;
+    height: 297mm;
+  }
+  .hdr,
+  .verdict,
+  .gauge div,
+  .p,
+  .str-list li::before,
+  .beh-bar div,
+  .ctr,
+  .reco li::before {
+    print-color-adjust: exact !important;
+    -webkit-print-color-adjust: exact !important;
+  }
+}

package/templates/.claude/skills/candidate-report/references/rubric.md ADDED Viewed

@@ -0,0 +1,76 @@
+# Benchmarking Rubric
+Reference data for `candidate-report` Step 3 (benchmark) and Step 4 (verdict).
+## Skill ratings
+Map each agent-aligned engineering standard skill against candidate evidence (CV
+or `screening.md`).
+| Rating      | Criteria                                           | Pill class |
+| ----------- | -------------------------------------------------- | ---------- |
+| **Met**     | Evidence meets or exceeds the expected proficiency | `p-p`      |
+| **Partial** | Some evidence but below expected level             | `p-a`      |
+| **Gap**     | No evidence, or clearly below expected             | `p-g`      |
+| **Unknown** | Cannot assess from available evidence              | `p-u`      |
+Apply the **two-level scepticism rule** from `req-screen`: default two levels
+below CV claims unless concrete, quantified evidence is provided.
+## Behaviour bar widths
+Map each agent-aligned behaviour to a 0–100 % width and a CSS variable based on
+evidence strength.
+| Range    | Signal          | Colour         |
+| -------- | --------------- | -------------- |
+| 60–100 % | Positive signal | `var(--green)` |
+| 30–59 %  | Partial signal  | `var(--amber)` |
+| 10–29 %  | Weak / unknown  | `var(--s300)`  |
+| 0–9 %    | Gap             | `var(--red)`   |
+## Level gauge
+Estimate the candidate's realistic level. Choose a 5-level window centred on the
+candidate's estimate and the target level.
+## Verdict
+Pick one verdict class for the report header.
+| Verdict              | Class             | When to use                                                         |
+| -------------------- | ----------------- | ------------------------------------------------------------------- |
+| Proceed              | `verdict-proceed` | Candidate benchmarks at or above target level                       |
+| Proceed with Caution | `verdict-caution` | Mixed signals; viable for scoped role or needs interview to resolve |
+| Pass                 | `verdict-pass`    | Clear misalignment with role requirements                           |
+Write a one-line headline and a brief detail sentence.
+## Template sections to populate
+Drives the placeholder substitution in Step 5.
+| Section           | Source                                               |
+| ----------------- | ---------------------------------------------------- |
+| Header            | Candidate name, title, org, location from `brief.md` |
+| Verdict           | This file's verdict table                            |
+| Snapshot          | 5–6 key facts (experience, education, source, stack) |
+| Strengths         | 3–5 bullet points — what the candidate brings        |
+| Level gauge       | Estimated vs target level                            |
+| Benchmark grid    | Top skills per capability area with pills            |
+| Behaviours        | Bar chart items with widths and colours              |
+| Coverage counters | Gap / Partial / Unknown / Met counts                 |
+| Recommendation    | 2–4 actionable next steps                            |
+| Footer            | Author name and role from `USER.md`                  |
+## A4 single-page budget
+The report **must** fit on a single A4 page (210mm × 297mm):
+- Snapshot: max 6 `<dt>`/`<dd>` pairs.
+- Strengths: max 5 `<li>`, one sentence each.
+- Benchmark grid: 4–6 rows per capability area; prioritise notable
+  gaps/strengths, omit "Unknown" rows when tight.
+- Combine small capability areas (e.g. Docs + ML) into one block.
+- Recommendation: max 4 `<li>`.
+- Test with browser print preview (Ctrl+P); cut content if it overflows.