Summary

• What broke: bun run check:bundled-skill reports all 20 nested skill files as missing on Windows, even though bundled-skill.ts correctly embeds them. As a result, bun run validate fails on Windows.
• When it started: PR feat(cli): setup overhaul + archon doctor + complete bundled skill #1566 (merged to dev) — added scripts/check-bundled-skill.ts and wired it into the validate pipeline.
• Severity: major (blocks bun run validate for any Windows contributor on dev)

Steps to Reproduce

1. Check out dev on a Windows machine (PR feat(cli): setup overhaul + archon doctor + complete bundled skill #1566 merged).
2. Run bun run check:bundled-skill (or bun run validate).

Expected vs Actual

• Expected: bundled-skill.ts is up to date (21 files). exit 0
• Actual:

  bundled-skill.ts is missing these files:
    - examples\command-template.md
    - examples\dag-workflow.yaml
    - guides\cli.md
    ... (20 entries total, all with backslashes)
  

  Exit 2 in --check mode, breaking bun run validate.

Root Cause

scripts/check-bundled-skill.ts line 35 uses path.relative(), which on Windows returns paths with backslashes (examples\command-template.md). The substring check on line 41 (bundledSrc.includes(f)) then fails because bundled-skill.ts declares its imports with forward slashes (examples/command-template.md).

The single top-level skill file (SKILL.md, no separator) is the only one that passes — which is why the error lists exactly 20 files, not 21.

The bundle itself is fine; only the verifier is broken.

Suggested Fix

Normalize separators before the includes check in scripts/check-bundled-skill.ts:

const skillFiles = listSkillFiles(SKILL_ROOT)
  .map(f => f.split('\').join('/'))   // normalize for Windows
  .sort();

Apply the same normalization in the missing-files print loop so the suggested entries match what users would paste into bundled-skill.ts.

User Flow

Windows contributor       check-bundled-skill.ts            bundled-skill.ts
─────────────────────     ────────────────────────          ────────────────
runs bun run validate ──▶ listSkillFiles() returns
                          'examples\command-template.md'
                          (backslash from path.relative)
                          [X] bundledSrc.includes(f) → false
                          (file actually present with '/')
sees 20 false missing ◀── exit 2

Environment

• Platform: CLI (script invoked by bun run validate)
• Database: n/a
• Running in worktree? No
• OS: Windows 11 (PowerShell / cmd)

Logs

C:\...\Archon>bun run check:bundled-skill
$ bun run scripts/check-bundled-skill.ts --check
bundled-skill.ts is missing these files:
  - examples\command-template.md
  - examples\dag-workflow.yaml
  - guides\cli.md
  - guides\config.md
  - guides\discord.md
  - guides\github.md
  - guides\server.md
  - guides\setup.md
  - guides\slack.md
  - guides\telegram.md
  - references\authoring-commands.md
  - references\cli-commands.md
  - references\dag-advanced.md
  - references\good-practices.md
  - references\interactive-workflows.md
  - references\parameter-matrix.md
  - references\repo-init.md
  - references\troubleshooting.md
  - references\variables.md
  - references\workflow-dag.md

Impact

• Affected workflows/commands: bun run validate, bun run check:bundled-skill (CI guard added in feat(cli): setup overhaul + archon doctor + complete bundled skill #1566)
• Reproduction rate: Always (on Windows)
• Workaround available? Yes — skip check:bundled-skill and run the other validate steps individually.
• Data loss risk? No

Scope

• Package(s) likely involved: cli (the script lives at repo root under scripts/, but its purpose is verifying packages/cli/src/bundled-skill.ts)
• Module: scripts/check-bundled-skill.ts

Related

• Introduced by PR feat(cli): setup overhaul + archon doctor + complete bundled skill #1566 (merged to dev)
• Closes follow-up to Setup overhaul: binary install primary, dead-simple wizard, archon doctor, embedded skill (v0.3.11) #1494