@lifeaitools/rdc-skills 0.8.7

package/skills/tests/rdc-build.test.json

@@ -0,0 +1,22 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:build",
+  "description": "Build dispatches typed agents against a seeded epic; local commits allowed, push short-circuited under RDC_TEST.",
+  "fixture": {
+    "prompt": "rdc:build label=self-test-sandbox --unattended",
+    "precondition_files": [
+      {
+        "path": ".rdc/epics/self-test-sandbox.md",
+        "content": "# Epic: self-test sandbox\n\nTrivial epic used only by the Tier 2 runner. One task: touch `sandbox.txt` with a single line.\n\n## Tasks\n- [ ] Write 'hello from sandbox' to `sandbox.txt`\n"
+      }
+    ],
+    "env": { "RDC_TEST": "1" },
+    "slow": true
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 0, "message_matches": "." },
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-deploy.test.json

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:deploy",
+  "description": "Deploy in diagnose mode is read-only — registry SELECT + health probe, no Coolify mutations.",
+  "fixture": {
+    "prompt": "rdc:deploy diagnose rdc-marketing-engine",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 0 },
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-fixit.test.json

@@ -0,0 +1,21 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:fixit",
+  "description": "Fixit applies a trivial typo fix, commits locally, emits verdict.",
+  "fixture": {
+    "prompt": "rdc:fixit fix typo in sandbox README: change 'Helo' to 'Hello'",
+    "precondition_files": [
+      {
+        "path": "README.sandbox.md",
+        "content": "# Sandbox\n\nHelo world\n"
+      }
+    ],
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 1, "message_matches": "[Ff]ix" },
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-handoff.test.json

@@ -0,0 +1,14 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:handoff",
+  "description": "Handoff writes a plan doc to .rdc/plans/ and records work items via RPC; no push under RDC_TEST.",
+  "fixture": {
+    "prompt": "rdc:handoff sandbox-stub add a no-op /ping route to the sandbox app",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-overnight.test.json

@@ -0,0 +1,21 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:overnight",
+  "description": "Overnight supervisor chains preplan/plan/build/review/report in unattended mode under RDC_TEST.",
+  "fixture": {
+    "prompt": "rdc:overnight label=self-test-sandbox",
+    "precondition_files": [
+      {
+        "path": ".rdc/epics/self-test-sandbox.md",
+        "content": "# Epic: self-test sandbox\n\nSingle trivial task: write 'ok' to `sandbox.txt`.\n"
+      }
+    ],
+    "env": { "RDC_TEST": "1" },
+    "slow": true
+  },
+  "assertions": {
+    "exit_code": 0,
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-plan.test.json

@@ -0,0 +1,14 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:plan",
+  "description": "Plan produces an architecture doc and epic/task structure under RDC_TEST without pushing.",
+  "fixture": {
+    "prompt": "rdc:plan add a /health endpoint to rdc-marketing-engine --unattended",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-preplan.test.json

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:preplan",
+  "description": "Research-only preplan produces findings without committing code or creating work items.",
+  "fixture": {
+    "prompt": "rdc:preplan add a rate limiter to the clauth daemon --unattended",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 0 },
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-prototype.test.json

@@ -0,0 +1,14 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:prototype",
+  "description": "Prototype produces a JSX/TSX reference file in docs/source/ and a registry entry; local-only under RDC_TEST.",
+  "fixture": {
+    "prompt": "rdc:prototype a tiny Card component with a title prop for the sandbox",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-release.test.json

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:release",
+  "description": "Release dry-run walks the checklist; all destructive steps (tag push, publish, install, restart) short-circuit under RDC_TEST.",
+  "fixture": {
+    "prompt": "rdc:release rdc-skills --dry-run",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 0 },
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-report.test.json

@@ -0,0 +1,14 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:report",
+  "description": "Report writes a dated markdown file to .rdc/reports/ and emits a verdict line.",
+  "fixture": {
+    "prompt": "rdc:report --unattended",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-review.test.json

@@ -0,0 +1,14 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:review",
+  "description": "Review runs tsc + lint gates in read-only mode under RDC_TEST; no external writes.",
+  "fixture": {
+    "prompt": "rdc:review --unattended",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-status.test.json

@@ -0,0 +1,16 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:status",
+  "timeout_ms": 180000,
+  "description": "Status is read-only: prints kanban + health, makes no commits.",
+  "fixture": {
+    "prompt": "rdc:status",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 0 },
+    "stdout_contains": ["Recommended Next"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/tests/rdc-workitems.test.json

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 1,
+  "skill": "rdc:workitems",
+  "description": "Workitems list action is read-only — queries epics via RPC, no commits.",
+  "fixture": {
+    "prompt": "rdc:workitems epics",
+    "env": { "RDC_TEST": "1" }
+  },
+  "assertions": {
+    "exit_code": 0,
+    "commits_made": { "min": 0 },
+    "stdout_contains": ["Verdict"]
+  },
+  "teardown": { "reset_branch": true }
+}

package/skills/watch/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: rdc:watch
+description: >-
+  Usage `rdc:watch` — initialize a session log and open a browser viewer that tails Claude activity live. Zero infra, pure filesystem + static HTML.
+---
+
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
+
+
+# rdc:watch — Session Log Watcher
+
+## When to Use
+- Start of any long-running session where Dave needs visibility into what you're doing
+- Before `rdc:overnight`, `rdc:build` on a large epic, or any multi-hour grind
+- Anytime the user asks for "a log", "a viewer", "tail", or "what are you doing right now"
+
+## Procedure
+
+1. **Initialize the log and viewer.** Run the helper script from the plugin directory in the user's current project:
+   ```bash
+   node ${CLAUDE_PLUGIN_ROOT}/scripts/watch-init.mjs
+   ```
+   (If `CLAUDE_PLUGIN_ROOT` is not set, resolve the plugin path from your invocation context. On Windows it's typically `C:/Dev/rdc-skills`.)
+
+2. **Parse the output.** The script prints `run_id`, `log_path`, `current`, `viewer`, and `open_hint`. Capture `log_path` and `viewer` for the rest of the session.
+
+3. **Open the viewer in the browser.** Run the exact `open_hint` line from the script output. On Windows that's `start "" "<viewer-path>"`.
+
+4. **Report to the user.** One line:
+   ```
+   watcher live at <viewer-path> — tailing <log-path>
+   ```
+
+5. **Append one line per substantive action for the rest of the session.** Use the documented format — one line, no multi-line payloads:
+   ```
+   [<ISO-timestamp>] [<kind>] <message>
+   ```
+   Append to BOTH `<log-path>` (the full history) AND `current.log` (what the viewer polls). The viewer diffs `current.log` by length and only appends new lines.
+
+### Log format
+
+- `ISO-timestamp` — `new Date().toISOString()`
+- `kind` — one of: `dispatch`, `commit`, `test`, `error`, `note`, `banner`
+- `message` — single line, no newlines. Keep under ~200 chars.
+
+### Kinds
+
+| Kind | When to append |
+|------|----------------|
+| `dispatch` | About to dispatch a subagent — include role + epic/task id |
+| `commit` | After a git commit lands — include short sha + subject |
+| `test` | Test run kicked off or result came back |
+| `error` | Anything that failed — include what and why in one line |
+| `note` | General progress ticks (reading files, analyzing, planning) |
+| `banner` | Session start/end markers, major phase changes |
+
+### Examples
+
+```
+[2026-04-15T23:14:02.318Z] [dispatch] frontend agent → epic abc123 task 4 (rebuild DynamicForm)
+[2026-04-15T23:17:41.902Z] [commit] 3f2a1b9 feat(marketing-engine): DynamicForm rhf+zod
+[2026-04-15T23:18:05.113Z] [test] pnpm --filter @regen/rdc-marketing-engine test
+[2026-04-15T23:18:41.002Z] [error] tsc: src/components/Form.tsx:42 — Property 'foo' does not exist
+[2026-04-15T23:19:00.000Z] [note] retrying with corrected type import
+[2026-04-15T23:45:10.000Z] [banner] Phase 2 complete — moving to review
+```
+
+### Appending from bash (Windows-safe)
+
+```bash
+printf '[%s] [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" "dispatch" "your message" >> "$LOG_PATH"
+printf '[%s] [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" "dispatch" "your message" >> "$CURRENT_PATH"
+```
+
+Or from Node:
+```js
+import { appendFileSync } from "node:fs";
+const line = `[${new Date().toISOString()}] [note] ${msg}\n`;
+appendFileSync(logPath, line);
+appendFileSync(currentPath, line);
+```
+
+## Notes
+
+- Log files live in the **user's project**, not the rdc-skills repo. Path: `<projectRoot>/.rdc/session-log/`
+- Each invocation creates a **new run id** and overwrites `current.log`. Prior run logs remain on disk as `<runId>.log`.
+- The viewer is a single static HTML file polling `current.log` via `fetch()` every 2s — no server, no deps.
+- This skill does NOT replace `rdc:report` (the end-of-session Obsidian writeup). It's a live tail for attended or semi-attended sessions.

package/skills/workitems/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: rdc:workitems
+description: >-
+  Usage `rdc:workitems <action> [args]` — create, update, query work items via Supabase RPCs. Actions: add, update, done, list, epics. Use for "add to backlog", "mark done", "show open epics", any work item CRUD.
+---
+
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
+
+> **Sandbox contract:** This skill honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag. Supabase work item writes (`insert_work_item`, `update_work_item_status`, `bump_epic_version`) are skipped under `RDC_TEST=1`.
+
+
+# rdc:workitems — Work Item Management
+
+## When to Use
+- Project lead says "create a ticket", "add to backlog", "log this bug", "update status"
+- An agent needs to create or update epics/tasks during a build session
+- Checking what work is open before starting a new epic
+
+## Arguments
+
+- `rdc:workitems epics` — list open epics
+- `rdc:workitems add <title> --epic <id>` — create a task under an epic
+- `rdc:workitems update <id> --status <status>` — update a work item's status
+- `rdc:workitems done <id>` — mark a task complete
+- `rdc:workitems list <epic-id>` — list tasks in an epic
+
+## Rules
+
+1. **Epic first, always.** Never create a task without a parent epic.
+2. **Label everything.** Minimum one system label per item.
+3. **Check first.** `get_open_epics()` before creating anything new.
+4. **Link design docs.** Put `.rdc/plans/` or `.rdc/research/` paths in descriptions (fallback: `.rdc/plans/` / `.rdc/research/`).
+
+## Read Epics
+
+```sql
+SELECT get_open_epics();
+SELECT get_open_epics('urgent');
+SELECT get_open_epics(p_label_filter := 'custom-label');
+```
+
+## Create Epic
+
+```sql
+SELECT insert_work_item(
+  p_title       := 'EPIC: Clear descriptive title',
+  p_description := 'What and why. Reference .rdc/plans/<n>.md if applicable.',
+  p_item_type   := 'epic',
+  p_priority    := 'high',
+  p_labels      := ARRAY['system-label'],
+  p_source      := 'planning'
+);
+```
+
+## Create Task
+
+```sql
+SELECT insert_work_item(
+  p_title       := 'Specific actionable task title',
+  p_description := 'What: <deliverable>
+Where: <files to create/modify>
+Agent type: frontend | backend | data | design | infra | content | cs2
+Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
+Design doc: .rdc/plans/<n>.md (fallback: .rdc/plans/<n>.md, if exists)
+Depends on: <other task title if sequential>
+Est: <hours>',
+  p_parent_id   := '<epic-uuid>'::uuid,
+  p_item_type   := 'task',
+  p_priority    := 'high',
+  p_labels      := ARRAY['system-label'],
+  p_estimated_hours := 2,
+  p_source      := 'planning'
+);
+```
+
+## Update Status
+
+```sql
+SELECT update_work_item_status('<uuid>'::uuid, 'in_progress');
+SELECT update_work_item_status('<uuid>'::uuid, 'done', '["What was completed"]'::jsonb);
+SELECT update_work_item_status('<uuid>'::uuid, 'blocked', '["Why it is blocked"]'::jsonb);
+```
+
+## Read Tasks in an Epic
+
+```sql
+SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
+SELECT get_work_items_by_epic('<epic-uuid>'::uuid, 'todo');
+```
+
+## Bump Epic Version
+
+```sql
+SELECT bump_epic_version('<epic-uuid>'::uuid, '0.2.0', 'What changed', 'planning');
+```
+
+## Valid Values
+
+| Field | Values |
+|-------|--------|
+| status | `todo` `in_progress` `blocked` `review` `done` `archived` |
+| priority | `urgent` `high` `normal` `low` |
+| item_type | `epic` `task` `subtask` `bug` `spike` |
+
+## System Labels
+
+| Label | When |
+|-------|------|
+| `project-a` | Your-app-specific work |
+| `project-b` | Another app work |
+| `cs2` | Core paradigm packages |
+| `hail` | Grammar, DSL compiler |
+| `pal` | Moment windows, memory |
+| `virtue` | Virtue engine, coherence |
+| `marketing` | Outreach, campaigns |
+| `media` | Assets, R2, image pipeline |
+| `infrastructure` | CI/CD, deployment |
+| `ui` | Component library |
+| `data` | Schema, migrations |
+| `content` | Copy, messaging |
+| `website` | Public-facing sites |
+
+## Agent Type → Guide File Reference
+
+| Type | Guide | Use For |
+|------|-------|---------|
+| `frontend` | .rdc/guides/frontend.md | React, pages, UI, Tailwind |
+| `backend` | .rdc/guides/backend.md | API routes, database, auth |
+| `data` | .rdc/guides/data.md | Migrations, schema, RPC |
+| `design` | .rdc/guides/design.md | Brand, palette, OG images |
+| `infra` | .rdc/guides/infrastructure.md | CI/CD, deploy, DNS |
+| `content` | .rdc/guides/content.md | Copy, messaging, tone |
+| `cs2` | .rdc/guides/cs2.md | CS 2.0 paradigm |
+| `hail` | .rdc/guides/cs2.md + packages/hail/CLAUDE.md | Grammar, DSL |
+| `viz` | .rdc/guides/frontend.md + design.md | Custom visualizations |
+
+## What NOT to Do
+
+- Never raw INSERT/UPDATE against work items — RPC functions only
+- Never create tasks without a parent epic
+- Never leave labels empty
+- Never write vague titles ("Fix stuff") — be specific
+- Never put design intention in the task — put it in `.rdc/research/` (fallback: `.rdc/research/`) and link

package/tests/validate-skills.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+/**
+ * Validate rdc-skills skills and guides
+ *
+ * Checks:
+ * - YAML frontmatter exists and has required fields
+ * - Required sections exist (## When to Use, etc.)
+ * - Markdown is well-formed
+ *
+ * Exit codes:
+ *   0 = all valid
+ *   1 = validation failed
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const REQUIRED_FRONTMATTER = ['name', 'description'];
+const REQUIRED_SECTIONS = [
+  '## When to Use',
+  '## Procedure' // OR '## Arguments'
+];
+
+let passed = 0;
+let failed = 0;
+const errors = [];
+
+function validateFile(filePath) {
+  try {
+    const contents = fs.readFileSync(filePath, 'utf8').replace(/\r\n/g, '\n');
+    const lines = contents.split('\n');
+
+    // Check frontmatter
+    if (!lines[0].includes('---')) {
+      errors.push(`${path.basename(filePath)}: Missing YAML frontmatter start`);
+      return false;
+    }
+
+    let frontmatterEnd = -1;
+    for (let i = 1; i < lines.length; i++) {
+      if (lines[i].includes('---')) {
+        frontmatterEnd = i;
+        break;
+      }
+    }
+
+    if (frontmatterEnd === -1) {
+      errors.push(`${path.basename(filePath)}: YAML frontmatter not closed`);
+      return false;
+    }
+
+    // Parse frontmatter
+    const frontmatterLines = lines.slice(1, frontmatterEnd);
+    const frontmatter = {};
+
+    for (const line of frontmatterLines) {
+      const match = line.match(/^(\w+):\s*(.+)$/);
+      if (match) {
+        frontmatter[match[1]] = match[2];
+      }
+    }
+
+    // Check required fields
+    for (const field of REQUIRED_FRONTMATTER) {
+      if (!frontmatter[field]) {
+        errors.push(`${path.basename(filePath)}: Missing frontmatter field '${field}'`);
+        return false;
+      }
+    }
+
+    // Check required sections
+    const bodyText = lines.slice(frontmatterEnd + 1).join('\n');
+    const hasWhenToUse = bodyText.includes('## When to Use');
+    const hasProcedure = bodyText.includes('## Procedure');
+    const hasArguments = bodyText.includes('## Arguments');
+
+    if (!hasWhenToUse) {
+      errors.push(`${path.basename(filePath)}: Missing '## When to Use' section`);
+      return false;
+    }
+
+    if (!hasProcedure && !hasArguments) {
+      errors.push(`${path.basename(filePath)}: Missing '## Procedure' or '## Arguments' section`);
+      return false;
+    }
+
+    return true;
+  } catch (err) {
+    errors.push(`${path.basename(filePath)}: ${err.message}`);
+    return false;
+  }
+}
+
+function validateDirectory(dirPath, dirName) {
+  if (!fs.existsSync(dirPath)) {
+    console.log(`ℹ  ${dirName}/ directory not found (will be populated later)`);
+    return;
+  }
+
+  // Skills are in subdirectories: skills/<name>/SKILL.md
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  const skillFiles = [];
+
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      const skillMd = path.join(dirPath, entry.name, 'SKILL.md');
+      if (fs.existsSync(skillMd)) {
+        skillFiles.push({ label: `${entry.name}/SKILL.md`, filePath: skillMd });
+      }
+    } else if (entry.name.endsWith('.md')) {
+      skillFiles.push({ label: entry.name, filePath: path.join(dirPath, entry.name) });
+    }
+  }
+
+  if (skillFiles.length === 0) {
+    console.log(`ℹ  ${dirName}/ (empty — will be populated later)`);
+    return;
+  }
+
+  console.log(`\nValidating ${dirName}/`);
+  console.log('─'.repeat(40));
+
+  for (const { label, filePath } of skillFiles) {
+    if (validateFile(filePath)) {
+      console.log(`  ✓ ${label}`);
+      passed++;
+    } else {
+      console.log(`  ✗ ${label}`);
+      failed++;
+    }
+  }
+}
+
+// Main
+console.log('rdc-skills Validator');
+console.log('====================\n');
+
+const repoRoot = path.dirname(path.dirname(__filename));
+const skillsDir = path.join(repoRoot, 'skills');
+const guidesDir = path.join(repoRoot, 'guides');
+
+validateDirectory(skillsDir, 'skills');
+
+// Guides are prose docs — just check they are readable markdown files
+if (fs.existsSync(guidesDir)) {
+  const guideFiles = fs.readdirSync(guidesDir).filter(f => f.endsWith('.md'));
+  if (guideFiles.length > 0) {
+    console.log('\nValidating guides/ (readability only)');
+    console.log('─'.repeat(40));
+    for (const file of guideFiles) {
+      try {
+        fs.readFileSync(path.join(guidesDir, file), 'utf8');
+        console.log(`  ✓ ${file}`);
+        passed++;
+      } catch (err) {
+        errors.push(`${file}: ${err.message}`);
+        console.log(`  ✗ ${file}`);
+        failed++;
+      }
+    }
+  }
+}
+
+console.log('\n' + '═'.repeat(40));
+if (errors.length > 0) {
+  console.log('\nErrors:');
+  for (const err of errors) {
+    console.log(`  • ${err}`);
+  }
+}
+
+console.log(`\nResults: ${passed} passed, ${failed} failed`);
+
+if (failed === 0 && passed > 0) {
+  console.log('✓ All files valid\n');
+  process.exit(0);
+} else if (failed === 0 && passed === 0) {
+  console.log('ℹ  No files to validate (plugin base not yet populated)\n');
+  process.exit(0);
+} else {
+  console.log('✗ Validation failed\n');
+  process.exit(1);
+}