@jakkrichm/create-nexus-devflow 2.9.0 → 2.9.3

package/dist/lib/webview-studio.js

@@ -62,9 +62,83 @@ export async function renderStudioHtml(projectRoot, options = {}) {
         `;
         }).join("")
         : `<div class="empty-state">No archived history records yet.</div>`;
-    const completedCount = currentWork.completed;
-    const totalTasks = currentWork.total;
-    const progressPercent = totalTasks > 0 ? Math.round((completedCount / totalTasks) * 100) : 0;
+    const activeRuns = status.activeRuns || [];
+    let presentHtml = "";
+    let totalActiveTasks = 0;
+    let totalActiveCompleted = 0;
+    if (activeRuns.length > 0) {
+        totalActiveTasks = activeRuns.reduce((acc, r) => acc + r.totalTasks, 0);
+        totalActiveCompleted = activeRuns.reduce((acc, r) => acc + r.completedTasks, 0);
+        presentHtml = activeRuns.map((run) => {
+            const pct = run.totalTasks > 0 ? Math.round((run.completedTasks / run.totalTasks) * 100) : 0;
+            const stageBadgeClass = (run.status || "").includes("check") ? "badge-stage stage-check" : "badge-stage";
+            const findingTag = run.hasOpenFindings
+                ? `<span class="tag tag-finding-warn">⚠ Open Findings</span>`
+                : `<span class="tag tag-finding-clean">✔ Clean</span>`;
+            return `
+        <div class="card-item active-item">
+          <div class="item-header">
+            <span class="badge-id">${escapeHtml(run.runId)}</span>
+            <span class="${stageBadgeClass}">${escapeHtml(run.status || "active")}</span>
+          </div>
+          <div class="item-title">${escapeHtml(run.title || "Living Spec")}</div>
+          <div class="progress-bar-container">
+            <div class="progress-bar-fill" style="width: ${pct}%;"></div>
+          </div>
+          <div class="item-meta">
+            <span>🌿 <code>${escapeHtml(run.branch || "main")}</code></span>
+            ${findingTag}
+          </div>
+          <div class="item-tags">
+            <span>Progress: <strong>${pct}%</strong> (${run.completedTasks}/${run.totalTasks})</span>
+            <span>Remaining: ${run.remainingTasks}</span>
+          </div>
+          <div class="card-actions">
+            <button class="btn-card-action" onclick="dispatchCommand('/implement ${escapeHtml(run.runId)}')">▶ /implement ${escapeHtml(run.runId)}</button>
+            <button class="btn-card-action" onclick="dispatchCommand('/check ${escapeHtml(run.runId)}')">🧪 /check ${escapeHtml(run.runId)}</button>
+            <button class="btn-card-action" onclick="dispatchCommand('/complete ${escapeHtml(run.runId)}')">📦 /complete ${escapeHtml(run.runId)}</button>
+          </div>
+        </div>
+      `;
+        }).join("");
+    }
+    else if (currentWork.state === "active") {
+        totalActiveTasks = currentWork.total;
+        totalActiveCompleted = currentWork.completed;
+        const progressPercent = totalActiveTasks > 0 ? Math.round((totalActiveCompleted / totalActiveTasks) * 100) : 0;
+        const runId = currentWork.runId || "ACTIVE";
+        presentHtml = `
+      <div class="card-item active-item">
+        <div class="item-header">
+          <span class="badge-id">${escapeHtml(runId)}</span>
+          <span class="badge-stage">${escapeHtml(currentWork.status || "active")}</span>
+        </div>
+        <div class="item-title">${escapeHtml(currentWork.title || "Active Spec")}</div>
+        <div class="progress-bar-container">
+          <div class="progress-bar-fill" style="width: ${progressPercent}%;"></div>
+        </div>
+        <div class="item-meta">
+          <span>Progress: <strong>${progressPercent}%</strong> (${currentWork.completed}/${currentWork.total})</span>
+          <span>Remaining: ${currentWork.remaining}</span>
+        </div>
+        <div class="card-actions">
+          <button class="btn-card-action" onclick="dispatchCommand('/implement ${escapeHtml(runId)}')">▶ /implement ${escapeHtml(runId)}</button>
+          <button class="btn-card-action" onclick="dispatchCommand('/check ${escapeHtml(runId)}')">🧪 /check ${escapeHtml(runId)}</button>
+          <button class="btn-card-action" onclick="dispatchCommand('/complete ${escapeHtml(runId)}')">📦 /complete ${escapeHtml(runId)}</button>
+        </div>
+      </div>
+    `;
+    }
+    else {
+        presentHtml = `
+      <div class="empty-state">
+        Idle workspace.<br>Run <code>/feature</code> or <code>/fix</code> to start a run.
+      </div>
+    `;
+    }
+    const presentCountLabel = activeRuns.length > 0
+        ? `${activeRuns.length} Active Runs · ${totalActiveCompleted}/${totalActiveTasks} Tasks`
+        : `${totalActiveCompleted}/${totalActiveTasks} Tasks`;
     return `<!DOCTYPE html>
 <html lang="th" data-theme="${options.theme || "auto"}">
 <head>
@@ -73,11 +147,11 @@ export async function renderStudioHtml(projectRoot, options = {}) {
   <title>Nexus-DevFlow Studio: ${escapeHtml(projectName)}</title>
   <style>
     :root {
-      --bg: var(--vscode-editor-background, #090d16);
-      --bg-panel: var(--vscode-sideBar-background, rgba(17, 24, 39, 0.75));
-      --bg-card: rgba(30, 41, 59, 0.6);
+      --bg: var(--vscode-editor-background, #070d18);
+      --bg-panel: var(--vscode-sideBar-background, rgba(15, 23, 42, 0.75));
+      --bg-card: rgba(30, 41, 59, 0.65);
       --border: var(--vscode-panel-border, rgba(255, 255, 255, 0.08));
-      --border-accent: rgba(56, 189, 248, 0.3);
+      --border-accent: rgba(56, 189, 248, 0.35);
       --fg: var(--vscode-editor-foreground, #f8fafc);
       --fg-muted: var(--vscode-descriptionForeground, #94a3b8);
       --accent: #38bdf8;
@@ -85,8 +159,9 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       --green: #4ade80;
       --yellow: #facc15;
       --red: #f87171;
-      --font-mono: var(--vscode-editor-font-family, 'Fira Code', Consolas, monospace);
-      --font-sans: var(--vscode-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
+      --violet: #a78bfa;
+      --font-mono: var(--vscode-editor-font-family, 'IBM Plex Mono', 'Fira Code', Consolas, monospace);
+      --font-sans: var(--vscode-font-family, 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
     }
 
     * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -101,7 +176,7 @@ export async function renderStudioHtml(projectRoot, options = {}) {
     }
 
     .studio-container {
-      max-width: 1200px;
+      max-width: 1280px;
       margin: 0 auto;
       display: flex;
       flex-direction: column;
@@ -125,9 +200,10 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       display: flex;
       align-items: center;
       gap: 12px;
+      flex-wrap: wrap;
     }
     .project-badge {
-      font-weight: 700;
+      font-weight: 800;
       font-size: 16px;
       background: var(--accent-gradient);
       -webkit-background-clip: text;
@@ -136,13 +212,23 @@ export async function renderStudioHtml(projectRoot, options = {}) {
     }
     .branch-pill {
       font-family: var(--font-mono);
-      font-size: 12px;
+      font-size: 11px;
       background: rgba(56, 189, 248, 0.12);
       color: var(--accent);
       padding: 3px 10px;
       border-radius: 20px;
       border: 1px solid var(--border-accent);
     }
+    .multitask-pill {
+      font-family: var(--font-mono);
+      font-size: 11px;
+      background: rgba(167, 139, 250, 0.15);
+      color: var(--violet);
+      padding: 3px 10px;
+      border-radius: 20px;
+      border: 1px solid rgba(167, 139, 250, 0.3);
+      font-weight: 700;
+    }
     .header-right {
       display: flex;
       align-items: center;
@@ -155,6 +241,7 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       padding: 4px 12px;
       border-radius: 20px;
       font-weight: 600;
+      font-size: 11px;
     }
     .badge-blocked {
       background: rgba(248, 113, 113, 0.15);
@@ -163,6 +250,7 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       padding: 4px 12px;
       border-radius: 20px;
       font-weight: 600;
+      font-size: 11px;
     }
 
     /* Quick Action Dispatcher */
@@ -170,17 +258,18 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       background: var(--bg-panel);
       border: 1px solid var(--border);
       border-radius: 10px;
-      padding: 12px 16px;
+      padding: 10px 16px;
       display: flex;
       align-items: center;
       gap: 8px;
       overflow-x: auto;
     }
     .action-label {
-      font-weight: 600;
+      font-weight: 700;
       color: var(--fg-muted);
-      font-size: 11px;
+      font-size: 10px;
       text-transform: uppercase;
+      letter-spacing: 0.08em;
       margin-right: 4px;
       white-space: nowrap;
     }
@@ -192,7 +281,7 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       border-radius: 6px;
       cursor: pointer;
       font-family: var(--font-mono);
-      font-size: 12px;
+      font-size: 11px;
       transition: all 0.2s ease;
       white-space: nowrap;
     }
@@ -238,18 +327,21 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       gap: 6px;
     }
     .col-count {
-      font-size: 11px;
+      font-size: 10px;
+      font-family: var(--font-mono);
+      font-weight: 600;
       background: var(--bg-card);
       padding: 2px 8px;
       border-radius: 10px;
       color: var(--fg-muted);
+      border: 1px solid var(--border);
     }
 
     .col-content {
       display: flex;
       flex-direction: column;
       gap: 10px;
-      max-height: 480px;
+      max-height: 520px;
       overflow-y: auto;
     }
 
@@ -269,13 +361,14 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       transform: translateY(-1px);
     }
     .card-item.active-item {
-      border-color: var(--accent);
-      box-shadow: 0 0 12px rgba(56, 189, 248, 0.15);
+      border-color: var(--border-accent);
+      box-shadow: 0 0 12px rgba(56, 189, 248, 0.12);
     }
 
     .item-header {
       display: flex;
       align-items: flex-start;
+      justify-content: space-between;
       gap: 8px;
     }
     .badge-id {
@@ -292,6 +385,22 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       background: rgba(129, 140, 248, 0.2);
       color: #818cf8;
     }
+    .badge-stage {
+      font-family: var(--font-mono);
+      font-size: 9px;
+      font-weight: 700;
+      text-transform: uppercase;
+      padding: 1px 6px;
+      border-radius: 4px;
+      background: rgba(250, 204, 21, 0.15);
+      color: var(--yellow);
+      border: 1px solid rgba(250, 204, 21, 0.3);
+    }
+    .badge-stage.stage-check {
+      background: rgba(74, 222, 128, 0.15);
+      color: var(--green);
+      border-color: rgba(74, 222, 128, 0.3);
+    }
     .item-title {
       font-weight: 600;
       font-size: 12px;
@@ -315,19 +424,50 @@ export async function renderStudioHtml(projectRoot, options = {}) {
     .item-tags, .item-meta {
       display: flex;
       align-items: center;
+      justify-content: space-between;
       gap: 6px;
       font-size: 11px;
       color: var(--fg-muted);
+      flex-wrap: wrap;
     }
     .tag {
       font-size: 10px;
       padding: 1px 6px;
       border-radius: 4px;
       background: rgba(255, 255, 255, 0.05);
+      border: 1px solid var(--border);
     }
     .tag-feasibility { color: var(--green); }
     .tag-value { color: var(--accent); }
     .tag-cat { color: var(--yellow); }
+    .tag-finding-clean { color: var(--green); }
+    .tag-finding-warn { color: var(--red); background: rgba(248, 113, 113, 0.15); border-color: rgba(248, 113, 113, 0.3); }
+
+    .card-actions {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      margin-top: 4px;
+      padding-top: 6px;
+      border-top: 1px dashed var(--border);
+      flex-wrap: wrap;
+    }
+    .btn-card-action {
+      background: rgba(255, 255, 255, 0.04);
+      border: 1px solid var(--border);
+      color: var(--fg);
+      padding: 2px 7px;
+      border-radius: 4px;
+      font-family: var(--font-mono);
+      font-size: 10px;
+      cursor: pointer;
+      transition: all 0.15s ease;
+    }
+    .btn-card-action:hover {
+      background: rgba(56, 189, 248, 0.15);
+      color: var(--accent);
+      border-color: var(--accent);
+    }
 
     .empty-state {
       text-align: center;
@@ -346,6 +486,8 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       align-items: center;
       justify-content: space-between;
       font-size: 12px;
+      flex-wrap: wrap;
+      gap: 8px;
     }
   </style>
 </head>
@@ -357,7 +499,7 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       <div class="header-left">
         <span class="project-badge">⚡ ${escapeHtml(projectName)}</span>
         <span class="branch-pill">🌿 ${escapeHtml(branch)}</span>
-        <span class="badge-track">Track: ${escapeHtml(track)}</span>
+        ${activeRuns.length > 0 ? `<span class="multitask-pill">🗂️ ${activeRuns.length} Active Workspaces</span>` : ""}
       </div>
       <div class="header-right">
         <span class="${gatePillClass}">${gatePillText}</span>
@@ -367,7 +509,6 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       </div>
     </header>
 
-
     <!-- Quick Action Bar -->
     <div class="action-bar">
       <span class="action-label">Quick Actions:</span>
@@ -375,9 +516,9 @@ export async function renderStudioHtml(projectRoot, options = {}) {
       <button class="btn-action" onclick="dispatchCommand('/implement')">/implement</button>
       <button class="btn-action" onclick="dispatchCommand('/check')">/check</button>
       <button class="btn-action" onclick="dispatchCommand('/complete')">/complete</button>
-      <button class="btn-action" onclick="dispatchCommand('nexus-devflow slice --stage implement')">slice</button>
+      <button class="btn-action" onclick="dispatchCommand('/continuous')">/continuous</button>
+      <button class="btn-action" onclick="dispatchCommand('nexus-devflow check-gate')">check-gate</button>
       <button class="btn-action" onclick="dispatchCommand('nexus-devflow drift')">drift</button>
-      <button class="btn-action" onclick="dispatchCommand('nexus-devflow reconcile --fix')">reconcile</button>
       <button class="btn-action" onclick="dispatchCommand('nexus-devflow doctor')">doctor</button>
     </div>
 
@@ -395,33 +536,14 @@ export async function renderStudioHtml(projectRoot, options = {}) {
         </div>
       </section>
 
-
       <!-- ⚡ 2. Present (Active Living Context) -->
       <section class="kanban-col">
         <div class="col-header">
           <span class="col-title">⚡ Present (Active Living Spec)</span>
-          <span class="col-count">${completedCount}/${totalTasks} Tasks</span>
+          <span class="col-count">${presentCountLabel}</span>
         </div>
         <div class="col-content">
-          ${currentWork.state === "active" ? `
-            <div class="card-item active-item">
-              <div class="item-header">
-                <span class="badge-id">${escapeHtml(currentWork.runId || "ACTIVE")}</span>
-                <span class="item-title">${escapeHtml(currentWork.title || "Active Spec")}</span>
-              </div>
-              <div class="progress-bar-container">
-                <div class="progress-bar-fill" style="width: ${progressPercent}%;"></div>
-              </div>
-              <div class="item-meta">
-                <span>Progress: ${progressPercent}%</span>
-                <span>Remaining: ${currentWork.remaining} task(s)</span>
-              </div>
-            </div>
-          ` : `
-            <div class="empty-state">
-              Idle workspace.<br>Run <code>/feature</code> or <code>/fix</code> to start a run.
-            </div>
-          `}
+          ${presentHtml}
         </div>
       </section>
 
@@ -440,8 +562,8 @@ export async function renderStudioHtml(projectRoot, options = {}) {
 
     <!-- Bottom Pulse -->
     <footer class="pulse-panel">
-      <div>Findings Blockers: <strong>${gateReport.findingsBlockers}</strong> | Total Findings: <strong>${status.findings.total}</strong></div>
-      <div>Git Drift: <strong>${driftReport.hasDrift ? "⚠ Drift Detected" : "✔ In Sync"}</strong></div>
+      <div>Findings Blockers: <strong>${gateReport.findingsBlockers}</strong> | Active Findings: <strong>${status.findings.total}</strong></div>
+      <div>Git Drift: <strong>${driftReport.hasDrift ? "⚠ Drift Detected" : "✔ In Sync"}</strong> | Workspaces: <strong>${activeRuns.length || (currentWork.state === "active" ? 1 : 0)} Active</strong></div>
     </footer>
 
   </div>

package/dist/lib/webview-studio.js.map

@@ -1 +1 @@
-{"version":3,"file":"webview-studio.js","sourceRoot":"","sources":["../../lib/webview-studio.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webview-studio.js","sourceRoot":"","sources":["../../lib/webview-studio.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakkrichm/create-nexus-devflow",
-  "version": "2.9.0",
+  "version": "2.9.3",
   "description": "Installer and workflow manager for Nexus-DevFlow agentic workflow layer.",
   "license": "MIT",
   "author": "Jakkrich",

package/template/.agents/skills/adopt/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Bring the blueprint into an existing (brownfield) codeba
 
 # adopt - bootstrap the blueprint from an existing codebase
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     existing codebase  ->  [adopt]  ->  project-plan + build-plan + coding-standards  ->  /overview  ->  normal loop

package/template/.agents/skills/audit/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Read-only code audit for a Blueprint project, except for
 
 # audit - review code quality against the project standards
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /implement or /autopilot  ->  [audit]  ->  fixes or /complete

package/template/.agents/skills/autopilot/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Optional explicit Blueprint mode for one bounded spec/bu
 
 # autopilot - optional Blueprint loop
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /status  ->  [autopilot]  ->  review packet  ->  /complete

package/template/.agents/skills/check/SKILL.md

@@ -6,6 +6,10 @@ argument-hint: "[{run-id, number, or name}]"
 
 # check - Dual-Axis Independent Verification Engine
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /implement  ->  [check]  ->  /complete

package/template/.agents/skills/ci/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Set up or normalize automatic GitHub checks for a Bluepr
 
 # ci - set up automatic GitHub checks
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /onboard or /adopt  ->  [ci]  ->  Verify locally  ->  GitHub runs Verify

package/template/.agents/skills/complete/SKILL.md

@@ -6,6 +6,10 @@ argument-hint: "[{run-id, number, or name}]"
 
 # complete - log the finished work, make the work commit, and deliver
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /feature, /fix, or /rollback  ->  /implement  ->  [complete]  ->  next
@@ -70,7 +74,9 @@ and records the exact target feature, archive, commit, and parent.
 **Archive resolved findings.** If `devflow/context/{xxx-slug}/findings.md` holds any
 findings, append a `## Findings` section to the archive file just written with
 every `closed`, `accepted`, or `invalid` entry at its final status (`accepted`
-entries keep their recorded reason).
+entries keep their recorded reason). Do not archive or remove a `fixed` finding
+at any severity; repaired findings must remain in the ledger until an `/audit`
+re-review closes them.
 
 **Clean up run workspace.** Delete the task directory `devflow/context/{xxx-slug}/`. In Pure Multi-Run architecture, completed work leaves zero residual stubs in `devflow/context/`.
 

package/template/.agents/skills/continuous/SKILL.md

@@ -6,6 +6,10 @@ argument-hint: "[{resume, max-features, or start-feature}]"
 
 # continuous - Complete the Build Plan One Local Feature at a Time
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
 ```text

package/template/.agents/skills/debug/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Diagnose a failing test, broken build, crash, error, reg
 
 # debug - 6-Phase Scientific Debugging Protocol
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     reported failure  ->  [debug]  ->  /fix or /implement

package/template/.agents/skills/discovery/SKILL.md

@@ -8,6 +8,10 @@ argument-hint: "[{title, request, IDEA-xxx, or discovery-id}]"
 
 $ARGUMENTS
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 `/discovery` is the central discovery entry point in Nexus-DevFlow. It operates in two adaptive modes based on input scope:
 1. **🗺️ Macro Project Discovery**: Develops high-level product and build roadmap plans (`devflow/project-plan.md` & `devflow/build-plan.md`) through an adaptive conversation before `/overview`.
 2. **🔍 Micro Feature Exploration (Pre-Flight)**: Explores a specific feature, request, or idea before committing to delivery, routes through supporting lenses, and finishes with a visible `Proceed`, `Defer`, or `Reject` decision before `/feature` or `/fix`.
@@ -72,10 +76,10 @@ devflow/discoveries/{DISCOVERY_ID}-{slug}/discovery.md
 5. **Socratic Grilling & Domain Alignment Lens (`grill`)**:
    - Codebase-grounded interactive inquiry to clarify entity boundaries, data flows, and edge cases.
    - Record agreed terminology in `devflow/context/glossary.md` and major architecture decisions in `devflow/decisions/ADR-xxx-{slug}.md`.
-6. **🎨 Visual Architecture & Diagram Design Lens (`diagram-design`)**:
-   - When exploring system topologies, legacy IT modernizations, sequence flows, data platform pipelines, or user journeys, check if the third-party skill `diagram-design` is installed in `.agents/skills/diagram-design/`.
-   - If available: Read `.agents/skills/diagram-design/SKILL.md` and load the matching type reference (e.g. `references/type-architecture.md`, `references/type-data-flow.md`, `references/type-sequence.md`, `references/type-journey.md`).
-   - Strictly follow the genuine design rules: editorial palette, style guide gate, target density 4/10, and self-contained HTML/SVG output.
+6. **🎨 Visual Architecture & Diagram Design Lens (`archify` / `diagram-design`)**:
+   - When exploring system topologies, legacy IT modernizations, sequence flows, data platform pipelines, state machines, or user journeys, check for `archify` or `diagram-design` in `.agents/skills/`.
+   - **For interactive system architecture, dataflows, state transitions, and sequence traces**: Use `archify` (`.agents/skills/archify/SKILL.md`) to compile validated interactive HTML artifacts with dark/light themes, motion, and route probes.
+   - **For editorial, business, quadrant, or broad diagram types**: Use `diagram-design` (`.agents/skills/diagram-design/SKILL.md`).
    - Save diagram artifacts to `devflow/discoveries/{DISCOVERY_ID}-{slug}/diagrams/{name}.html` and reference them directly in `discovery.md`.
 
 ### Decision & Approval Gate:

package/template/.agents/skills/feature/SKILL.md

@@ -6,6 +6,10 @@ argument-hint: "[{number, name, DISC-id, or IDEA-id}]"
 
 # feature - turn a build-plan feature into a buildable spec
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     project-overview.md  +  build-plan.md  ->  [this skill]  ->  build

package/template/.agents/skills/fix/SKILL.md

@@ -6,6 +6,10 @@ argument-hint: "[{title or issue-description}]"
 
 # fix - document an ad-hoc fix, then build it like anything else
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /fix  ->  /implement  ->  /complete  ->  back to your features

package/template/.agents/skills/implement/SKILL.md

@@ -6,6 +6,10 @@ argument-hint: "[{run-id, number, or name}]"
 
 # implement - build the target spec, one reviewed step at a time
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     /feature, /fix, or /rollback  ->  [implement]  ->  /complete  ->  next

package/template/.agents/skills/onboard/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Set up the Blueprint after overlaying it onto a freshly
 
 # onboard - finish the Blueprint overlay setup
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     scaffold app  ->  overlay Blueprint  ->  [onboard]  ->  project-plan + build-plan  ->  /overview

package/template/.agents/skills/overview/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Distill user-owned planning docs into `devflow/context/p
 
 # overview - dynamic project overview compiler
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 ## Position in workflow
 
 ```text

package/template/.agents/skills/prototype/SKILL.md

@@ -5,6 +5,10 @@ description: "[devflow] Interactively prototype the look of a project. Asks abou
 
 # prototype - lock the look before you build
 
+**First action:** Before project inspection, preflight, or any other tool call,
+publish `running` to `devflow/.state/run.json` using the dashboard activity
+contract in `AGENTS.md`.
+
 Where this sits in the workflow:
 
     plan  ->  /overview  ->  [prototype]  ->  /feature  ->  build