opencastle 0.10.0 → 0.10.2

package/src/cli/update.ts

@@ -1,10 +1,14 @@
 import { resolve } from 'node:path'
 import { readFile } from 'node:fs/promises'
 import { readManifest, writeManifest } from './manifest.js'
-import { confirm, closePrompts, c } from './prompt.js'
+import { multiselect, confirm, closePrompts, c } from './prompt.js'
 import { isLegacyStack, migrateStackConfig, IDE_LABELS } from './types.js'
+import { TECH_PLUGINS, TEAM_PLUGINS } from '../orchestrator/plugins/index.js'
 import { IDE_ADAPTERS, VALID_IDES } from './adapters/index.js'
-import type { CliContext, IdeChoice } from './types.js'
+import { getRequiredMcpEnvVars, updateSkillMatrixFile } from './stack-config.js'
+import { rebuildMcpConfig } from './mcp.js'
+import { detectRepoInfo, mergeStackIntoRepoInfo } from './detect.js'
+import type { CliContext, IdeChoice, TechTool, TeamTool, StackConfig } from './types.js'
 
 export default async function update({
   pkgRoot,
@@ -41,47 +45,193 @@ export default async function update({
   ) as { version: string }
 
   const dryRun = args.includes('--dry-run')
+  const forceFlag = args.includes('--force')
+  const reconfigureFlag = args.includes('--reconfigure')
 
-  if (manifest.version === pkg.version && !args.includes('--force') && !dryRun) {
+  const hasVersionUpdate = manifest.version !== pkg.version || forceFlag
+  let wantsReconfigure = reconfigureFlag
+
+  // If no version update and no --reconfigure, offer reconfigure option
+  if (!hasVersionUpdate && !wantsReconfigure && !dryRun) {
     console.log(`  Already up to date (v${pkg.version}).`)
+    wantsReconfigure = await confirm(
+      'Would you like to change your stack selections?',
+      false
+    )
+    if (!wantsReconfigure) {
+      closePrompts()
+      return
+    }
+  }
+
+  // ── Detect repo info ────────────────────────────────────────────
+  const repoInfo = await detectRepoInfo(projectRoot)
+
+  // ── Reconfigure stack if requested ──────────────────────────────
+  const oldStack = manifest.stack
+  let newStack: StackConfig | undefined = manifest.stack
+  let stackChanged = false
+  let addedTools: string[] = []
+  let removedTools: string[] = []
+
+  if (wantsReconfigure) {
+    const detectedTools = new Set([
+      ...(repoInfo.cms ?? []),
+      ...(repoInfo.databases ?? []),
+      ...(repoInfo.deployment ?? []),
+      ...(repoInfo.monorepo ? [repoInfo.monorepo] : []),
+      ...((repoInfo.frameworks ?? []).map((f) => (f === 'next' ? 'nextjs' : f))),
+    ])
+
+    const currentTech = new Set(oldStack?.techTools ?? [])
+    const currentTeam = new Set(oldStack?.teamTools ?? [])
+
+    console.log(`\n  ${c.bold('── Tech Tools ────────────────────────────────')}`)
+    const techTools = await multiselect(
+      'Which tools does your project use?',
+      TECH_PLUGINS.map((p) => ({
+        label: p.label,
+        hint: p.hint,
+        value: p.id,
+        selected: oldStack
+          ? currentTech.has(p.id as TechTool)
+          : p.preselected || detectedTools.has(p.id),
+      }))
+    )
+
+    console.log(`  ${c.bold('── Team Tools ────────────────────────────────')}`)
+    const teamTools = await multiselect(
+      'Which team tools do you use?',
+      TEAM_PLUGINS.map((p) => ({
+        label: p.label,
+        hint: p.hint,
+        value: p.id,
+        selected: oldStack
+          ? currentTeam.has(p.id as TeamTool)
+          : !!p.preselected,
+      }))
+    )
+
+    newStack = {
+      ides: ides as IdeChoice[],
+      techTools: techTools as TechTool[],
+      teamTools: teamTools as TeamTool[],
+    }
+
+    // Compute diff
+    const newTechSet = new Set(techTools)
+    const newTeamSet = new Set(teamTools)
+    const techChanged = !sameSet(currentTech as Set<string>, newTechSet)
+    const teamChanged = !sameSet(currentTeam as Set<string>, newTeamSet)
+    stackChanged = techChanged || teamChanged
+
+    if (stackChanged) {
+      const oldAll: string[] = [
+        ...(oldStack?.techTools ?? []),
+        ...(oldStack?.teamTools ?? []),
+      ]
+      const newAll: string[] = [...techTools, ...teamTools]
+      addedTools = newAll.filter((t) => !oldAll.includes(t))
+      removedTools = oldAll.filter((t) => !newAll.includes(t))
+    }
+  }
+
+  // Nothing to do?
+  if (!hasVersionUpdate && !stackChanged) {
+    console.log(`  No changes to apply.`)
+    closePrompts()
     return
   }
 
-  const ideNames = ides.map((id) => IDE_LABELS[id as IdeChoice] ?? id).join(', ')
-  console.log(
-    `\n  🏰 ${c.bold('OpenCastle')} ${dryRun ? 'dry-run' : 'update'}: ${c.dim(`v${manifest.version}`)} → ${c.green(`v${pkg.version}`)}\n`
-  )
+  // ── Summary ─────────────────────────────────────────────────────
+  const ideNames = ides
+    .map((id) => IDE_LABELS[id as IdeChoice] ?? id)
+    .join(', ')
+
+  if (hasVersionUpdate) {
+    console.log(
+      `\n  🏰 ${c.bold('OpenCastle')} ${dryRun ? 'dry-run' : 'update'}: ${c.dim(`v${manifest.version}`)} → ${c.green(`v${pkg.version}`)}\n`
+    )
+  } else {
+    console.log(
+      `\n  🏰 ${c.bold('OpenCastle')} ${dryRun ? 'dry-run' : 'reconfigure'} ${c.dim(`v${pkg.version}`)}\n`
+    )
+  }
+
   console.log(`  IDEs: ${c.cyan(ideNames)}`)
-  console.log(`  ${c.dim('Framework files will be overwritten.')}`)
-  console.log(`  ${c.dim('Customization files will be preserved.')}\n`)
 
+  if (stackChanged) {
+    if (addedTools.length > 0) {
+      console.log(`  ${c.green('+')} Adding: ${addedTools.join(', ')}`)
+    }
+    if (removedTools.length > 0) {
+      console.log(`  ${c.red('−')} Removing: ${removedTools.join(', ')}`)
+    }
+  } else if (newStack) {
+    if (newStack.techTools.length > 0) {
+      console.log(`  Tech: ${c.green(newStack.techTools.join(', '))}`)
+    }
+    if (newStack.teamTools.length > 0) {
+      console.log(`  Team: ${c.green(newStack.teamTools.join(', '))}`)
+    }
+  }
+
+  if (hasVersionUpdate) {
+    console.log(`  ${c.dim('Framework files will be overwritten.')}`)
+    console.log(`  ${c.dim('Customization files will be preserved.')}`)
+  }
+  console.log()
+
+  // ── Dry run ─────────────────────────────────────────────────────
   if (dryRun) {
     console.log(`  ${c.dim('[dry-run]')} Framework files that would be updated:\n`)
     for (const p of manifest.managedPaths?.framework ?? []) {
       console.log(`    ${c.yellow('↻')} ${p}`)
     }
-    console.log(`\n  ${c.dim('[dry-run]')} Customization files that would be preserved:\n`)
+    console.log(
+      `\n  ${c.dim('[dry-run]')} Customization files that would be preserved:\n`
+    )
     for (const p of manifest.managedPaths?.customizable ?? []) {
       console.log(`    ${c.green('✓')} ${p}`)
     }
+    if (stackChanged) {
+      console.log()
+      if (addedTools.length > 0) {
+        console.log(
+          `  ${c.dim('[dry-run]')} Skills to add: ${addedTools.join(', ')}`
+        )
+      }
+      if (removedTools.length > 0) {
+        console.log(
+          `  ${c.dim('[dry-run]')} Skills to remove: ${removedTools.join(', ')}`
+        )
+      }
+      console.log(`  ${c.dim('[dry-run]')} Skill matrix would be updated`)
+      console.log(`  ${c.dim('[dry-run]')} MCP config would be rebuilt`)
+    }
     console.log(`\n  ${c.dim('No files were written.')}\n`)
+    closePrompts()
     return
   }
 
-  const proceed = await confirm('Proceed with update?')
+  const proceed = await confirm('Proceed?')
   if (!proceed) {
     console.log('  Aborted.')
+    closePrompts()
     return
   }
 
-  // Update each IDE
+  // ── Update each IDE ─────────────────────────────────────────────
   let totalCopied = 0
   let totalCreated = 0
-  const allManagedPaths = { framework: [] as string[], customizable: [] as string[] }
+  const allManagedPaths = {
+    framework: [] as string[],
+    customizable: [] as string[],
+  }
 
   for (const ide of ides) {
     const adapter = await IDE_ADAPTERS[ide]()
-    const results = await adapter.update(pkgRoot, projectRoot, manifest.stack)
+    const results = await adapter.update(pkgRoot, projectRoot, newStack)
     totalCopied += results.copied.length
     totalCreated += results.created.length
 
@@ -90,23 +240,72 @@ export default async function update({
     allManagedPaths.customizable.push(...managed.customizable)
   }
 
-  // Refresh repo research on update
-  const { detectRepoInfo, mergeStackIntoRepoInfo } = await import('./detect.js')
-  const repoInfo = await detectRepoInfo(projectRoot)
+  // ── Handle stack changes ────────────────────────────────────────
+  if (stackChanged && newStack) {
+    // Update skill matrix for each IDE
+    for (const ide of ides) {
+      await updateSkillMatrixFile(projectRoot, ide, newStack)
+    }
 
-  // Update manifest
-  manifest.version = pkg.version
+    // Rebuild MCP configs for each IDE
+    for (const ide of ides) {
+      await rebuildMcpConfig(projectRoot, ide as IdeChoice, newStack, repoInfo)
+    }
+  }
+
+  // ── Update manifest ─────────────────────────────────────────────
+  if (hasVersionUpdate) manifest.version = pkg.version
   manifest.ides = ides
   manifest.updatedAt = new Date().toISOString()
   manifest.managedPaths = allManagedPaths
-  manifest.repoInfo = manifest.stack
-    ? mergeStackIntoRepoInfo(repoInfo, manifest.stack)
+  if (newStack) manifest.stack = newStack
+  manifest.repoInfo = newStack
+    ? mergeStackIntoRepoInfo(repoInfo, newStack)
     : repoInfo
   await writeManifest(projectRoot, manifest)
 
-  console.log(`\n  ${c.green('✓')} Updated ${c.bold(String(totalCopied))} framework files`)
+  // ── Results ─────────────────────────────────────────────────────
+  console.log(
+    `\n  ${c.green('✓')} Updated ${c.bold(String(totalCopied))} framework files`
+  )
   if (totalCreated > 0) {
-    console.log(`  ${c.green('+')} Created ${c.bold(String(totalCreated))} new files`)
+    console.log(
+      `  ${c.green('+')} Created ${c.bold(String(totalCreated))} new files`
+    )
+  }
+  if (stackChanged) {
+    console.log(`  ${c.green('✓')} Updated skill matrix`)
+    console.log(`  ${c.green('✓')} Rebuilt MCP config`)
+  }
+
+  // ── Env var notice for new tools ────────────────────────────────
+  if (stackChanged && newStack) {
+    const envVars = getRequiredMcpEnvVars(newStack, repoInfo)
+    if (envVars.length > 0) {
+      const oldEnvVars = oldStack
+        ? new Set(
+            getRequiredMcpEnvVars(oldStack, repoInfo).map((e) => e.envVar)
+          )
+        : new Set<string>()
+      const newEnvVars = envVars.filter((e) => !oldEnvVars.has(e.envVar))
+      if (newEnvVars.length > 0) {
+        console.log(`\n  ${c.yellow('⚠')}  New environment variables needed:\n`)
+        for (const { envVar, hint } of newEnvVars) {
+          console.log(`     ${c.bold(envVar)}`)
+          console.log(`     ${c.dim('└')} ${c.dim(hint)}\n`)
+        }
+      }
+    }
+
+    // Setup guides for newly added tools
+    if (addedTools.includes('slack')) {
+      console.log(
+        `  ${c.cyan('📖')} Slack MCP requires a Slack App with a bot token.`
+      )
+      console.log(
+        `     Setup guide: ${c.cyan('https://www.opencastle.dev/docs/plugins#slack')}\n`
+      )
+    }
   }
 
   // ── Reload window message ─────────────────────────────────────
@@ -128,3 +327,11 @@ export default async function update({
 
   closePrompts()
 }
+
+function sameSet(a: Set<string>, b: Set<string>): boolean {
+  if (a.size !== b.size) return false
+  for (const item of a) {
+    if (!b.has(item)) return false
+  }
+  return true
+}

package/src/dashboard/node_modules/.vite/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "2334c6c2",
+  "hash": "aa158bc8",
   "configHash": "30f8ea04",
-  "lockfileHash": "cf5af1b6",
-  "browserHash": "31dc1dac",
+  "lockfileHash": "09e90d1c",
+  "browserHash": "2f7bb5ff",
   "optimized": {
     "astro > cssesc": {
       "src": "../../../../../node_modules/cssesc/cssesc.js",
       "file": "astro___cssesc.js",
-      "fileHash": "432d0522",
+      "fileHash": "ea61e9a5",
       "needsInterop": true
     },
     "astro > aria-query": {
       "src": "../../../../../node_modules/aria-query/lib/index.js",
       "file": "astro___aria-query.js",
-      "fileHash": "5d3ca12d",
+      "fileHash": "401c0a39",
       "needsInterop": true
     },
     "astro > axobject-query": {
       "src": "../../../../../node_modules/axobject-query/lib/index.js",
       "file": "astro___axobject-query.js",
-      "fileHash": "4a0f4a6f",
+      "fileHash": "15390df2",
       "needsInterop": true
     }
   },

package/src/orchestrator/agents/api-designer.agent.md

@@ -20,17 +20,7 @@ You are an API designer specializing in route architecture, endpoint conventions
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **api-layer** — Route handler patterns, server-side actions, validation libraries, search API architecture
-- **framework** — Framework routing conventions, middleware, request lifecycle
-- **security** — Input validation, authentication, authorization, rate limiting
-
-## API Design Principles
-
-Load the **api-patterns** skill for comprehensive API design guidelines covering route architecture, request/response schemas, error handling, pagination, versioning, and rate limiting.
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/architect.agent.md

@@ -32,15 +32,7 @@ When reviewing plans or proposals, **challenge assumptions before implementing**
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **monorepo** — Monorepo commands, task caching, affected builds, code generation, project graph
-
-### Direct Skills
-
-- **documentation-standards** — ADR format, documentation templates
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Architecture Decision Records (ADRs)
 

package/src/orchestrator/agents/content-engineer.agent.md

@@ -19,11 +19,7 @@ You are a content engineer specializing in CMS schema design, content queries, c
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **cms** — Document types, query patterns, schema management, content modeling, search module architecture
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/copywriter.agent.md

@@ -20,15 +20,7 @@ You are a copywriter specializing in user-facing text for web applications — U
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **cms** — Content model structure, document types, and field schemas for venue descriptions
-
-### Direct Skills
-
-- **documentation-standards** — Writing guidelines and formatting rules
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Text Categories
 

package/src/orchestrator/agents/data-expert.agent.md

@@ -13,11 +13,7 @@ You are an expert in building ETL pipelines, web scrapers, data processors, and
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **data-pipeline** — Pipeline architecture, scraper patterns, data format, enrichment workflows, CLI commands, quality standards
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Critical Rules
 
@@ -32,7 +28,7 @@ Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
 - Idempotent imports with `createOrReplace` and deterministic `_id`
 - Validate with Zod before importing — never import invalid data
 - Respect `robots.txt` and rate limit all scraping requests
-- Use the project's web crawling library for concurrent crawling (see the **data-pipeline** skill)
+- Use the project's web crawling library for concurrent crawling (see the **data-engineering** skill)
 - Handle errors gracefully — skip bad records, don't halt pipeline
 - Preserve UTF-8 encoding for special characters and diacritics
 - Backup before bulk operations

package/src/orchestrator/agents/database-engineer.agent.md

@@ -20,12 +20,7 @@ You are a database engineer specializing in schema design, migrations, row-level
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **database** — Schema design, migrations, RLS policies, auth flow, role system, performance patterns
-- **security** — Security architecture, vulnerability management (database-specific concerns)
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/developer.agent.md

@@ -13,21 +13,11 @@ You are a full-stack developer specializing in building pages, components, routi
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **framework** — Framework file conventions, rendering model, routing, metadata, project structure
-- **ui-library** — Component architecture, hooks, TypeScript integration, styling patterns
-- **api-layer** — Route handlers, server-side actions, input validation, external integrations
-
-### Direct Skills
-
-- **validation-gates** — Validation gate definitions and checklist
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Mandatory Verification
 
-After code changes, always run lint, test, and build for affected projects. The **validation-gates** direct skill provides full gate definitions and checklist.
+After code changes, always run lint, test, and build for affected projects.
 
 ## Critical Rules
 

package/src/orchestrator/agents/devops-expert.agent.md

@@ -19,11 +19,7 @@ You are a DevOps expert specializing in deployments, CI/CD pipelines, cron jobs,
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **deployment** — Hosting configuration, cron jobs, build process, environment variables, security headers, caching, middleware
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/documentation-writer.agent.md

@@ -13,10 +13,7 @@ You are a technical documentation specialist. You maintain project documentation
 
 ## Skills
 
-### Direct Skills
-
-- **documentation-standards** — Templates, directory structure, writing guidelines, markdown formatting rules
-- **code-commenting** — Self-documenting code patterns, annotation tags
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Critical Rules
 

package/src/orchestrator/agents/performance-expert.agent.md

@@ -19,11 +19,7 @@ You are an expert in frontend and backend performance optimization.
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **performance** — Bundle size, code splitting, rendering, data fetching, image optimization, Core Web Vitals, profiling
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/release-manager.agent.md

@@ -20,17 +20,7 @@ You are a release manager responsible for pre-release verification, changelog ge
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **monorepo** — Affected commands, project dependencies, task execution across projects
-- **deployment** — Deployment status, build logs, rollback procedures
-
-### Direct Skills
-
-- **validation-gates** — Full verification gate definitions (lint, test, build, browser checks)
-- **documentation-standards** — Changelog format, release notes structure
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Release Process
 

package/src/orchestrator/agents/researcher.agent.md

@@ -13,10 +13,7 @@ You are a codebase exploration specialist. Your job is to **find information, ma
 
 ## Skills
 
-### Direct Skills
-
-- **context-map** — File dependency mapping and change impact analysis
-- **self-improvement** — Lessons-learned protocol, retry documentation
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Critical Rules
 

package/src/orchestrator/agents/security-expert.agent.md

@@ -9,7 +9,7 @@ tools: ["search/changes", "search/codebase", "edit/editFiles", "web/fetch", "vsc
 
 # Security Expert
 
-You are a security expert specializing in authentication, authorization, security headers, input validation, API security, and vulnerability management. Resolve technology-specific details via the **security** and **database** capability slots in the skill matrix.
+You are a security expert specializing in authentication, authorization, security headers, input validation, API security, and vulnerability management.
 
 ## Critical Rules
 
@@ -23,12 +23,7 @@ You are a security expert specializing in authentication, authorization, securit
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **security** — Security architecture, headers, CSP, auth, RLS patterns, API security, vulnerability management
-- **database** — Database-specific security (RLS policies, migrations, role system)
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/seo-specialist.agent.md

@@ -20,16 +20,7 @@ You are an SEO specialist focused on technical SEO implementation — meta tags,
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **framework** — Framework metadata API, routing conventions, rendering model (SSR/SSG/ISR)
-- **cms** — Content model structure for generating structured data from venue documents
-
-## Technical SEO Areas
-
-Load the **seo-patterns** skill for comprehensive technical SEO guidelines covering meta tags, structured data, sitemaps, URL strategy, and rendering.
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/agents/testing-expert.agent.md

@@ -9,20 +9,11 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'rea
 
 # Testing Expert
 
-You are an expert tester who validates UI changes using browser automation (resolved via the **e2e-testing** capability slot) and writes E2E/integration test suites.
+You are an expert tester who validates UI changes using browser automation and writes E2E/integration test suites.
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **e2e-testing** — Browser automation tool reference, validation checklist, regression testing, reporting patterns
-- **testing** — Test planning templates, coverage requirements, context management, common mistakes
-
-### Direct Skills
-
-- **validation-gates** — Shared validation gate definitions (deterministic checks, cache clearing, regression checks)
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Context Management
 

package/src/orchestrator/agents/ui-ux-expert.agent.md

@@ -9,24 +9,17 @@ tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'web/fetch', 'vsc
 
 # UI/UX Expert
 
-You are an expert UI/UX developer specializing in building accessible, visually consistent UI components based on a design system template. Resolve technology-specific details (component library, styling approach) via the **ui-library** capability slot in the skill matrix.
+You are an expert UI/UX developer specializing in building accessible, visually consistent UI components based on a design system template.
 
 ## Critical Rules
 
 1. **Reference the project template** for design patterns and consistency
-2. **Follow the project's styling approach** for component styles, co-located with components (see the **ui-library** skill)
+2. **Follow the project's styling approach** for component styles, co-located with components
 3. **Place shared components in the UI library** — never in app-specific directories
 
 ## Skills
 
-### Capability Slots
-
-Resolve via [skill-matrix.md](.github/customizations/agents/skill-matrix.md).
-
-- **design-system** — Design thinking, typography, color/theme, motion, spatial composition, visual quality
-- **ui-library** — Component architecture, TypeScript patterns, hooks, styling, testing
-- **accessibility** — Keyboard navigation, screen reader semantics, contrast, forms, graphics, tables
-- **e2e-testing** — Viewport resize commands and per-breakpoint checklists
+Resolve all skills (slots and direct) via [skill-matrix.json](.github/customizations/agents/skill-matrix.json).
 
 ## Guidelines
 

package/src/orchestrator/customizations/README.md

@@ -25,7 +25,8 @@ Skills reference these files with relative links like `../../customizations/stac
 | File | Purpose |
 |------|---------|
 | `agent-registry.md` | Specialist agents with model tier assignments and scope examples |
-| `skill-matrix.md` | Maps capability slots to concrete skill names per agent role |
+| `skill-matrix.json` | Maps capability slots to concrete skill names per agent role (machine-readable) |
+| `skill-matrix.md` | Documentation companion explaining the skill matrix concept |
 
 ### `stack/` — Tech stack config