agentic-sdlc 1.0.0

package/.github/copilot-instructions.md

@@ -0,0 +1,60 @@
+# TeamLifecycle SDLC System
+
+This project uses a structured SDLC workflow with specialized roles. All instructions are in `.agent/`.
+
+## Slash Commands (Role Shortcuts)
+
+When user types these commands, interpret as role tags:
+
+### Core Roles
+- `/pm` → @PM (Project Manager)
+- `/orchestrator` → @ORCHESTRATOR (Workflow Automation)
+- `/po` → @PO (Product Owner)
+- `/sa` → @SA (System Analyst)
+- `/uiux` → @UIUX (UI/UX Designer)
+- `/qa` → @QA (Quality Assurance)
+- `/seca` → @SECA (Security Analyst)
+- `/dev` → @DEV (Developer)
+- `/devops` → @DEVOPS (DevOps Engineer)
+- `/tester` → @TESTER (Tester)
+- `/reporter` → @REPORTER (Reporter)
+- `/stakeholder` → @STAKEHOLDER (Stakeholder)
+
+### Quick Actions
+- `/auto [requirements]` → @PM [requirements] --mode=full-auto
+- `/semi-auto [requirements]` → @PM [requirements] --mode=semi-auto
+- `/kb-search [query]` → Search `.agent/knowledge-base/`
+- `/kb-add [topic]` → Create knowledge base entry
+
+## Role Behavior
+
+Each role has specific responsibilities defined in `.agent/workflows/[role].md`:
+
+1. **Load role file** when command is used
+2. **Follow role rules** strictly
+3. **Create artifacts** in `docs/sprints/sprint-[N]/[category]/`
+4. **Tag next roles** using @tags
+5. **Use templates** from `.agent/templates/`
+
+## Workflow
+
+```
+Planning → Design → Verification → Development → Testing → Reporting → Approval
+```
+
+## Key Files
+
+- Global Rules: `.agent/rules/global.md`
+- Usage Guide: `.agent/usage.md`
+- Roles: `.agent/workflows/*.md`
+- Templates: `.agent/templates/*.md`
+- Knowledge Base: `.agent/knowledge-base/`
+
+## Examples
+
+```
+/pm Build a REST API for task management
+/auto Create a mobile app for expense tracking
+/dev Implement JWT authentication
+/kb-search OAuth token refresh
+```

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [Unreleased]
+
+### Added
+- [2025-12-31] [INITIAL] Docs: Initialized project with TeamLifecycle SDLC workflow (@Antigravity)
+- [2025-12-31] [REF-001] Refactor: Migrated project structure to native `.agent/` standard (@Antigravity)
+- [2025-12-31] [FEAT-001] Feature: Added Jira-style task management and atomic commit rules (@Antigravity)
+- [2025-12-31] [FEAT-002] Feature: Integrated automated changelog update requirement (@Antigravity)

package/README.md

@@ -0,0 +1,136 @@
+# Agentic SDLC
+
+> Simulating a complete Software Development Lifecycle (SDLC) with specialized AI Agents.
+
+Transform your IDE into a full SDLC team with 12 specialized AI roles, automated workflows, and knowledge management.
+
+## ✨ Features
+
+- 🤖 **12 AI Roles** - PM, SA, UI/UX, QA, Security, Dev, DevOps, Tester, Reporter, Stakeholder, PO, Orchestrator
+- ⚡ **Slash Commands** - `/pm`, `/dev`, `/auto` in your IDE
+- 🔄 **Auto Workflow** - Full automation or manual control
+- 🧠 **Knowledge Base** - Learn from past challenges
+- 🎨 **IDE Integration** - Cursor, Copilot, Windsurf, Cline, Aider
+- 📚 **16 Templates** - Plans, designs, reports, documentation
+- 🌐 **All Platforms** - Web, Mobile, Desktop, CLI, API, Embedded
+
+## 🚀 Quick Start
+
+```bash
+# Install
+npm install -g agentic-sdlc
+
+# Create project
+agentic-sdlc create my-project
+cd my-project
+
+# Setup IDE
+agentic-sdlc ide cursor
+
+# Start building (in IDE)
+/pm Build a todo app with authentication
+```
+
+**That's it!** See [Quick Start](docs/guides/QUICK-START.md) for details.
+
+## 📖 Documentation
+
+- **[Documentation Outline](docs/OUTLINE.md)** - Central hub for all guides
+- **Quick Start:** [QUICK-START.md](docs/guides/QUICK-START.md) - Get started in 5 minutes
+- **CLI Examples:** [CLI-EXAMPLES.md](docs/guides/CLI-EXAMPLES.md) - Complete usage guide
+- **Usage Guide:** `.agent/usage.md` - Full documentation
+- **IDE Integration:** `.agent/ide-integration/README.md`
+
+## 🎯 Use Cases
+
+### Solo Developer
+```bash
+/auto Create a SaaS platform for project management
+# Automated workflow, complete in days
+```
+
+### Team Project
+```bash
+agentic-sdlc ide all
+agentic-sdlc init-kb
+# Shared workflow, consistent quality
+```
+
+### Existing Project
+```bash
+agentic-sdlc install
+agentic-sdlc ide cursor
+# Add SDLC to any project
+```
+
+## 🔧 CLI Commands
+
+```bash
+agentic-sdlc install              # Install in current directory
+agentic-sdlc create <name>        # Create new project
+agentic-sdlc ide <cursor|all>     # Setup IDE integration
+agentic-sdlc init-kb              # Initialize knowledge base
+agentic-sdlc list                 # List templates & roles
+agentic-sdlc --help               # Show help
+```
+
+## 🎨 IDE Slash Commands
+
+After setup, use these in your IDE:
+
+```bash
+/pm              # Project Manager
+/auto            # Full automation
+/sa              # System Analyst
+/uiux            # UI/UX Designer
+/dev             # Developer
+/devops          # DevOps Engineer
+/tester          # Tester
+/kb-search       # Search knowledge base
+```
+
+## 📊 Project Structure
+
+```
+my-project/
+├── .agent/
+│   ├── roles/              # 12 AI roles
+│   ├── templates/          # 16 templates
+│   ├── knowledge-base/     # Learning system
+│   └── ide-integration/    # IDE configs
+├── docs/sprints/           # Sprint documentation
+├── .cursorrules            # Cursor config
+└── .github/copilot-instructions.md
+```
+
+## 🌟 Examples
+
+See [CLI-EXAMPLES.md](docs/guides/CLI-EXAMPLES.md) for:
+- Real-world workflows
+- Team collaboration
+- Automation scripts
+- Troubleshooting
+- Pro tips
+
+## 📦 What's Included
+
+- **12 Roles:** Complete SDLC team
+- **16 Templates:** All documentation needs
+- **Knowledge Base:** Learn and improve
+- **IDE Integration:** 5+ IDEs supported
+- **Automation:** Full-auto or manual modes
+- **Multi-platform:** Web, mobile, desktop, CLI, API
+
+## 🤝 Contributing
+
+Contributions welcome! See issues for ideas.
+
+## 📄 License
+
+MIT
+
+## 🔗 Links
+
+- **Repository:** https://github.com/truongnat/agentic-sdlc
+- **Issues:** https://github.com/truongnat/agentic-sdlc/issues
+- **NPM:** https://www.npmjs.com/package/agentic-sdlc

package/bin/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { log } from './utils/colors.js';
+import { parseArgs } from './utils/args-parser.js';
+import { showHelp, showVersion } from './commands/help.js';
+import { listTemplates } from './commands/list.js';
+import { install } from './commands/install.js';
+import { createProject } from './commands/create.js';
+import { setupIDE } from './commands/ide.js';
+import { initKnowledgeBase } from './commands/init-kb.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const templatePath = path.join(__dirname, '../.agent');
+
+// Package info
+const packageJson = JSON.parse(
+  await fs.readFile(path.join(__dirname, '../package.json'), 'utf-8')
+);
+
+/**
+ * Main CLI entry point
+ */
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Handle no arguments
+  if (args.length === 0) {
+    showHelp(packageJson);
+    process.exit(0);
+  }
+
+  const { options, args: filteredArgs } = parseArgs(args);
+  const command = filteredArgs[0];
+
+  // Handle help flags
+  if (command === '-h' || command === '--help' || command === 'help') {
+    showHelp(packageJson);
+    process.exit(0);
+  }
+
+  // Handle version flags
+  if (command === '-v' || command === '--version' || command === 'version') {
+    showVersion(packageJson);
+    process.exit(0);
+  }
+
+  // Handle commands
+  switch (command) {
+    case 'install':
+      await install(templatePath, options);
+      break;
+
+    case 'create':
+      const projectName = filteredArgs[1];
+      if (!projectName) {
+        log.error('Project name is required');
+        console.log('Usage: agentic-sdlc create <project-name>');
+        process.exit(1);
+      }
+      await createProject(templatePath, projectName, options);
+      break;
+
+    case 'list':
+      await listTemplates(templatePath);
+      break;
+
+    case 'ide':
+      const ideName = filteredArgs[1];
+      if (!ideName) {
+        log.error('IDE name is required');
+        console.log('Usage: agentic-sdlc ide <cursor|copilot|windsurf|cline|aider|all>');
+        process.exit(1);
+      }
+      await setupIDE(templatePath, ideName, options);
+      break;
+
+    case 'init-kb':
+      await initKnowledgeBase(templatePath, options);
+      break;
+
+    default:
+      log.error(`Unknown command: ${command}`);
+      console.log('Run agentic-sdlc --help for usage information');
+      process.exit(1);
+  }
+}
+
+// Error handlers
+process.on('uncaughtException', (err) => {
+  log.error('Unexpected error occurred');
+  log.error(err.message);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (err) => {
+  log.error('Unhandled promise rejection');
+  log.error(err.message);
+  process.exit(1);
+});
+
+main();

package/bin/commands/create.js

@@ -0,0 +1,96 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { colors, log } from '../utils/colors.js';
+
+/**
+ * Create new project with instructions
+ */
+export async function createProject(templatePath, projectName, options = {}) {
+  const startTime = Date.now();
+  const targetPath = path.join(process.cwd(), projectName);
+
+  try {
+    if (!options.quiet) log.header(`🚀 Creating Project: ${projectName}`);
+
+    // Check if project exists
+    if (await fs.pathExists(targetPath)) {
+      if (!options.force) {
+        log.error(`Directory '${projectName}' already exists`);
+        log.info('Use --force to overwrite');
+        process.exit(1);
+      } else {
+        log.warning('Overwriting existing project...');
+        await fs.remove(targetPath);
+      }
+    }
+
+    // Create project directory
+    if (!options.quiet) log.step('Creating project directory...');
+    await fs.ensureDir(targetPath);
+
+    // Copy instructions
+    if (!options.quiet) log.step('Installing instructions...');
+    await fs.copy(templatePath, path.join(targetPath, '.agent'));
+
+    // Create basic project structure
+    if (!options.quiet) log.step('Setting up project structure...');
+
+    // Create docs structure
+    await fs.ensureDir(path.join(targetPath, 'docs', 'sprints', 'sprint-1', 'plans'));
+    await fs.ensureDir(path.join(targetPath, 'docs', 'sprints', 'sprint-1', 'designs'));
+    await fs.ensureDir(path.join(targetPath, 'docs', 'sprints', 'sprint-1', 'reviews'));
+    await fs.ensureDir(path.join(targetPath, 'docs', 'sprints', 'sprint-1', 'logs'));
+    await fs.ensureDir(path.join(targetPath, 'docs', 'sprints', 'sprint-1', 'tests'));
+    await fs.ensureDir(path.join(targetPath, 'docs', 'sprints', 'sprint-1', 'reports'));
+    await fs.ensureDir(path.join(targetPath, 'docs', 'global', 'reports'));
+
+    // Create package.json
+    await fs.writeJson(
+      path.join(targetPath, 'package.json'),
+      {
+        name: projectName,
+        version: '1.0.0',
+        description: 'Project created with agentic-sdlc',
+        main: 'index.js',
+        scripts: {
+          test: 'echo "Error: no test specified" && exit 1',
+        },
+      },
+      { spaces: 2 }
+    );
+
+    // Create README
+    await fs.writeFile(
+      path.join(targetPath, 'README.md'),
+      `# ${projectName}\n\nProject created with agentic-sdlc.\n\n## Getting Started\n\n1. Review instructions: \`.agent/usage.md\`\n2. Setup IDE: \`agentic-sdlc ide cursor\`\n3. Start planning: \`/pm Build your project\`\n\n## Documentation\n\nAll project documentation is in \`docs/\` folder organized by sprints.\n`
+    );
+
+    // Create .gitignore
+    await fs.writeFile(
+      path.join(targetPath, '.gitignore'),
+      `node_modules/\n.DS_Store\n*.log\n.env\n.env.local\n.agent/\n`
+    );
+
+    // Success
+    if (!options.quiet) {
+      log.success('Project created successfully!');
+      console.log(`Location: ${targetPath}`);
+      console.log(`\nNext Steps:`);
+      console.log(`  ${colors.cyan}cd ${projectName}${colors.reset}`);
+      console.log('  agentic-sdlc ide cursor');
+      console.log('  • Review .agent/usage.md');
+      console.log('  • Initialize git repository');
+      console.log('  • Start: /pm Build your project\n');
+
+      const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+      log.info(`Completed in ${duration}s`);
+    }
+
+    process.exit(0);
+  } catch (err) {
+    log.error('Project creation failed');
+    log.error(err.message);
+    if (options.verbose) console.error('\nStack trace:', err.stack);
+    process.exit(1);
+  }
+}

package/bin/commands/help.js

@@ -0,0 +1,69 @@
+import { colors } from '../utils/colors.js';
+
+/**
+ * Display help information
+ */
+export function showHelp(packageJson) {
+  console.log(`
+${colors.bright}${colors.cyan}agentic-sdlc${colors.reset} ${colors.dim}v${packageJson.version}${colors.reset}
+
+${colors.bright}USAGE${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} ${colors.yellow}<command>${colors.reset} ${colors.dim}[options]${colors.reset}
+
+${colors.bright}COMMANDS${colors.reset}
+  ${colors.yellow}install${colors.reset}              Install instructions into current directory
+  ${colors.yellow}create${colors.reset} ${colors.dim}<name>${colors.reset}       Create new project with instructions
+  ${colors.yellow}list${colors.reset}                List available templates and roles
+  ${colors.yellow}ide${colors.reset} ${colors.dim}<ide-name>${colors.reset}     Setup IDE integration (cursor, copilot, windsurf, cline, aider, all)
+  ${colors.yellow}init-kb${colors.reset}             Initialize knowledge base structure
+  ${colors.yellow}version${colors.reset}             Show version information
+  ${colors.yellow}help${colors.reset}                Show this help message
+
+${colors.bright}OPTIONS${colors.reset}
+  ${colors.dim}-h, --help${colors.reset}          Show help
+  ${colors.dim}-v, --version${colors.reset}       Show version
+  ${colors.dim}-f, --force${colors.reset}         Force overwrite existing files
+  ${colors.dim}-q, --quiet${colors.reset}         Suppress output
+  ${colors.dim}--verbose${colors.reset}           Show detailed output
+  ${colors.dim}--no-color${colors.reset}          Disable colored output
+
+${colors.bright}EXAMPLES${colors.reset}
+  ${colors.dim}# Install in current directory${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} install
+
+  ${colors.dim}# Create new project${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} create my-project
+
+  ${colors.dim}# Setup Cursor IDE integration${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} ide cursor
+
+  ${colors.dim}# Setup all IDE integrations${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} ide all
+
+  ${colors.dim}# Initialize knowledge base${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} init-kb
+
+  ${colors.dim}# List available templates${colors.reset}
+  ${colors.cyan}agentic-sdlc${colors.reset} list
+
+${colors.bright}IDE INTEGRATIONS${colors.reset}
+  ${colors.dim}cursor${colors.reset}      - Cursor IDE (.cursorrules)
+  ${colors.dim}copilot${colors.reset}     - GitHub Copilot (.github/copilot-instructions.md)
+  ${colors.dim}windsurf${colors.reset}    - Windsurf Cascade (.windsurfrules)
+  ${colors.dim}cline${colors.reset}       - Cline VS Code Extension
+  ${colors.dim}aider${colors.reset}       - Aider CLI (.aider.conf.yml)
+  ${colors.dim}all${colors.reset}         - Setup all IDE integrations
+
+${colors.bright}DOCUMENTATION${colors.reset}
+  ${colors.dim}Repository:${colors.reset} https://github.com/yourusername/template-instructions
+  ${colors.dim}Issues:${colors.reset}     https://github.com/yourusername/template-instructions/issues
+`);
+}
+
+/**
+ * Display version information
+ */
+export function showVersion(packageJson) {
+  console.log(`${colors.cyan}agentic-sdlc${colors.reset} ${colors.bright}v${packageJson.version}${colors.reset}`);
+  console.log(`${colors.dim}${packageJson.description}${colors.reset}`);
+}

package/bin/commands/ide.js

@@ -0,0 +1,116 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { log } from '../utils/colors.js';
+
+/**
+ * Setup single IDE configuration
+ */
+async function setupSingleIDE(config, options) {
+  // Create directory if needed
+  if (config.createDir) {
+    await fs.ensureDir(config.createDir);
+  }
+
+  // Check if file exists
+  if (await fs.pathExists(config.target)) {
+    if (!options.force) {
+      log.warning(`${config.name} config already exists`);
+      log.info('Use --force to overwrite');
+      return;
+    } else {
+      log.warning(`Overwriting ${config.name} config...`);
+    }
+  }
+
+  // Copy config file
+  if (!options.quiet) log.step(`Installing ${config.name}...`);
+  await fs.copy(config.source, config.target);
+  if (!options.quiet) log.success(`${config.name} installed`);
+}
+
+/**
+ * Setup IDE integration
+ */
+export async function setupIDE(templatePath, ideName, options = {}) {
+  const startTime = Date.now();
+  const targetPath = process.cwd();
+  const ideIntegrationPath = path.join(templatePath, 'ide-integration');
+
+  try {
+    if (!options.quiet) log.header(`🔧 Setting up ${ideName.toUpperCase()} Integration`);
+
+    const ideConfigs = {
+      cursor: {
+        source: path.join(ideIntegrationPath, 'cursor-rules.md'),
+        target: path.join(targetPath, '.cursorrules'),
+        name: 'Cursor IDE'
+      },
+      copilot: {
+        source: path.join(ideIntegrationPath, 'github-copilot-instructions.md'),
+        target: path.join(targetPath, '.github', 'copilot-instructions.md'),
+        name: 'GitHub Copilot',
+        createDir: path.join(targetPath, '.github')
+      },
+      windsurf: {
+        source: path.join(ideIntegrationPath, 'windsurf-cascade.md'),
+        target: path.join(targetPath, '.windsurfrules'),
+        name: 'Windsurf Cascade'
+      },
+      cline: {
+        source: path.join(ideIntegrationPath, 'cline-config.json'),
+        target: path.join(targetPath, '.vscode', 'cline-config.json'),
+        name: 'Cline Extension',
+        createDir: path.join(targetPath, '.vscode')
+      },
+      aider: {
+        source: path.join(ideIntegrationPath, 'aider-commands.md'),
+        target: path.join(targetPath, '.aider.conf.yml'),
+        name: 'Aider CLI'
+      }
+    };
+
+    if (ideName === 'all') {
+      // Setup all IDEs
+      for (const [ide, config] of Object.entries(ideConfigs)) {
+        await setupSingleIDE(config, options);
+      }
+      
+      if (!options.quiet) {
+        log.success('All IDE integrations installed!');
+        console.log(`\nNext Steps:`);
+        console.log('  • Restart your IDE');
+        console.log('  • Type / in chat to see available commands');
+        console.log('  • Try: /pm Build a todo app\n');
+      }
+    } else {
+      // Setup single IDE
+      const config = ideConfigs[ideName];
+      if (!config) {
+        log.error(`Unknown IDE: ${ideName}`);
+        console.log(`Available: cursor, copilot, windsurf, cline, aider, all`);
+        process.exit(1);
+      }
+
+      await setupSingleIDE(config, options);
+      
+      if (!options.quiet) {
+        log.success(`${config.name} integration installed!`);
+        console.log(`Location: ${config.target}`);
+        console.log(`\nNext Steps:`);
+        console.log(`  • Restart ${config.name}`);
+        console.log('  • Type / in chat to see commands');
+        console.log('  • Try: /pm Build a todo app\n');
+      }
+    }
+
+    const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+    if (!options.quiet) log.info(`Completed in ${duration}s`);
+
+    process.exit(0);
+  } catch (err) {
+    log.error('IDE setup failed');
+    log.error(err.message);
+    if (options.verbose) console.error('\nStack trace:', err.stack);
+    process.exit(1);
+  }
+}

package/bin/commands/init-kb.js

@@ -0,0 +1,74 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { log } from '../utils/colors.js';
+
+/**
+ * Initialize knowledge base structure
+ */
+export async function initKnowledgeBase(templatePath, options = {}) {
+  const startTime = Date.now();
+  const targetPath = path.join(process.cwd(), '.gemini', 'instructions', 'knowledge-base');
+
+  try {
+    if (!options.quiet) log.header('🧠 Initializing Knowledge Base');
+
+    // Check if already exists
+    if (await fs.pathExists(targetPath)) {
+      if (!options.force) {
+        log.warning('Knowledge base already exists');
+        log.info('Use --force to reinitialize');
+        process.exit(0);
+      }
+    }
+
+    // Create directory structure
+    if (!options.quiet) log.step('Creating directory structure...');
+    
+    const dirs = [
+      'bugs/critical',
+      'bugs/high',
+      'bugs/medium',
+      'bugs/low',
+      'features/authentication',
+      'features/performance',
+      'features/integration',
+      'features/ui-ux',
+      'architecture',
+      'security',
+      'performance',
+      'platform-specific/web',
+      'platform-specific/mobile',
+      'platform-specific/desktop',
+      'platform-specific/cli',
+      'platform-specific/embedded'
+    ];
+
+    for (const dir of dirs) {
+      await fs.ensureDir(path.join(targetPath, dir));
+    }
+
+    // Copy README and index
+    const kbSourcePath = path.join(templatePath, 'knowledge-base');
+    await fs.copy(path.join(kbSourcePath, 'README.md'), path.join(targetPath, 'README.md'));
+    await fs.copy(path.join(kbSourcePath, 'index.md'), path.join(targetPath, 'index.md'));
+
+    if (!options.quiet) {
+      log.success('Knowledge base initialized!');
+      console.log(`Location: ${targetPath}`);
+      console.log(`\nNext Steps:`);
+      console.log('  • Read: .gemini/instructions/knowledge-base/README.md');
+      console.log('  • Use template: Knowledge-Entry-Template.md');
+      console.log('  • Search: Check index.md\n');
+
+      const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+      log.info(`Completed in ${duration}s`);
+    }
+
+    process.exit(0);
+  } catch (err) {
+    log.error('Knowledge base initialization failed');
+    log.error(err.message);
+    if (options.verbose) console.error('\nStack trace:', err.stack);
+    process.exit(1);
+  }
+}