@cuewright/skills 0.2.3 → 0.3.0

package/README.md

@@ -27,8 +27,8 @@ npx @cuewright/skills init [options]
 **What it does:**
 1. Clones the framework as a git submodule at `.claude/skills/_framework/`
 2. Creates skill symlinks at `.claude/skills/<name>/` for each skill in the manifest
-3. Scaffolds `arch/project-config.md` from the framework template
-4. Creates `arch/fragments/project/`
+3. Scaffolds `cw-project/project-config.md` from the framework template
+4. Creates `cw-project/fragments/project/`
 
 **Flags:**
 
@@ -81,7 +81,7 @@ npx @cuewright/skills doctor
 ```
 ✓ Framework installed at v0.14.33
 ✓ 25/25 skills wired
-✓ arch/project-config.md found
+✓ cw-project/project-config.md found
 ✓ Target lit-browser found
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuewright/skills",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "CLI installer for the Cuewright skills framework",
   "type": "module",
   "engines": {

package/src/commands/doctor.js

@@ -110,22 +110,22 @@ export async function doctor() {
     }
   }
 
-  // 5. arch/project-config.md exists
-  const configPath = join(projectRoot, '.claude', 'skills', 'arch', 'project-config.md');
+  // 5. cw-project/project-config.md exists
+  const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
   if (!await exists(configPath)) {
     allPassed = false;
     checks.push(fail(
-      'arch/project-config.md not found',
+      'cw-project/project-config.md not found',
       'Run `cuewright init` to scaffold it, or create it manually from _framework/targets/_template/project-config-template.md.'
     ));
   } else {
-    checks.push(pass('arch/project-config.md found'));
+    checks.push(pass('cw-project/project-config.md found'));
 
     // 6. Target named in project-config exists
     const targetName = await extractTargetName(configPath);
     if (targetName) {
       const targetDir = join(frameworkDir, 'targets', targetName);
-      const projectTargetDir = join(projectRoot, '.claude', 'skills', 'arch', 'targets', targetName);
+      const projectTargetDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'targets', targetName);
 
       if (await exists(targetDir) || await exists(projectTargetDir)) {
         checks.push(pass(`Target ${targetName} found`));
@@ -134,20 +134,20 @@ export async function doctor() {
         const availableTargets = await listAvailableTargets(frameworkDir);
         checks.push(fail(
           `Target '${targetName}' not found`,
-          `Update arch/project-config.md with a valid target. Available: ${availableTargets.join(', ')}`
+          `Update cw-project/project-config.md with a valid target. Available: ${availableTargets.join(', ')}`
         ));
       }
     } else {
-      checks.push(warn('Could not read target name from arch/project-config.md'));
+      checks.push(warn('Could not read target name from cw-project/project-config.md'));
     }
   }
 
-  // 6b. arch/references/ exists
-  const referencesDir = join(projectRoot, '.claude', 'skills', 'arch', 'references');
+  // 6b. cw-project/references/ exists
+  const referencesDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'references');
   if (!await exists(referencesDir)) {
-    checks.push(warn('arch/references/ not found — skill reference files have no home. Run `cuewright update` to scaffold it.'));
+    checks.push(warn('cw-project/references/ not found — skill reference files have no home. Run `cuewright update` to scaffold it.'));
   } else {
-    checks.push(pass('arch/references/ found'));
+    checks.push(pass('cw-project/references/ found'));
   }
 
   // 7. Baseline compatibility check (if baseline present)

package/src/commands/init.js

@@ -97,21 +97,21 @@ async function freshInstall(projectRoot, frameworkDir, skillsDir, options) {
   }
 
   await scaffoldConfigIfMissing(projectRoot, frameworkDir);
-  await scaffoldArchDirectories(projectRoot);
+  await scaffoldProjectDirectories(projectRoot);
 
   console.log(chalk.green(`\nDone.`));
   console.log(`  Framework:  v${version}`);
   console.log(`  Skills wired: ${wired.length}`);
-  console.log(`  Config:     .claude/skills/arch/project-config.md`);
+  console.log(`  Config:     .claude/skills/cw-project/project-config.md`);
   console.log('');
   console.log('Next: edit project-config.md to set your target, then run /align-project-skills');
 }
 
 /**
- * Scaffold arch/project-config.md from the framework template if it does not yet exist.
+ * Scaffold cw-project/project-config.md from the framework template if it does not yet exist.
  */
 async function scaffoldConfigIfMissing(projectRoot, frameworkDir) {
-  const configPath = join(projectRoot, '.claude', 'skills', 'arch', 'project-config.md');
+  const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
   const configExists = await exists(configPath);
 
   if (configExists) {
@@ -120,25 +120,25 @@ async function scaffoldConfigIfMissing(projectRoot, frameworkDir) {
   }
 
   const templatePath = join(frameworkDir, 'targets', '_template', 'project-config-template.md');
-  const fragmentsDir = join(projectRoot, '.claude', 'skills', 'arch', 'fragments', 'project');
+  const fragmentsDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'fragments', 'project');
 
-  await mkdir(join(projectRoot, '.claude', 'skills', 'arch'), { recursive: true });
+  await mkdir(join(projectRoot, '.claude', 'skills', 'cw-project'), { recursive: true });
   await mkdir(fragmentsDir, { recursive: true });
   await copyFile(templatePath, configPath);
 
-  console.log('  Scaffolded arch/project-config.md');
+  console.log('  Scaffolded cw-project/project-config.md');
 }
 
 /**
- * Scaffold arch/references/ and arch/templates/ subdirectories if they don't exist.
+ * Scaffold cw-project/references/ and cw-project/templates/ subdirectories if they don't exist.
  * These are the project customization roots under the cw- prefix model.
  */
-async function scaffoldArchDirectories(projectRoot) {
-  const archDir = join(projectRoot, '.claude', 'skills', 'arch');
-  await mkdir(join(archDir, 'references'), { recursive: true });
-  await mkdir(join(archDir, 'templates', 'page'), { recursive: true });
-  await mkdir(join(archDir, 'templates', 'component'), { recursive: true });
-  await mkdir(join(archDir, 'templates', 'guide'), { recursive: true });
+async function scaffoldProjectDirectories(projectRoot) {
+  const projectDir = join(projectRoot, '.claude', 'skills', 'cw-project');
+  await mkdir(join(projectDir, 'references'), { recursive: true });
+  await mkdir(join(projectDir, 'templates', 'page'), { recursive: true });
+  await mkdir(join(projectDir, 'templates', 'component'), { recursive: true });
+  await mkdir(join(projectDir, 'templates', 'guide'), { recursive: true });
 }
 
 async function exists(path) {

package/src/commands/status.js

@@ -46,7 +46,7 @@ export async function status(options = {}) {
   }
 
   // Read project-config for target and governance
-  const configPath = join(projectRoot, '.claude', 'skills', 'arch', 'project-config.md');
+  const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
   const configExists = await exists(configPath);
   let targetName = null;
   let governanceRows = [];

package/src/commands/update.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { access, readFile, unlink, mkdir } from 'fs/promises';
+import { access, readFile, unlink, mkdir, rename } from 'fs/promises';
 import { join } from 'path';
 import { cwd } from 'process';
 import { readManifest, listSkills, getVersion } from '../utils/manifest.js';
@@ -16,6 +16,8 @@ export async function update(options) {
   const skillsDir = getSkillsDir(projectRoot);
   const dryRun = options.dryRun || false;
 
+  await migrateArchToCwProject(skillsDir, { dryRun });
+
   // Framework must already be installed
   const manifestPath = join(frameworkDir, 'manifest.json');
   if (!await exists(manifestPath)) {
@@ -103,13 +105,13 @@ export async function update(options) {
   // Always run legacy cleanup — catches dirs that survived the diff-based migration
   await runCleanup(skillsDir, [...newSkills], projectRoot, dryRun);
 
-  // Scaffold arch/references/ and arch/templates/ if missing
+  // Scaffold cw-project/references/ and cw-project/templates/ if missing
   if (!dryRun) {
-    const archDir = join(projectRoot, '.claude', 'skills', 'arch');
-    await mkdir(join(archDir, 'references'), { recursive: true });
-    await mkdir(join(archDir, 'templates', 'page'), { recursive: true });
-    await mkdir(join(archDir, 'templates', 'component'), { recursive: true });
-    await mkdir(join(archDir, 'templates', 'guide'), { recursive: true });
+    const projectDir = join(projectRoot, '.claude', 'skills', 'cw-project');
+    await mkdir(join(projectDir, 'references'), { recursive: true });
+    await mkdir(join(projectDir, 'templates', 'page'), { recursive: true });
+    await mkdir(join(projectDir, 'templates', 'component'), { recursive: true });
+    await mkdir(join(projectDir, 'templates', 'guide'), { recursive: true });
   }
 
   // Print changelog for the updated range
@@ -125,7 +127,7 @@ export async function update(options) {
 
   // Update version in project-config.md
   if (!dryRun) {
-    const configPath = join(projectRoot, '.claude', 'skills', 'arch', 'project-config.md');
+    const configPath = join(projectRoot, '.claude', 'skills', 'cw-project', 'project-config.md');
     await updateProjectConfigVersion(configPath, targetVersion);
   }
 
@@ -227,3 +229,17 @@ async function isRealDirectory(path) {
   const stat = await lstat(path);
   return stat.isDirectory() && !stat.isSymbolicLink();
 }
+
+export async function migrateArchToCwProject(skillsDir, { dryRun = false } = {}) {
+  const oldDir = join(skillsDir, 'arch');
+  const newDir = join(skillsDir, 'cw-project');
+  if (await exists(oldDir) && !await exists(newDir)) {
+    if (!dryRun) {
+      await rename(oldDir, newDir);
+    }
+    const verb = dryRun ? 'Would migrate' : 'Migrated';
+    console.log(`  ${verb} .claude/skills/arch/ \u2192 .claude/skills/cw-project/`);
+    return true;
+  }
+  return false;
+}

package/src/utils/project-config.js

@@ -1,7 +1,7 @@
 import { readFile, writeFile, access } from 'fs/promises';
 
 /**
- * Update the Framework Version line in arch/project-config.md.
+ * Update the Framework Version line in cw-project/project-config.md.
  * Looks for a markdown table row like: | Framework Version | v0.8.0 |
  * Updates the version value in place. No-ops if the file doesn't exist
  * or doesn't contain a recognizable version line.

package/src/utils/symlink.js

@@ -190,7 +190,7 @@ export async function cleanupLegacyDirectories(skillsDir, manifestSkillNames, pr
     const referenceFiles = entries.filter(e => e !== 'SKILL.md');
 
     if (referenceFiles.length > 0 && !dryRun) {
-      const refDir = join(projectRoot, '.claude', 'skills', 'arch', 'references', cwName);
+      const refDir = join(projectRoot, '.claude', 'skills', 'cw-project', 'references', cwName);
       try {
         await mkdir(refDir, { recursive: true });
         for (const file of referenceFiles) {
@@ -223,7 +223,7 @@ export async function cleanupLegacyDirectories(skillsDir, manifestSkillNames, pr
   // Second pass: remove broken symlinks pointing into _framework/ with no manifest match.
   // These are retired framework skills whose target directory no longer exists.
   const { join: pathJoin } = await import('path');
-  const RESERVED = new Set(['_framework', '_baseline', 'arch', 'worktrees']);
+  const RESERVED = new Set(['_framework', '_baseline', 'arch', 'cw-project', 'worktrees']);
   const cwNameSet = new Set(manifestSkillNames);
   const unprefixedSet = new Set(
     manifestSkillNames.filter(n => n.startsWith('cw-')).map(n => n.slice(3))
@@ -297,7 +297,7 @@ export async function inventorySkillsDir(skillsDir, manifestSkillNames) {
   const deadFramework = [];
   const orphaned = [];
 
-  const RESERVED = new Set(['_framework', '_baseline', 'arch', 'worktrees']);
+  const RESERVED = new Set(['_framework', '_baseline', 'arch', 'cw-project', 'worktrees']);
   const unprefixedNames = new Set(
     manifestSkillNames.filter(n => n.startsWith('cw-')).map(n => n.slice(3))
   );