@torus-engineering/tas-kit 1.5.0

package/README.md

@@ -0,0 +1,67 @@
+# TAS Kit
+
+**Torus Agentic SDLC Kit** — Claude Code commands, skills and templates for modern AI-assisted SDLC.
+
+## Quick Start
+
+```bash
+npx tas-kit install
+```
+
+## Options
+
+```bash
+npx tas-kit install --directory /path/to/my-project
+npx tas-kit install --yes    # skip confirmation prompts
+```
+
+## What gets installed
+
+```
+.claude/
+  commands/   20 slash commands (/tas-*, /ado-*)
+  skills/     3 auto-invoked skills
+  agents/     2 specialized subagents
+.tas/
+  templates/  Markdown templates (PRD, SAD, ADR, Epic, Feature, Story...)
+  checklists/ Code review, story done, security checklists
+  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
+```
+
+## After install
+
+1. Edit `CLAUDE.md` — 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 Claude Code — run `/tas-init` to initialize your project
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/tas-init` | Initialize TAS for a new project |
+| `/tas-status` | Show current project state |
+| `/tas-prd` | Create/update Product Requirements Document |
+| `/tas-sad` | Create/update Solution Architecture Document |
+| `/tas-epic` | Create/update Epic |
+| `/tas-feature` | Create/update Feature |
+| `/tas-story` | Create/update Story |
+| `/tas-dev-story` | Implement a story (agentic) |
+| `/tas-review-code` | Code review with checklist |
+| `/tas-brainstorm` | Brainstorm solutions |
+| `/tas-bug` | Create bug report |
+| `/tas-security-check` | Security review |
+| `/tas-verify` | Verify feature on staging |
+| `/ado-*` | Azure DevOps integration |
+
+## Requirements
+
+- Node.js 18+
+- [Claude Code](https://claude.ai/code)
+
+## Documentation
+
+See `.tas/README.md` after install for full kit documentation.

package/bin/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { install } from '../lib/install.js';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function printHelp() {
+  console.log(`
+tas-kit — Torus Agentic SDLC Kit installer
+
+Usage:
+  npx tas-kit install [options]
+
+Options:
+  --directory <path>   Target directory (default: current working directory)
+  --yes, -y            Skip confirmation prompts
+  --help, -h           Show this help message
+
+Examples:
+  npx tas-kit install
+  npx tas-kit install --directory /path/to/my-project
+  npx tas-kit install --yes
+  `.trim());
+}
+
+if (!command || command === '--help' || command === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+if (command !== 'install') {
+  console.error(`Unknown command: "${command}"\n`);
+  printHelp();
+  process.exit(1);
+}
+
+const opts = { directory: process.cwd(), yes: false };
+for (let i = 1; i < args.length; i++) {
+  if ((args[i] === '--directory' || args[i] === '-d') && args[i + 1]) {
+    opts.directory = args[++i];
+  } else if (args[i] === '--yes' || args[i] === '-y') {
+    opts.yes = true;
+  }
+}
+
+install(opts).catch((err) => {
+  console.error('\nInstall failed:', err.message);
+  process.exit(1);
+});

package/lib/install.js

@@ -0,0 +1,114 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+
+const PACKAGE_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+async function confirm(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(`${question} [y/N] `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
+
+async function exists(p) {
+  return fs.access(p).then(() => true).catch(() => false);
+}
+
+async function copyDir(src, dest) {
+  await fs.cp(src, dest, { recursive: true });
+}
+
+export async function install({ directory, yes }) {
+  const target = path.resolve(directory);
+
+  // Ensure target directory exists
+  await fs.mkdir(target, { recursive: true });
+
+  console.log(`\nInstalling TAS Kit into: ${target}\n`);
+
+  // Warn if .claude/ or .tas/ already exist
+  const claudeExists = await exists(path.join(target, '.claude'));
+  const tasExists = await exists(path.join(target, '.tas'));
+
+  if ((claudeExists || tasExists) && !yes) {
+    const existing = [claudeExists && '.claude/', tasExists && '.tas/'].filter(Boolean).join(', ');
+    console.warn(`  WARNING: ${existing} already exist in target directory.`);
+    console.warn(`  Existing files with the same names will be overwritten.\n`);
+    const ok = await confirm('Continue?');
+    if (!ok) {
+      console.log('Installation cancelled.');
+      process.exit(0);
+    }
+    console.log();
+  }
+
+  // Copy .claude/
+  await copyDir(
+    path.join(PACKAGE_DIR, '.claude'),
+    path.join(target, '.claude')
+  );
+  console.log('  [ok] .claude/');
+
+  // Copy .tas/
+  await copyDir(
+    path.join(PACKAGE_DIR, '.tas'),
+    path.join(target, '.tas')
+  );
+  console.log('  [ok] .tas/');
+
+  // Copy CLAUDE-Example.md as CLAUDE.md (only if absent)
+  const claudeMdTarget = path.join(target, 'CLAUDE.md');
+  if (!(await exists(claudeMdTarget))) {
+    await fs.copyFile(
+      path.join(PACKAGE_DIR, 'CLAUDE-Example.md'),
+      claudeMdTarget
+    );
+    console.log('  [ok] CLAUDE.md (from CLAUDE-Example.md)');
+  } else {
+    console.log('  [--] CLAUDE.md already exists, skipped');
+  }
+
+  // Copy .env.example
+  await fs.copyFile(
+    path.join(PACKAGE_DIR, '.env.example'),
+    path.join(target, '.env.example')
+  );
+  console.log('  [ok] .env.example');
+
+  // Copy tas-example.yaml as tas.yaml (only if absent)
+  const tasYamlTarget = path.join(target, 'tas.yaml');
+  if (!(await exists(tasYamlTarget))) {
+    await fs.copyFile(
+      path.join(PACKAGE_DIR, '.tas', 'tas-example.yaml'),
+      tasYamlTarget
+    );
+    console.log('  [ok] tas.yaml (from .tas/tas-example.yaml)');
+  } else {
+    console.log('  [--] tas.yaml already exists, skipped');
+  }
+
+  // Set executable bit on tas-ado.py (Unix/macOS)
+  if (process.platform !== 'win32') {
+    const adoPy = path.join(target, '.tas', 'tools', 'tas-ado.py');
+    if (await exists(adoPy)) {
+      await fs.chmod(adoPy, 0o755);
+    }
+  }
+
+  console.log(`
+TAS Kit installed successfully!
+
+Next steps:
+  1. Edit CLAUDE.md     — 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 Claude Code   — run /tas-init to initialize your project
+
+Docs: .tas/README.md
+  `);
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@torus-engineering/tas-kit",
+  "version": "1.5.0",
+  "description": "Torus Agentic SDLC Kit — Claude Code commands, skills and workflows for modern AI-assisted SDLC",
+  "type": "module",
+  "bin": {
+    "tas-kit": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    ".claude/",
+    ".tas/",
+    "CLAUDE-Example.md",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "claude-code",
+    "sdlc",
+    "ai",
+    "torus",
+    "tas",
+    "agentic"
+  ],
+  "author": "Torus BelleSoft",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/torus-bellesoft/agentic-sdlc-kit.git"
+  }
+}