@ngocsangairvds/vsaf 3.1.13 → 3.1.15

package/assets/templates/CLAUDE.md

@@ -22,7 +22,7 @@ VSAF is a meta-framework for AI-driven SDLC — not an application. It has no so
 | Code Intelligence | GitNexus (MCP) | Impact analysis, call graph, blast radius |
 | Implementation | Superpowers, Claude Code | Brainstorm, TDD execution, code review |
 
-Key directories: `.claude/` (settings + skills), `_bmad/` (BMAD workspace), `.gitnexus/` (knowledge graph index).
+Key directories: `.claude/` (settings + skills), `.vsaf/_bmad/` (BMAD workspace), `.vsaf/docs/` (artifacts), `.gitnexus/` (knowledge graph index).
 
 ---
 

package/bin/vsaf.js

@@ -104,36 +104,12 @@ function printInstallHint() {
 
   console.log(`\n  Detected OS: \x1b[36m${platform}\x1b[0m\n`);
 
-  if (platform === 'windows') {
-    console.log(`  \x1b[1m\x1b[31m[IMPORTANT]\x1b[0m PowerShell blocks npm global scripts by default.`);
-    console.log(`  Run this first (one-time, in PowerShell as Admin):\n`);
-    console.log(`    \x1b[32mSet-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned\x1b[0m\n`);
-    console.log(`  \x1b[1m\x1b[33m[Windows]\x1b[0m Recommended installation methods:\n`);
-    console.log(`  \x1b[1mOption 1: PowerShell (Admin)\x1b[0m`);
-    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);
-    console.log(`  \x1b[1mOption 2: Setup script (CMD)\x1b[0m`);
-    console.log(`    \x1b[32mscripts\\setup-vsaf.bat\x1b[0m\n`);
-    console.log(`  \x1b[1mOption 3: WSL (Windows Subsystem for Linux)\x1b[0m`);
-    console.log(`    \x1b[90mRun inside WSL terminal for full Linux compatibility:\x1b[0m`);
-    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m`);
-    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
-    console.log(`  \x1b[1mOption 4: Git Bash\x1b[0m`);
-    console.log(`    \x1b[90mIf you have Git for Windows installed:\x1b[0m`);
-    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m`);
-    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
-  } else if (platform === 'macos') {
-    console.log(`  \x1b[1m\x1b[33m[macOS]\x1b[0m Recommended installation methods:\n`);
-    console.log(`  \x1b[1mOption 1: npm global install\x1b[0m`);
-    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);
-    console.log(`  \x1b[1mOption 2: Setup script\x1b[0m`);
-    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
-  } else {
-    console.log(`  \x1b[1m\x1b[33m[Linux]\x1b[0m Recommended installation methods:\n`);
-    console.log(`  \x1b[1mOption 1: npm global install\x1b[0m`);
-    console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);
-    console.log(`  \x1b[1mOption 2: Setup script\x1b[0m`);
-    console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
-  }
+  const label = platform === 'macos' ? 'macOS' : 'Linux';
+  console.log(`  \x1b[1m\x1b[33m[${label}]\x1b[0m Recommended installation methods:\n`);
+  console.log(`  \x1b[1mOption 1: npm global install\x1b[0m`);
+  console.log(`    \x1b[32mnpm install -g ${pkg}\x1b[0m\n`);
+  console.log(`  \x1b[1mOption 2: Setup script\x1b[0m`);
+  console.log(`    \x1b[32mbash scripts/setup-vsaf.sh\x1b[0m\n`);
 
   console.log(`  After installation, you can use:\n`);
   console.log(`    \x1b[36mvsaf status\x1b[0m    # check installation`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.1.13",
+  "version": "3.1.15",
   "description": "VSAF — Agentic AI SDLC Framework. 3 integrated tools: BMAD, GitNexus, Superpowers. 2-layer review.",
   "keywords": ["claude", "claude-code", "ai", "sdlc", "framework", "bmad", "gitnexus", "superpowers"],
   "bin": {
@@ -15,8 +15,7 @@
   "files": [
     "bin/",
     "src/",
-    ".claude/skills/",
-    "_bmad/",
+    "tools/",
     "assets/"
   ],
   "license": "MIT"

package/src/global.js

@@ -1,10 +1,10 @@
 'use strict';
 const path = require('path');
 const fs = require('fs');
-const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, isWindows } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME } = require('./utils');
 
 const PKG_ROOT   = path.join(__dirname, '..');
-const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
+const SKILLS_SRC = path.join(PKG_ROOT, 'tools', 'skills');
 const SKILLS_DST = path.join(CLAUDE_HOME, 'skills');
 
 async function installGlobal() {
@@ -14,7 +14,6 @@ async function installGlobal() {
 
   installSkills();
   installBinary('gitnexus', () => exec('npm install -g gitnexus'));
-  if (isWindows) ensureLadybugDbWindows();
   setupGitnexusMcp();
 
   console.log('\n\x1b[32m\x1b[1m✓ Global infra ready.\x1b[0m\n');
@@ -33,22 +32,16 @@ function installSkills() {
   fs.mkdirSync(SKILLS_DST, { recursive: true });
 
   let installed = 0;
-  let skipped   = 0;
 
   for (const entry of fs.readdirSync(SKILLS_SRC, { withFileTypes: true })) {
     const src = path.join(SKILLS_SRC, entry.name);
     const dst = path.join(SKILLS_DST, entry.name);
 
-    if (fs.existsSync(dst)) {
-      skipped++;
-      continue;
-    }
-
     entry.isDirectory() ? copyDir(src, dst) : copyFile(src, dst);
     installed++;
   }
 
-  ok(`${installed} skill(s) installed, ${skipped} already present`);
+  ok(`${installed} skill(s) installed/updated`);
 }
 
 // ── Binary helpers ───────────────────────────────────────────────────────────
@@ -62,33 +55,6 @@ function installBinary(name, installFn) {
     : warn(`${name} install failed — run manually`);
 }
 
-function ensureLadybugDbWindows() {
-  step('LadybugDB native binding (Windows)');
-
-  try {
-    const npmRoot = require('child_process')
-      .execSync('npm root -g', { encoding: 'utf8', shell: true }).trim();
-    const nativePath = path.join(npmRoot, 'gitnexus', 'node_modules', '@ladybugdb', 'core', 'lbugjs.node');
-    if (fs.existsSync(nativePath)) {
-      ok('LadybugDB native binding present (lbugjs.node)');
-      return;
-    }
-    warn('LadybugDB native binding missing — installing @ladybugdb/core-win32-x64...');
-    const gitnexusDir = path.join(npmRoot, 'gitnexus');
-    if (exec('npm install @ladybugdb/core-win32-x64 --no-save', { cwd: gitnexusDir })) {
-      ok('LadybugDB native binding installed');
-    } else {
-      warn('Could not install LadybugDB binding. Run manually:');
-      warn('  cd "' + gitnexusDir + '"');
-      warn('  npm install @ladybugdb/core-win32-x64 --no-save');
-    }
-  } catch {
-    warn('Could not verify LadybugDB binding — if gitnexus analyze fails at 60%, run:');
-    info('  npm root -g   (find global node_modules path)');
-    info('  cd <path>\\gitnexus && npm install @ladybugdb/core-win32-x64 --no-save');
-  }
-}
-
 function setupGitnexusMcp() {
   step('GitNexus MCP');
   if (!hasCommand('claude')) {
@@ -96,17 +62,10 @@ function setupGitnexusMcp() {
     return;
   }
 
-  if (isWindows) {
-    info('Configuring GitNexus MCP for Windows...');
-    exec('claude mcp add gitnexus -- cmd /c npx -y gitnexus@latest mcp')
-      ? ok('GitNexus MCP configured (Windows)')
-      : warn('MCP setup failed — run manually: claude mcp add gitnexus -- cmd /c npx -y gitnexus@latest mcp');
-  } else {
-    info('Configuring GitNexus MCP...');
-    exec('claude mcp add gitnexus -- npx -y gitnexus@latest mcp')
-      ? ok('GitNexus MCP configured')
-      : warn('MCP setup failed — run manually: claude mcp add gitnexus -- npx -y gitnexus@latest mcp');
-  }
+  info('Configuring GitNexus MCP...');
+  exec('claude mcp add gitnexus -- npx -y gitnexus@latest mcp')
+    ? ok('GitNexus MCP configured')
+    : warn('MCP setup failed — run manually: claude mcp add gitnexus -- npx -y gitnexus@latest mcp');
 }
 
 module.exports = { installGlobal };

package/src/project.js

@@ -1,12 +1,12 @@
 'use strict';
 const path = require('path');
 const fs   = require('fs');
-const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, isWindows } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, copyDir, copyFile } = require('./utils');
 
 const PKG_ROOT  = path.join(__dirname, '..');
 const TEMPLATES = path.join(PKG_ROOT, 'assets', 'templates');
-const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
-const BMAD_SRC = path.join(PKG_ROOT, '_bmad');
+const SKILLS_SRC = path.join(PKG_ROOT, 'tools', 'skills');
+const BMAD_SRC = path.join(PKG_ROOT, 'tools', 'bmad');
 const CWD       = process.cwd();
 
 async function installProject() {
@@ -49,7 +49,7 @@ function scaffoldFiles() {
       ok(`${dst} — already exists, skipped`);
     } else {
       copyFile(src, dstAbs);
-      if (chmod && !isWindows) fs.chmodSync(dstAbs, chmod);
+      if (chmod) fs.chmodSync(dstAbs, chmod);
       ok(`${dst} — created`);
     }
   }
@@ -60,7 +60,7 @@ function scaffoldFiles() {
 function scaffoldBmadWorkspace() {
   step('BMAD workspace');
 
-  const bmadDst = path.join(CWD, '_bmad');
+  const bmadDst = path.join(CWD, '.vsaf', '_bmad');
   if (!fs.existsSync(BMAD_SRC)) {
     warn('Packaged _bmad not found — skipping BMAD workspace scaffold');
   } else if (fs.existsSync(bmadDst)) {
@@ -71,11 +71,11 @@ function scaffoldBmadWorkspace() {
   }
 
   const outputDirs = [
-    path.join(CWD, 'docs', 'project'),
-    path.join(CWD, 'docs', 'project', 'srs'),
-    path.join(CWD, 'docs', 'project', 'testcases'),
-    path.join(CWD, 'docs', 'project', 'planning-artifacts'),
-    path.join(CWD, 'docs', 'project', 'implementation-artifacts'),
+    path.join(CWD, '.vsaf', 'docs'),
+    path.join(CWD, '.vsaf', 'docs', 'srs'),
+    path.join(CWD, '.vsaf', 'docs', 'testcases'),
+    path.join(CWD, '.vsaf', 'docs', 'planning-artifacts'),
+    path.join(CWD, '.vsaf', 'docs', 'implementation-artifacts'),
   ];
 
   let created = 0;
@@ -116,7 +116,6 @@ function syncLocalBmadSkills() {
   ];
 
   let installed = 0;
-  let skipped = 0;
 
   for (const targetRoot of targets) {
     fs.mkdirSync(targetRoot, { recursive: true });
@@ -125,23 +124,18 @@ function syncLocalBmadSkills() {
       const src = path.join(SKILLS_SRC, entry.name);
       const dst = path.join(targetRoot, entry.name);
 
-      if (fs.existsSync(dst)) {
-        skipped++;
-        continue;
-      }
-
       entry.isDirectory() ? copyDir(src, dst) : copyFile(src, dst);
       installed++;
     }
   }
 
-  ok(`${installed} BMAD skill copy(ies), ${skipped} already present`);
+  ok(`${installed} BMAD skill(s) installed/updated`);
 }
 
 function initGitNexus() {
   step('GitNexus');
   if (!hasCommand('gitnexus')) { warn('gitnexus not found — run: vsaf global'); return; }
-  const analyzeCmd = 'gitnexus analyze';
+  const analyzeCmd = 'gitnexus analyze --skip-git';
   info('Indexing repository (gitnexus analyze)...');
   exec(analyzeCmd, { cwd: CWD }) ? ok('Repository indexed') : warn('gitnexus analyze failed — run manually');
 }

package/src/status.js

@@ -15,8 +15,8 @@ async function showStatus() {
   console.log('\n\x1b[1mProject  (current repo)\x1b[0m');
   checkPath('.claude/settings.json', 'Project settings');
   checkPath('CLAUDE.md',             'Workflow rules');
-  checkPath('_bmad',                 'BMAD workspace');
-  checkPath('docs/project',          'Project artifact folder');
+  checkPath('.vsaf/_bmad',           'BMAD workspace');
+  checkPath('.vsaf/docs',            'Project artifact folder');
   checkProjectSkillDir('.claude/skills', 'Project BMAD skills (.claude)');
   checkProjectSkillDir('.codex/skills',  'Project BMAD skills (.codex)');
   checkPath('.gitnexus',             'GitNexus index');

package/src/utils.js

@@ -11,22 +11,14 @@ const info = (msg) => console.log(`  \x1b[36m→\x1b[0m ${msg}`);
 const warn = (msg) => console.log(`  \x1b[33m!\x1b[0m ${msg}`);
 const step = (msg) => console.log(`\n\x1b[1m${msg}\x1b[0m`);
 
-const isWindows = process.platform === 'win32';
-
 function hasCommand(cmd) {
-  // Try --version first (works on most CLIs across all platforms)
-  const versionCheck = spawnSync(cmd, ['--version'], { stdio: 'ignore', shell: isWindows });
+  // Try --version first (works on most CLIs)
+  const versionCheck = spawnSync(cmd, ['--version'], { stdio: 'ignore', shell: false });
   if (versionCheck.status === 0) return true;
 
   // Fallback: check if command exists on PATH
-  if (isWindows) {
-    // 'where' is a native Windows command; run as a single string via shell
-    const whereCheck = spawnSync(`where "${cmd}"`, { stdio: 'ignore', shell: true });
-    return whereCheck.status === 0;
-  } else {
-    const pathCheck = spawnSync('sh', ['-c', `command -v "${cmd}"`], { stdio: 'ignore', shell: false });
-    return pathCheck.status === 0;
-  }
+  const pathCheck = spawnSync('sh', ['-c', `command -v "${cmd}"`], { stdio: 'ignore', shell: false });
+  return pathCheck.status === 0;
 }
 
 function exec(cmd, opts = {}) {
@@ -62,9 +54,8 @@ function hasGitCommits() {
 }
 
 function getPlatform() {
-  if (process.platform === 'win32') return 'windows';
   if (process.platform === 'darwin') return 'macos';
   return 'linux';
 }
 
-module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, isWindows, getPlatform, hasGitCommits };
+module.exports = { ok, info, warn, step, hasCommand, exec, copyDir, copyFile, CLAUDE_HOME, getPlatform, hasGitCommits };

package/src/workflow.js

@@ -2,7 +2,7 @@
 
 const path = require('path');
 const fs = require('fs');
-const { ok, info, warn, step, hasCommand, exec, isWindows, hasGitCommits } = require('./utils');
+const { ok, info, warn, step, hasCommand, exec, hasGitCommits } = require('./utils');
 
 function preflightCheck() {
   // Check: is this a git repo?
@@ -22,24 +22,6 @@ function preflightCheck() {
     return false;
   }
 
-  // Check (Windows): is LadybugDB native binding present?
-  if (isWindows) {
-    try {
-      const npmRoot = require('child_process')
-        .execSync('npm root -g', { encoding: 'utf8', shell: true }).trim();
-      const lbugNode = path.join(npmRoot, 'gitnexus', 'node_modules', '@ladybugdb', 'core', 'lbugjs.node');
-      if (!fs.existsSync(lbugNode)) {
-        warn('LadybugDB native binding missing (lbugjs.node).');
-        warn('gitnexus analyze will fail at 60% without it.');
-        info('Fix: run this in CMD:');
-        info('  cd "' + path.join(npmRoot, 'gitnexus') + '"');
-        info('  npm install @ladybugdb/core-win32-x64 --no-save');
-        info('Then retry: vsaf index');
-        return false;
-      }
-    } catch { /* can't check, proceed anyway */ }
-  }
-
   return true;
 }
 
@@ -116,23 +98,7 @@ function runServe() {
 }
 
 function printAnalyzeHint() {
-  if (isWindows) {
-    warn('Windows troubleshooting:');
-    warn('');
-    warn('  [Most common] PowerShell blocks npm global scripts (.ps1).');
-    warn('  Use CMD instead of PowerShell, or prefix with cmd /c:');
-    warn('');
-    warn('    cmd /c gitnexus analyze');
-    warn('');
-    info('  Other options:');
-    info('    - Run via npx:   npx gitnexus analyze');
-    info('    - Use Git Bash:  bash -c "gitnexus analyze"');
-    info('    - Use WSL:       wsl -- bash -c "cd $(wslpath -a .) && gitnexus analyze"');
-    info('    - Or fix PowerShell permanently (Admin):');
-    info('        Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned');
-  } else {
-    info('Try running manually:  gitnexus analyze --verbose');
-  }
+  info('Try running manually:  gitnexus analyze --verbose');
 }
 
 module.exports = { runIndex, runReview, runClean, runServe };

package/{.claude → tools}/skills/vsaf-build/SKILL.md

@@ -34,9 +34,9 @@ Implement code strictly following PRD, SRS, and testcases, one task at a time, w
   ```
 
 ### Step 1 — Read PRD + SRS + testcase (mandatory — must read all 3 fully)
-- Read the PRD file in `docs/project/planning-artifacts/` — understand WHY and WHAT
-- Read the SRS file in `docs/project/srs/` — understand HOW, FRs/NFRs
-- Read the testcase file in `docs/project/testcases/` — understand acceptance criteria
+- Read the PRD file in `.vsaf/docs/planning-artifacts/` — understand WHY and WHAT
+- Read the SRS file in `.vsaf/docs/srs/` — understand HOW, FRs/NFRs
+- Read the testcase file in `.vsaf/docs/testcases/` — understand acceptance criteria
 - Confirm FR/NFR → testcase mapping before starting
 - If a gap is found (FR/NFR without testcase, or testcase contradicts SRS): NOTIFY USER before continuing
 - **Do NOT start coding without having read all 3 documents**

package/{.claude → tools}/skills/vsaf-discover/SKILL.md

@@ -21,14 +21,14 @@ Thoroughly understand the domain, market, user needs, and technical feasibility
 ### Step 1 — Domain Research
 - Use skill `bmad-domain-research` to deep dive into the domain/industry
 - Output: terminology, business rules, regulatory constraints, domain patterns
-- Save to `docs/project/planning-artifacts/domain-research-[topic].md`
+- Save to `.vsaf/docs/planning-artifacts/domain-research-[topic].md`
 
 ### Step 2 — Market Research
 - Use skill `bmad-market-research` to analyze:
   - Competition landscape: who is doing what, strengths/weaknesses
   - Customer needs: pain points, underserved segments
   - Market trends: which directions are growing
-- Save to `docs/project/planning-artifacts/market-research-[topic].md`
+- Save to `.vsaf/docs/planning-artifacts/market-research-[topic].md`
 
 ### Step 3 — Technical Feasibility
 - Use skill `bmad-technical-research` to assess:
@@ -36,12 +36,12 @@ Thoroughly understand the domain, market, user needs, and technical feasibility
   - Integration constraints
   - Performance/scale requirements
   - Build vs buy decisions
-- Save to `docs/project/planning-artifacts/tech-research-[topic].md`
+- Save to `.vsaf/docs/planning-artifacts/tech-research-[topic].md`
 
 ### Step 4 — Product Brief
 - Use skill `bmad-product-brief` to synthesize findings into a product brief
 - Product brief = summary of: what problem, for whom, what solution, why now
-- Save to `docs/project/planning-artifacts/product-brief-[name].md`
+- Save to `.vsaf/docs/planning-artifacts/product-brief-[name].md`
 
 ### Step 5 — PRFAQ Challenge (Working Backwards)
 - Use skill `bmad-prfaq` to stress-test the product concept
@@ -55,7 +55,7 @@ Thoroughly understand the domain, market, user needs, and technical feasibility
 - PRD includes: vision, goals, FRs, NFRs, epics, user stories, success metrics
 - After creation: use skill `bmad-validate-prd` to validate the PRD meets standards
 - If validation FAILs: John will use `bmad-edit-prd` to fix issues immediately
-- Save to `docs/project/planning-artifacts/prd-[name].md`
+- Save to `.vsaf/docs/planning-artifacts/prd-[name].md`
 
 ### Step 7 — Multi-agent Review (Party Mode)
 - Use skill `bmad-party-mode` to organize a roundtable:
@@ -69,11 +69,11 @@ Thoroughly understand the domain, market, user needs, and technical feasibility
 ## Discovery Complete: [product/domain]
 
 ### Research artifacts
-- Domain research:  docs/project/planning-artifacts/domain-research-[topic].md
-- Market research:  docs/project/planning-artifacts/market-research-[topic].md
-- Tech research:    docs/project/planning-artifacts/tech-research-[topic].md
-- Product brief:    docs/project/planning-artifacts/product-brief-[name].md
-- PRD:              docs/project/planning-artifacts/prd-[name].md
+- Domain research:  .vsaf/docs/planning-artifacts/domain-research-[topic].md
+- Market research:  .vsaf/docs/planning-artifacts/market-research-[topic].md
+- Tech research:    .vsaf/docs/planning-artifacts/tech-research-[topic].md
+- Product brief:    .vsaf/docs/planning-artifacts/product-brief-[name].md
+- PRD:              .vsaf/docs/planning-artifacts/prd-[name].md
 
 ### Key findings
 - [3-5 bullet point summary]

package/{.claude → tools}/skills/vsaf-doc-prd/SKILL.md

@@ -14,7 +14,7 @@ Must have run `/vsaf-plan` and have its output before running this skill.
 ## Steps
 
 ### Step 0 — Determine mode: Create or Edit
-- Check if a PRD already exists in `docs/project/planning-artifacts/` for this feature
+- Check if a PRD already exists in `.vsaf/docs/planning-artifacts/` for this feature
 - **If none exists** → Mode: CREATE (create from scratch)
 - **If one exists** → Mode: EDIT (edit based on feedback/changes)
   - Ask user: "A PRD already exists. Do you want to create a new one from scratch or edit the existing one?"
@@ -25,7 +25,7 @@ Must have run `/vsaf-plan` and have its output before running this skill.
 - Use skill `bmad-agent-pm` (John) to guide the PRD creation process from `/vsaf-plan` output
 - John will call skill `bmad-create-prd` to generate a standard PRD
 - PRD must include: vision, goals, FRs, NFRs, epics, user stories, success metrics, scope, out-of-scope, assumptions
-- Save to `docs/project/planning-artifacts/prd-[feature].md`
+- Save to `.vsaf/docs/planning-artifacts/prd-[feature].md`
 
 #### Mode EDIT:
 - Use skill `bmad-edit-prd` to edit the existing PRD
@@ -43,7 +43,7 @@ Must have run `/vsaf-plan` and have its output before running this skill.
 ## PRD Created/Updated
 
 ### File
-- docs/project/planning-artifacts/prd-[feature].md
+- .vsaf/docs/planning-artifacts/prd-[feature].md
 - Mode: [CREATE / EDIT]
 - Validation: [PASS / FAIL — details if fail]
 

package/{.claude → tools}/skills/vsaf-doc-srs/SKILL.md

@@ -15,9 +15,9 @@ Analyze the PRD and write a feature-level SRS following a standard template —
 
 ## Configuration
 ```yaml
-outputDir: docs/project/srs
-featureTemplate: _bmad/bmm/1-analysis/bmad-document-project/templates/srs-feature-template.md
-systemTemplate: _bmad/bmm/1-analysis/bmad-document-project/templates/srs-system-template.md
+outputDir: .vsaf/docs/srs
+featureTemplate: .vsaf/_bmad/bmm/1-analysis/bmad-document-project/templates/srs-feature-template.md
+systemTemplate: .vsaf/_bmad/bmm/1-analysis/bmad-document-project/templates/srs-system-template.md
 ```
 
 ## Steps
@@ -27,7 +27,7 @@ systemTemplate: _bmad/bmm/1-analysis/bmad-document-project/templates/srs-system-
 Before starting, check if the user has provided sufficient information:
 
 **Required:**
-- [ ] PRD document (file path or content) — typically at `docs/project/planning-artifacts/prd-[feature].md`
+- [ ] PRD document (file path or content) — typically at `.vsaf/docs/planning-artifacts/prd-[feature].md`
 - [ ] Figma link (URL figma.com/design/...) — if available
 
 If PRD is missing, **stop immediately** and request from the user:
@@ -48,7 +48,7 @@ Only continue when the PRD is available.
 ---
 
 ### Step 1 — Determine mode: Create or Edit
-- Check if an SRS already exists in `docs/project/srs/` for this feature
+- Check if an SRS already exists in `.vsaf/docs/srs/` for this feature
 - **If none exists** → Mode: CREATE
 - **If one exists** → Mode: EDIT
   - Ask user: "An SRS already exists. Do you want to create a new one from scratch or edit the existing one?"
@@ -104,7 +104,7 @@ After this step, output a **"Gap Analysis Report"** and ask the user if they wan
 
 ### Step 4 — Write SRS following the Feature Template
 
-Read the template at `_bmad/bmm/1-analysis/bmad-document-project/templates/srs-feature-template.md` and write the SRS **strictly following the template structure**, including all 12 sections (0-11):
+Read the template at `.vsaf/_bmad/bmm/1-analysis/bmad-document-project/templates/srs-feature-template.md` and write the SRS **strictly following the template structure**, including all 12 sections (0-11):
 
 0. **Preamble** — Document information, change log table, approval table
 1. **Introduction** — Objectives, scope, reference documents
@@ -140,14 +140,14 @@ Read the template at `_bmad/bmm/1-analysis/bmad-document-project/templates/srs-f
 ---
 
 ### Step 6 — Save SRS file
-Save the SRS document to: `docs/project/srs/SRS-[project-name]-[FR-ID]-[feature-name]-v1.0.md`
+Save the SRS document to: `.vsaf/docs/srs/SRS-[project-name]-[FR-ID]-[feature-name]-v1.0.md`
 
 ### Step 7 — Output to user
 ```
 ## SRS Created/Updated
 
 ### File
-- docs/project/srs/SRS-[project-name]-[FR-ID]-[feature-name]-v1.0.md
+- .vsaf/docs/srs/SRS-[project-name]-[FR-ID]-[feature-name]-v1.0.md
 - Mode: [CREATE / EDIT]
 - Use Cases written: [N]
 - Validation: [PASS / FAIL — details if fail]
@@ -159,7 +159,7 @@ Save the SRS document to: `docs/project/srs/SRS-[project-name]-[FR-ID]-[feature-
 - [SRS sections still containing {{...}} that need additional input]
 
 ## Next step
-Run /vsaf-test docs/project/srs/SRS-[...].md to generate testcases
+Run /vsaf-test .vsaf/docs/srs/SRS-[...].md to generate testcases
 ```
 
 ## Notes

package/{.claude → tools}/skills/vsaf-docs/SKILL.md

@@ -29,7 +29,7 @@ Ensure documentation is always up to date and AI agents have sufficient context.
 ### Step 2 — Generate project documentation
 - Use skill `bmad-document-project` to generate/update project docs
 - Output: architecture description, module breakdown, API endpoints, data flows
-- Save to `docs/project/`
+- Save to `.vsaf/docs/`
 
 ### Step 3 — Generate project context for AI
 - Use skill `bmad-generate-project-context` to create `project-context.md`

package/{.claude → tools}/skills/vsaf-onboard/SKILL.md

@@ -38,8 +38,8 @@ Build a full mental model of the project before touching any code.
 - Identify: hot symbols (many callers), risk areas (high fan-out)
 
 ### Step 7 — Read project documentation + synthesize
-- Read `docs/project/planning-artifacts/` to find PRDs, ADRs, architecture docs
-- Read `docs/project/srs/` to find existing SRS documents
+- Read `.vsaf/docs/planning-artifacts/` to find PRDs, ADRs, architecture docs
+- Read `.vsaf/docs/srs/` to find existing SRS documents
 - Synthesize all findings into a project overview
 
 ### Step 8 — Output to user

package/{.claude → tools}/skills/vsaf-plan/SKILL.md

@@ -33,7 +33,7 @@ Fully understand the requirement, analyze impact, and determine the implementati
 - Use skill `bmad-agent-architect` to propose an architecture approach
 - Compare alternatives, choose the most suitable approach
 - **If risk is HIGH or > 3 modules**: use skill `bmad-create-architecture` to create a formal ADR (Architecture Decision Record)
-  - Save to `docs/project/planning-artifacts/adr-[feature].md`
+  - Save to `.vsaf/docs/planning-artifacts/adr-[feature].md`
 
 ### Step 4 — Dual Brainstorm
 

package/{.claude → tools}/skills/vsaf-retro/SKILL.md

@@ -91,4 +91,4 @@ Date: [YYYY-MM-DD]
 - Retro must be data-backed — do not accept "I feel like..." without evidence
 - If GitNexus index is stale: run `vsaf index` before the retro
 - Action items must be actionable and have an owner — do not write vague "improve testing"
-- Save retro output to `docs/project/implementation-artifacts/retro-[sprint].md` to track historical data
+- Save retro output to `.vsaf/docs/implementation-artifacts/retro-[sprint].md` to track historical data

package/{.claude → tools}/skills/vsaf-ship/SKILL.md

@@ -10,7 +10,7 @@ Multi-layer review, verify scope, validate architecture, push PR. Ensure code ha
 
 ## Prerequisites
 - Have run `/vsaf-build` with PRD + SRS + testcase
-- Have run `/vsaf-test run` — results file exists at `docs/project/testcases/[feature]-results.md`
+- Have run `/vsaf-test run` — results file exists at `.vsaf/docs/testcases/[feature]-results.md`
 - Ship gate from `/vsaf-test run` = PASS
 - No failing tests
 
@@ -78,7 +78,7 @@ git push origin feature/<name>
 ```
 PR description must include:
 - Impact summary (from GitNexus detect_changes)
-- Test results file path: `docs/project/testcases/[feature]-results.md`
+- Test results file path: `.vsaf/docs/testcases/[feature]-results.md`
 - Adversarial triage: MUST FIX: 0, SHOULD FIX: N, NOTED: N
 - Shape check result
 
@@ -98,7 +98,7 @@ PR description must include:
 ### PR
 - Branch: feature/[name]
 - PR: [link]
-- Test results: docs/project/testcases/[feature]-results.md
+- Test results: .vsaf/docs/testcases/[feature]-results.md
 
 ## Next step
 - Run /vsaf-retro if this is the end of a sprint/epic

package/{.claude → tools}/skills/vsaf-sprint/SKILL.md

@@ -33,7 +33,7 @@ Manage backlog and sprints for the project — break PRD/SRS into stories, creat
   - Prioritize stories (MoSCoW or WSJF)
   - Assign stories to sprint based on capacity
   - Identify dependencies between stories
-- Save sprint plan to `docs/project/planning-artifacts/sprint-plan.md`
+- Save sprint plan to `.vsaf/docs/planning-artifacts/sprint-plan.md`
 
 #### Step 3 — Output
 ```
@@ -94,12 +94,12 @@ Or: /vsaf-plan <story description> to start the first feature
 #### Step 1 — Create story file
 - Use skill `bmad-create-story` with story ID from the sprint plan
 - Story file includes: full context, acceptance criteria, technical notes, dependencies
-- Save to `docs/project/planning-artifacts/stories/story-[id].md`
+- Save to `.vsaf/docs/planning-artifacts/stories/story-[id].md`
 
 #### Step 2 — Output
 ```
 ## Story Created: [story title]
-- File: docs/project/planning-artifacts/stories/story-[id].md
+- File: .vsaf/docs/planning-artifacts/stories/story-[id].md
 
 ### Next step
 Run /vsaf-plan <story description> to plan implementation