@torus-engineering/tas-kit 1.12.0 → 1.14.0

package/.tas/commands/tas-init.md

@@ -4,7 +4,7 @@ Initialize TAS kit for the current project.
 
 ## Actions
 1. Need context from root/tas.yaml. If not exists, copy from .tas/tas-example.yaml to root and ask user to fill required information.
-2. Create directory structure: .tas/templates/, docs/, docs/adr/, docs/epics/, docs/bugs/
+2. Create directory structure: .tas/templates/, docs/, docs/adr/, docs/epics/, docs/bugs/, docs/ref/
 3. Create root/project-status.yaml file with initial state (artifacts, epics, adrs all empty).
 4. Copy default templates to .tas/templates/ if not exist.
 5. If project type is brownfield and codebase_scan_on_init = true:

package/README.md

@@ -1,6 +1,6 @@
 # TAS Kit
 
-**Torus Agentic SDLC Kit** — AI-assisted SDLC toolkit, designed following Spec-Driven Development philosophy and Context-Aware Architecture.
+TAS Kit - Turbo Agentic SDLC toolkit for modern AI-first software teams.
 
 ---
 
@@ -33,8 +33,8 @@ All code starts from spec. Story.md is "context digest" that has absorbed all in
 - When coding: MUST start new session (don't reuse old session that loaded PRD/SAD to avoid Window Context bloat)
 
 ### Role-Based & Template-Driven
-- 3 actual roles at Torus: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
-- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per Torus standards
+- 3 roles: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
+- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per team standards
 - Flow configurable via `tas.yaml` file
 
 ### Azure DevOps Compatible
@@ -329,6 +329,14 @@ tas.yaml      Flow configuration template (edit this for your project)
 
 ---
 
-## Documentation
+## Changelog
 
-See `.tas/README.md` after install for detailed documentation.
+### v1.14.0
+- Support 4 Agentic Coding Platforms: Claude Code, Cursor, Codex, Antigravity
+- Compress kit size — refactor commands, skills, rules to only include what's truly necessary
+- Remove legacy agent and skill files
+
+### v1.11.x
+- Drop Claude Code branding from kit artifacts
+- Set real Azure DevOps project_id in config
+- Translate all documentation to English

package/bin/cli.js

@@ -6,7 +6,7 @@ const command = args[0];
 
 function printHelp() {
   console.log(`
-tas-kit — Torus Agentic SDLC Kit installer
+tas-kit — Turbo Agentic SDLC Kit installer
 
 Usage:
   npx @torus-engineering/tas-kit <command> [options]

package/lib/adapters/antigravity.js

@@ -55,9 +55,9 @@ export async function install({ tasDir, target }) {
     console.log('  [ok] .agents/rules/ (from .tas/rules/)');
   }
 
-  // lean AGENTS.md
-  await generateAgentsMd(agentsDir, target);
-  console.log('  [ok] AGENTS.md');
+  // platform index (not root AGENTS.md — that's the template/system prompt)
+  await generateReadme(agentsDir);
+  console.log('  [ok] .agents/README.md');
 }
 
 async function commandToWorkflow(file, agentsDir) {
@@ -95,7 +95,7 @@ async function convertRules(rulesDir, outDir) {
   }
 }
 
-async function generateAgentsMd(agentsDir, target) {
+async function generateReadme(agentsDir) {
   const workflowFiles = (await fs.readdir(agentsDir, { withFileTypes: true }))
     .filter(e => e.isFile() && e.name.endsWith('.md'))
     .map(e => `- \`/${e.name.replace('.md', '')}\``);
@@ -112,10 +112,8 @@ async function generateAgentsMd(agentsDir, target) {
     }
   }
 
-  const agentsMd = [
-    `# Project Instructions`,
-    ``,
-    `This project uses TAS Kit — Torus Agentic SDLC Kit.`,
+  const readme = [
+    `# TAS Kit — Antigravity`,
     ``,
     `## Workflows`,
     ``,
@@ -127,11 +125,7 @@ async function generateAgentsMd(agentsDir, target) {
     ``,
     ...skillLines,
     ``,
-    `## Project Configuration`,
-    ``,
-    `See \`tas.yaml\` for project settings and project instructions file for detailed conventions.`,
-    ``,
   ].join('\n');
 
-  await fs.writeFile(path.join(target, 'AGENTS.md'), agentsMd);
+  await fs.writeFile(path.join(agentsDir, 'README.md'), readme);
 }

package/lib/adapters/codex.js

@@ -52,9 +52,9 @@ export async function install({ tasDir, target }) {
     console.log('  [ok] .codex/skills/ (rules)');
   }
 
-  // lean AGENTS.md
-  await generateAgentsMd(skillsOut, target);
-  console.log('  [ok] AGENTS.md');
+  // platform index (not root AGENTS.md — that's the template/system prompt)
+  await generateReadme(skillsOut, codexDir);
+  console.log('  [ok] .codex/README.md');
 }
 
 async function commandToSkill(file, skillsOut) {
@@ -129,7 +129,7 @@ async function rulesToSkills(rulesDir, skillsOut) {
   }
 }
 
-async function generateAgentsMd(skillsOut, target) {
+async function generateReadme(skillsOut, codexDir) {
   const skillDirs = await fs.readdir(skillsOut, { withFileTypes: true });
   const skillLines = [];
   for (const d of skillDirs.filter(e => e.isDirectory())) {
@@ -142,22 +142,16 @@ async function generateAgentsMd(skillsOut, target) {
     }
   }
 
-  const agentsMd = [
-    `# Project Instructions`,
-    ``,
-    `This project uses TAS Kit — Torus Agentic SDLC Kit.`,
+  const readme = [
+    `# TAS Kit — Codex`,
     ``,
     `## Available Skills`,
     ``,
-    `Use \`/skills\` to list and invoke skills. Available skills:`,
+    `Use \`/skills\` to list and invoke skills:`,
     ``,
     ...skillLines,
     ``,
-    `## Project Configuration`,
-    ``,
-    `See \`tas.yaml\` for project settings and \`CLAUDE.md\` for detailed instructions.`,
-    ``,
   ].join('\n');
 
-  await fs.writeFile(path.join(target, 'AGENTS.md'), agentsMd);
+  await fs.writeFile(path.join(codexDir, 'README.md'), readme);
 }

package/lib/install.js

@@ -10,6 +10,25 @@ const TAS_SRC = path.join(PACKAGE_DIR, '.tas');
 const PLATFORMS_FILE = '.tas/platforms.json';
 const require = createRequire(import.meta.url);
 
+// ─── Logo ────────────────────────────────────────────────────────────────────
+
+function printLogo() {
+  const c = '\x1b[36m';
+  const d = '\x1b[90m';
+  const r = '\x1b[0m';
+  const art = [
+    `  ████████╗  █████╗ ███████╗   ██╗  ██╗ ██╗ ████████╗`,
+    `  ╚══██╔══╝ ██╔══██╗██╔════╝   ██║ ██╔╝ ██║ ╚══██╔══╝`,
+    `     ██║    ███████║███████╗   █████╔╝  ██║    ██║   `,
+    `     ██║    ██╔══██║╚════██║   ██╔═██╗  ██║    ██║   `,
+    `     ██║    ██║  ██║███████║   ██║  ██╗ ██║    ██║   `,
+    `     ╚═╝    ╚═╝  ╚═╝╚══════╝   ╚═╝  ╚═╝ ╚═╝    ╚═╝   `,
+  ].map(l => c + l + r).join('\n');
+  process.stdout.write('\n' + art + '\n' + d + '  Turbo Agentic SDLC Kit' + r + '\n\n');
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
 async function getDeletedFiles() {
   try {
     const manifest = require('./deleted-files.json');
@@ -57,30 +76,152 @@ async function copyDir(src, dest) {
   await fs.cp(src, dest, { recursive: true });
 }
 
+const TAS_ROOT_EXCLUDE = new Set([
+  'tas-example.yaml',
+  'project-status-example.yaml',
+  'platforms.json',
+  'agents',
+  'commands',
+  'skills',
+  'README.md',
+]);
+
+async function copyTasDir(src, dest) {
+  await fs.cp(src, dest, {
+    recursive: true,
+    filter: (srcPath) => !TAS_ROOT_EXCLUDE.has(path.relative(src, srcPath)),
+  });
+}
+
+async function chmodExecutables(target) {
+  const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
+  if (await exists(adoPy)) await fs.chmod(adoPy, 0o755);
+
+  const preCommit = path.join(target, '.tas', 'hooks', 'pre-commit');
+  if (await exists(preCommit)) await fs.chmod(preCommit, 0o755);
+
+  const hooksDir = path.join(target, '.tas', '_platform', 'hooks');
+  if (await exists(hooksDir)) {
+    const files = await fs.readdir(hooksDir);
+    for (const f of files) await fs.chmod(path.join(hooksDir, f), 0o755);
+  }
+}
+
 // ─── Platform selection ───────────────────────────────────────────────────────
 
-async function choosePlatforms({ yes, forced }) {
-  if (forced && forced.length > 0) return forced;
-  if (yes) return ['claude-code'];
+async function checkboxSelect(title, items, defaultIndexes = [0]) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return fallbackTextSelect(title, items, defaultIndexes);
+  }
+
+  const selected = new Set(defaultIndexes);
+  let cursor = defaultIndexes[0] ?? 0;
+  let renderedLines = 0;
+
+  const clearRendered = () => {
+    if (renderedLines > 0) {
+      process.stdout.write(`\x1b[${renderedLines}A\x1b[0J`);
+    }
+  };
+
+  const render = () => {
+    clearRendered();
+    const lines = [];
+    lines.push(`  ${title}`);
+    lines.push('');
+    for (let i = 0; i < items.length; i++) {
+      const mark = selected.has(i) ? '\x1b[32m◉\x1b[0m' : '○';
+      const arrow = cursor === i ? '\x1b[36m›\x1b[0m' : ' ';
+      const label = cursor === i ? `\x1b[36m${items[i].label}\x1b[0m` : items[i].label;
+      const note = items[i].note ? ` \x1b[90m${items[i].note}\x1b[0m` : '';
+      lines.push(`  ${arrow} ${mark} ${label}${note}`);
+    }
+    lines.push('');
+    lines.push('\x1b[90m  ↑↓ navigate   space select   enter confirm\x1b[0m');
+    renderedLines = lines.length;
+    process.stdout.write(lines.join('\n') + '\n');
+  };
+
+  return new Promise((resolve) => {
+    process.stdout.write('\x1b[?25l');
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    render();
+
+    const onKey = (key) => {
+      if (key === '\x03') {
+        finish(null);
+        process.exit(0);
+      } else if (key === '\x1b[A') {
+        cursor = (cursor - 1 + items.length) % items.length;
+        render();
+      } else if (key === '\x1b[B') {
+        cursor = (cursor + 1) % items.length;
+        render();
+      } else if (key === ' ') {
+        if (selected.has(cursor)) selected.delete(cursor);
+        else selected.add(cursor);
+        render();
+      } else if (key === '\r' || key === '\n') {
+        const ids = items.filter((_, i) => selected.has(i)).map(it => it.id);
+        finish(ids.length > 0 ? ids : [items[cursor].id]);
+      }
+    };
+
+    const finish = (result) => {
+      process.stdin.removeListener('data', onKey);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdout.write('\x1b[?25h');
+      clearRendered();
+      if (result) {
+        const labels = result.map(id => items.find(it => it.id === id)?.label || id).join(', ');
+        process.stdout.write(`  Platforms: \x1b[36m${labels}\x1b[0m\n\n`);
+        resolve(result);
+      }
+    };
+
+    process.stdin.on('data', onKey);
+  });
+}
 
-  console.log('\n  Agentic Coding Platform(s) to install:');
-  PLATFORMS.forEach((p, i) => {
-    const def = p.id === 'claude-code' ? ' (default)' : '';
-    console.log(`    [${i + 1}] ${p.label}${def}`);
+async function fallbackTextSelect(title, items, defaultIndexes) {
+  console.log(`\n  ${title}`);
+  items.forEach((item, i) => {
+    const def = defaultIndexes.includes(i) ? ' (default)' : '';
+    console.log(`    [${i + 1}] ${item.label}${def}`);
   });
   console.log('');
   console.log('  Enter numbers comma-separated for multiple platforms.');
-  const answer = await ask('  Choose [1/2/3/4] (default: 1): ', '1');
+  const nums = items.map((_, i) => i + 1).join('/');
+  const answer = await ask(`  Choose [${nums}] (default: 1): `, '1');
 
   const selected = [];
   for (const part of answer.split(',')) {
     const idx = parseInt(part.trim(), 10) - 1;
-    if (idx >= 0 && idx < PLATFORMS.length) {
-      const id = PLATFORMS[idx].id;
+    if (idx >= 0 && idx < items.length) {
+      const id = items[idx].id;
       if (!selected.includes(id)) selected.push(id);
     }
   }
-  return selected.length > 0 ? selected : ['claude-code'];
+  return selected.length > 0 ? selected : [items[defaultIndexes[0] ?? 0].id];
+}
+
+async function choosePlatforms({ yes, forced }) {
+  if (forced && forced.length > 0) return forced;
+  if (yes) return ['claude-code'];
+
+  return checkboxSelect(
+    'Agentic Coding Platform(s) to install:',
+    PLATFORMS.map(p => ({
+      id: p.id,
+      label: p.label,
+      note: p.id === 'claude-code' ? '(default)' : '',
+    })),
+    [0],
+  );
 }
 
 async function savePlatforms(target, platforms) {
@@ -240,6 +381,7 @@ async function installSecurityHook({ target, mode }) {
 // ─── Update ──────────────────────────────────────────────────────────────────
 
 export async function update({ directory, yes, securityHook, platforms: forcedPlatforms }) {
+  printLogo();
   const target = path.resolve(directory);
 
   const tasExists = await exists(path.join(target, '.tas'));
@@ -249,7 +391,7 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
     process.exit(1);
   }
 
-  console.log(`\nUpdating TAS Kit in: ${target}\n`);
+  console.log(`Updating TAS Kit in: ${target}\n`);
 
   const platforms = forcedPlatforms && forcedPlatforms.length > 0
     ? forcedPlatforms
@@ -270,7 +412,8 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
 
   const tasDest = path.join(target, '.tas');
   if (path.resolve(TAS_SRC) !== path.resolve(tasDest)) {
-    await copyDir(TAS_SRC, tasDest);
+    await copyTasDir(TAS_SRC, tasDest);
+    await fs.copyFile(path.join(PACKAGE_DIR, 'README.md'), path.join(tasDest, 'README.md'));
   }
   console.log('  [ok] .tas/ (updated)');
 
@@ -282,7 +425,7 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
     }
   }
 
-  await runPlatformAdapters(platforms, { tasDir: path.join(target, '.tas'), target });
+  await runPlatformAdapters(platforms, { tasDir: TAS_SRC, target });
 
   await savePlatforms(target, platforms);
 
@@ -294,7 +437,8 @@ export async function update({ directory, yes, securityHook, platforms: forcedPl
     await installSecurityHook({ target, mode: securityHook });
   }
 
-  console.log(`  [--] CLAUDE.md, tas.yaml, .env.example — not touched`);
+  const configFilename = platforms.includes('claude-code') ? 'CLAUDE.md' : 'AGENTS.md';
+  console.log(`  [--] ${configFilename}, tas.yaml, project-status.yaml, .env.example — not touched`);
   console.log(`
 TAS Kit updated successfully!
 
@@ -306,11 +450,12 @@ and manually merge changes into your CLAUDE.md and tas.yaml if needed.
 // ─── Install ─────────────────────────────────────────────────────────────────
 
 export async function install({ directory, yes, securityHook, platforms: forcedPlatforms }) {
+  printLogo();
   const target = path.resolve(directory);
 
   await fs.mkdir(target, { recursive: true });
 
-  console.log(`\nInstalling TAS Kit into: ${target}\n`);
+  console.log(`Installing TAS Kit into: ${target}\n`);
 
   const tasExists = await exists(path.join(target, '.tas'));
   if (tasExists && !yes) {
@@ -327,7 +472,8 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
   // Copy .tas/ (skip if installing into the package itself)
   const tasDest = path.join(target, '.tas');
   if (path.resolve(TAS_SRC) !== path.resolve(tasDest)) {
-    await copyDir(TAS_SRC, tasDest);
+    await copyTasDir(TAS_SRC, tasDest);
+    await fs.copyFile(path.join(PACKAGE_DIR, 'README.md'), path.join(tasDest, 'README.md'));
     console.log('  [ok] .tas/');
   } else {
     console.log('  [--] .tas/ (source = destination, skipped)');
@@ -335,16 +481,18 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
 
   // Platform selection
   const platforms = await choosePlatforms({ yes, forced: forcedPlatforms });
-  await runPlatformAdapters(platforms, { tasDir: path.join(target, '.tas'), target });
+  await runPlatformAdapters(platforms, { tasDir: TAS_SRC, target });
   await savePlatforms(target, platforms);
 
   // Project config files (first-time only)
-  const claudeMdTarget = path.join(target, 'CLAUDE.md');
-  if (!(await exists(claudeMdTarget))) {
-    await fs.copyFile(path.join(PACKAGE_DIR, '.tas', 'templates', 'AGENTS.md'), claudeMdTarget);
-    console.log('  [ok] CLAUDE.md (from .tas/templates/AGENTS.md)');
+  // Claude Code uses CLAUDE.md; all other platforms use AGENTS.md
+  const configFilename = platforms.includes('claude-code') ? 'CLAUDE.md' : 'AGENTS.md';
+  const configTarget = path.join(target, configFilename);
+  if (!(await exists(configTarget))) {
+    await fs.copyFile(path.join(PACKAGE_DIR, '.tas', 'templates', 'AGENTS.md'), configTarget);
+    console.log(`  [ok] ${configFilename} (from .tas/templates/AGENTS.md)`);
   } else {
-    console.log('  [--] CLAUDE.md already exists, skipped');
+    console.log(`  [--] ${configFilename} already exists, skipped`);
   }
 
   const envExampleTarget = path.join(target, '.env.example');
@@ -363,6 +511,17 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
     console.log('  [--] tas.yaml already exists, skipped');
   }
 
+  const psYamlTarget = path.join(target, 'project-status.yaml');
+  if (!(await exists(psYamlTarget))) {
+    const psSrc = path.join(PACKAGE_DIR, '.tas', 'project-status-example.yaml');
+    if (await exists(psSrc)) {
+      await fs.copyFile(psSrc, psYamlTarget);
+      console.log('  [ok] project-status.yaml (from .tas/project-status-example.yaml)');
+    }
+  } else {
+    console.log('  [--] project-status.yaml already exists, skipped');
+  }
+
   if (process.platform !== 'win32') {
     await chmodExecutables(target);
   }
@@ -375,7 +534,7 @@ export async function install({ directory, yes, securityHook, platforms: forcedP
 TAS Kit installed successfully! (Platforms: ${platformLabels})
 
 Next steps:
-  1. Edit CLAUDE.md     — add your project's tech stack and conventions
+  1. Edit ${configFilename.padEnd(10)} — add your project's tech stack and conventions
   2. Edit tas.yaml      — set project name, team and ADO config
   3. Create .env        — add AZURE_DEVOPS_PAT (see .env.example)
   4. Open your IDE      — run /tas-init to initialize your project
@@ -385,19 +544,3 @@ Docs:
   .tas/hooks/README.md     — pre-commit security hook details
   `);
 }
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-async function chmodExecutables(target) {
-  const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
-  if (await exists(adoPy)) await fs.chmod(adoPy, 0o755);
-
-  const preCommit = path.join(target, '.tas', 'hooks', 'pre-commit');
-  if (await exists(preCommit)) await fs.chmod(preCommit, 0o755);
-
-  const hooksDir = path.join(target, '.tas', '_platform', 'hooks');
-  if (await exists(hooksDir)) {
-    const files = await fs.readdir(hooksDir);
-    for (const f of files) await fs.chmod(path.join(hooksDir, f), 0o755);
-  }
-}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@torus-engineering/tas-kit",
-  "version": "1.12.0",
-  "description": "Torus Agentic SDLC Kit — Collection of commands, skills, rules, hooks, agents and workflows for modern AI-First SDLC",
+  "version": "1.14.0",
+  "description": "TAS Kit - Turbo Agentic SDLC toolkit for modern AI-first software teams.",
   "type": "module",
   "bin": {
     "tas-kit": "bin/cli.js"

package/.tas/README.md

@@ -1,334 +0,0 @@
-# TAS Kit
-
-**Torus Agentic SDLC Kit** — AI-assisted SDLC toolkit, designed following Spec-Driven Development philosophy and Context-Aware Architecture.
-
----
-
-## Purpose
-
-TAS Kit helps software development teams:
-- **Standardize SDLC process** with clear artifacts (PRD, SAD, ADR, Epic, Feature, Story)
-- **Optimize token usage** through Context Layer — invest in design phase, save in code phase
-- **Support multiple workflows**: from solo developer to full team with PE/SE/DSE roles
-- **Automate** with Hybrid and Autonomous agents operating 24/7
-
----
-
-## Design Philosophy
-
-### Spec-Driven Development
-All code starts from spec. Story.md is "context digest" that has absorbed all information from PRD, SAD, ADR, Feature. Each implementation session only needs to read CLAUDE.md + Story.md — no need to reload all artifacts.
-
-### Human-Led, AI-Powered
-- **Human-led**: Architecture decisions, design approval, code review
-- **AI-assisted**: Draft creation, implementation per spec, test execution, bug detection
-
-### Dual Mode Operation
-- **Hybrid Mode**: Developer and AI work together in session
-- **Autonomous Mode**: AI automatically develops 24/7, reports results when done
-
-### Lightweight & Context-Aware
-- Each skill < 3KB, total kit < 50KB
-- Context Layer: invest tokens in design phase to save many times in code phase
-- When coding: MUST start new session (don't reuse old session that loaded PRD/SAD to avoid Window Context bloat)
-
-### Role-Based & Template-Driven
-- 3 actual roles at Torus: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
-- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per Torus standards
-- Flow configurable via `tas.yaml` file
-
-### Azure DevOps Compatible
-- Markdown output compatible with Azure DevOps Wiki
-- Mermaid diagrams don't use `()` characters (avoid conflict with ADO syntax)
-
----
-
-## SDLC Workflow
-
-:::mermaid
-graph TD
-    subgraph Phase1["Phase 1: Discovery"]
-        PRD["/tas-prd"]
-        SAD["/tas-sad"]
-        ADR["/tas-adr"]
-        DESIGN["/tas-design"]
-        PRD -->|Product Engineer| PRD_ARTIFACT["PRD.md"]
-        PRD_ARTIFACT -->|Software Engineer| SAD
-        PRD_ARTIFACT -->|Software Engineer| ADR
-        SAD --> SAD_ARTIFACT["SAD.md"]
-        ADR --> ADR_ARTIFACT["ADR-XXX.md"]
-        PRD_ARTIFACT -->|Product Engineer| DESIGN
-        DESIGN --> DESIGN_ARTIFACT["design-spec.md"]
-    end
-
-    subgraph Phase2["Phase 2: Planning"]
-        EPIC["/tas-epic"]
-        FEATURE["/tas-feature"]
-        STORY["/tas-story"]
-        PRD_ARTIFACT -->|Product Engineer| EPIC
-        EPIC --> EPIC_ARTIFACT["Epic-XXX/"]
-        EPIC_ARTIFACT -->|Product Engineer| FEATURE
-        FEATURE --> FEATURE_ARTIFACT["Feature-XXX/"]
-        SAD_ARTIFACT --> FEATURE
-        DESIGN_ARTIFACT --> FEATURE
-        FEATURE_ARTIFACT -->|Product Engineer| STORY
-        STORY --> STORY_ARTIFACT["Story-XXX.md"]
-    end
-
-    subgraph Phase3["Phase 3: Implementation"]
-        PLAN["/tas-plan"]
-        DEV["/tas-dev"]
-        FIX["/tas-fix"]
-        APItest["/tas-apitest"]
-        E2E["/tas-e2e"]
-        FUNCTEST_WEB["/tas-functest-web"]
-        FUNCTEST_MOBILE["/tas-functest-mobile"]
-        E2E_WEB["/tas-e2e-web"]
-        E2E_MOBILE["/tas-e2e-mobile"]
-        BUG["/tas-bug"]
-        REVIEW["/tas-review"]
-        FUNctest["/tas-functest"]
-        STORY_ARTIFACT -->|Software Engineer| PLAN
-        PLAN --> STORY_ARTIFACT
-        STORY_ARTIFACT -->|AI Agent| DEV
-        DEV --> CODE["Source Code"]
-        CODE -->|Bug found| FIX
-        FIX --> CODE
-        CODE -->|Software Engineer| REVIEW
-        REVIEW --> REVIEW_ARTIFACT["Code Review Report"]
-        STORY_ARTIFACT -->|Software Engineer| APItest
-        APItest --> APITEST_ARTIFACT["API Testing Script"]
-        FUNCTEST_ARTIFACT -->|Product Engineer| E2E
-        E2E --> E2E_ARTIFACT["E2E Test Scenarios"]
-        FUNCTEST_ARTIFACT -->|Software Engineer| FUNCTEST_WEB
-        FUNCTEST_WEB --> FUNCTEST_WEB_ARTIFACT["Functional Test Web Script"]
-        FUNCTEST_ARTIFACT -->|Software Engineer| FUNCTEST_MOBILE
-        FUNCTEST_MOBILE --> FUNCTEST_MOBILE_ARTIFACT["Functional Test Mobile Script"]
-        FUNCTEST_ARTIFACT -->|Product Engineer| E2E_WEB
-        E2E_WEB --> E2E_WEB_ARTIFACT["E2E Web Test Script"]
-        FUNCTEST_ARTIFACT -->|Product Engineer| E2E_MOBILE
-        E2E_MOBILE --> E2E_MOBILE_ARTIFACT["E2E Mobile Test Script"]
-        CODE -->|Bug found| BUG
-        BUG --> BUG_ARTIFACT["Bug Report"]
-        FEATURE_ARTIFACT -->|Product Engineer| FUNctest
-        FUNctest --> FUNCTEST_ARTIFACT["Functional-Testing-Spec-FeatureXXX.md"]
-    end
-
-    subgraph Phase4["Phase 4: Quality & Deploy"]
-        SECURITY["/tas-security"]
-        PIPELINE["Pipeline / CLI"]
-        CODE -->|DevOps Engineer| SECURITY
-        SECURITY --> SECURITY_ARTIFACT["Security Report"]
-        APITEST_ARTIFACT -->|Product Engineer| PIPELINE
-        FUNCTEST_WEB_ARTIFACT --> PIPELINE
-        FUNCTEST_MOBILE_ARTIFACT --> PIPELINE
-        E2E_WEB_ARTIFACT --> PIPELINE
-        E2E_MOBILE_ARTIFACT --> PIPELINE
-        PIPELINE --> TEST_REPORT["Test Report"]
-        SECURITY_ARTIFACT -->|DevOps Engineer| DEPLOY["Production"]
-        TEST_REPORT --> DEPLOY
-    end
-
-    STATUS["/tas-status"] -.->|Track| PRD_ARTIFACT
-    STATUS -.->|Track| SAD_ARTIFACT
-    STATUS -.->|Track| STORY_ARTIFACT
-    STATUS -.->|Track| DEPLOY
-
-    style PRD_ARTIFACT fill:#e1f5ff
-    style SAD_ARTIFACT fill:#fff4e1
-    style DESIGN_ARTIFACT fill:#f3e5f5
-    style STORY_ARTIFACT fill:#e8f5e9
-    style CODE fill:#f3e5f5
-    style TEST_REPORT fill:#c8e6c9
-    style DEPLOY fill:#c8e6c9
-:::
-
-### Phase Summary
-
-| Phase | Role | Commands | Artifacts |
-|-------|------|----------|-----------|
-| **Phase 1: Discovery** | PE, SE | `/tas-prd`, `/tas-sad`, `/tas-adr`, `/tas-design` | PRD.md, SAD.md, ADR-XXX.md, design-spec.md |
-| **Phase 2: Planning** | SE | `/tas-epic`, `/tas-feature`, `/tas-story`, `/tas-functest` | Epic-XXX/, Feature-XXX/, Story-XXX.md, Functional-Testing-Spec-FeatureXXX.md |
-| **Phase 3: Implementation** | PE, SE, AI | `/tas-plan`, `/tas-dev`, `/tas-fix`, `/tas-apitest`, `/tas-e2e`, `/tas-functest-web`, `/tas-functest-mobile`, `/tas-e2e-web`, `/tas-e2e-mobile`, `/tas-bug`, `/tas-review` | Plan.md, Source Code, API Testing Script, E2E Test Scenarios, Functional Test Scripts, Bug Report, Code Review Report |
-| **Phase 4: Quality & Deploy** | PE, DSE | `/tas-security`, Pipeline/CLI | Security Report, Test Report, Production |
-
-### Phase Details
-
-#### Phase 1: Discovery
-- **PE**: Create PRD with `/tas-prd`, create design-spec with `/tas-design`
-- **SE**: Create SAD with `/tas-sad`, create ADR with `/tas-adr`
-
-#### Phase 2: Planning
-- **PE**: Breakdown Epic with `/tas-epic`, Feature with `/tas-feature`, Story with `/tas-story`
-
-#### Phase 3: Implementation
-- **SE**: Create Plan with `/tas-plan`, Implement with `/tas-dev`, Fix bug with `/tas-fix`
-- **SE**: Review code with `/tas-review`
-- **PE**: Create Functional Testing Spec with `/tas-functest`
-- **SE**: Create API Testing Script with `/tas-apitest`
-- **PE**: Create E2E Test Scenarios with `/tas-e2e`
-- **SE**: Create Functional Test Scripts with `/tas-functest-web`, `/tas-functest-mobile`
-- **PE**: Create E2E Test Scripts with `/tas-e2e-web`, `/tas-e2e-mobile`
-- **PE**: Create Bug Report with `/tas-bug`
-
-#### Phase 4: Quality & Deploy
-- **DSE**: Security Review with `/tas-security`
-- **PE**: Run Pipeline/CLI to execute Automation Tests
-- **DSE**: Deploy to Production
-
----
-
-## Quick Start
-
-```bash
-npx @torus-engineering/tas-kit install
-```
-
-### Options
-
-```bash
-npx @torus-engineering/tas-kit install --directory /path/to/my-project
-npx @torus-engineering/tas-kit install --yes    # skip confirmation prompts
-```
-
----
-
-## Important Setup
-
-### CLAUDE.md
-
-Most important configuration file — Claude reads this file first in every session.
-
-**Structure:**
-```markdown
-# Project Name
-
-## Tech Stack
-- Backend: .NET / Node.js / Python
-- Frontend: React / Next.js
-- Database: PostgreSQL / MySQL
-- Infrastructure: AWS / Azure
-
-## Conventions
-- Coding standards
-- Architecture patterns
-- Testing requirements
-```
-
-### tas.yaml
-
-Controls TAS Kit flow per project.
-
-**Structure:**
-```yaml
-project:
-  name: "My Project"
-  team: "Team Name"
-
-azure_devops:
-  enabled: true
-  organization: "org"
-  project: "project"
-
-flow:
-  mode: "greenfield"  # or "brownfield"
-  use_tdd: true
-  auto_review: true
-```
-
-### project-status.yaml
-
-Project status index — automatically updated after each artifact change.
-
-**Structure:**
-```yaml
-last_updated: 2025-01-15
-
-artifacts:
-  prd:
-    file: docs/prd.md
-    status: Approved
-    version: "1.0"
-
-epics:
-  Epic-001:
-    status: Active
-    features:
-      Feature-001:
-        stories:
-          Story-001:
-            status: In Progress
-```
-
-### .env
-
-Environment variables for Azure DevOps integration.
-
-```bash
-AZURE_DEVOPS_PAT=your_pat_here
-AZURE_DEVOPS_ORG=your_org
-AZURE_DEVOPS_PROJECT=your_project
-```
-
----
-
-## What gets installed
-
-```
-.claude/
-  commands/   22 slash commands (/tas-*, /ado-*)
-  skills/     3 auto-invoked skills
-  agents/     29 specialized subagents
-.tas/
-  templates/  Markdown templates (PRD, SAD, ADR, Epic, Feature, Story...)
-  rules/      Coding standards + workflow rules (code-review, story-done, security...)
-  tools/      ADO integration script (tas-ado.py)
-CLAUDE.md     Project context template (edit this for your project)
-tas.yaml      Flow configuration template (edit this for your project)
-.env.example  Environment variable template
-```
-
----
-
-## Commands Reference
-
-| Command | Description | Role |
-|---------|-------------|------|
-| `/tas-init` | Initialize TAS for new project | All |
-| `/tas-status` | Display current project status | All |
-| `/tas-prd` | Create/update Product Requirements Document | PE |
-| `/tas-sad` | Create/update Solution Architecture Document | SE |
-| `/tas-adr` | Create Architecture Decision Record | SE |
-| `/tas-design` | Create Design Specification | SE |
-| `/tas-epic` | Create/update Epic | SE |
-| `/tas-feature` | Create/update Feature | SE |
-| `/tas-story` | Create/update Story | SE |
-| `/tas-functest` | Create Functional Testing Specification | SE |
-| `/tas-spec` | Lightweight spec (solo / prototype) | SE |
-| `/tas-plan` | Create technical implementation plan | SE |
-| `/tas-dev` | Implement story (agentic) | AI |
-| `/tas-fix` | Quick fix without full story flow | SE |
-| `/tas-apitest` | Create API Testing Script automatically | SE |
-| `/tas-e2e` | Create E2E Test Scenarios | PE |
-| `/tas-functest-web` | Create Functional Test Script for Web | SE |
-| `/tas-functest-mobile` | Create Functional Test Script for Mobile | SE |
-| `/tas-e2e-web` | Create E2E Test Script for Web | PE |
-| `/tas-e2e-mobile` | Create E2E Test Script for Mobile | PE |
-| `/tas-bug` | Create Bug Report | PE |
-| `/tas-review` | Code Review with checklist | SE |
-| `/tas-brainstorm` | Brainstorm solutions | All |
-| `/tas-security` | Security Review | DSE |
-| `/ado-*` | Azure DevOps integration | All |
-
----
-
-## Requirements
-
-- Node.js 18+
-- [Claude Code](https://claude.ai/code)
-
----
-
-## Documentation
-
-See `.tas/README.md` after install for detailed documentation.