ultra-dex 1.2.0 → 1.3.0

package/README.md

@@ -40,12 +40,46 @@ Shows links to fully filled Ultra-Dex examples:
 - InvoiceFlow (Invoicing)
 - HabitStack (Habit Tracking)
 
+### Audit your project
+
+```bash
+npx ultra-dex audit
+```
+
+Checks your project for completeness:
+- Required files (QUICK-START.md, CONTEXT.md, etc.)
+- Key sections (idea, problem, MVP, tech stack)
+- Implementation details (database, API, auth)
+
+Outputs a score and grade (A-F) with suggestions.
+
+### List AI agents
+
+```bash
+npx ultra-dex agents
+```
+
+Shows available AI agent prompts:
+- CTO, Backend, Frontend, Database
+- Auth, DevOps, Reviewer, Debugger, Planner
+
+### Get agent prompt
+
+```bash
+npx ultra-dex agent backend
+```
+
+Prints the full agent prompt. Copy and paste into your AI tool (Cursor, Claude, ChatGPT).
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `ultra-dex init` | Initialize a new project |
+| `ultra-dex audit` | Audit project for completeness |
 | `ultra-dex examples` | List available examples |
+| `ultra-dex agents` | List available AI agents |
+| `ultra-dex agent <name>` | Show specific agent prompt |
 | `ultra-dex --help` | Show help |
 | `ultra-dex --version` | Show version |
 
@@ -58,6 +92,12 @@ Shows links to fully filled Ultra-Dex examples:
 | `-n, --name <name>` | Project name (skips prompt) |
 | `-d, --dir <directory>` | Output directory (default: current) |
 
+### audit
+
+| Option | Description |
+|--------|-------------|
+| `-d, --dir <directory>` | Directory to audit (default: current) |
+
 ## Example
 
 ```bash
@@ -89,7 +129,9 @@ Files created:
   my-saas/
   ├── QUICK-START.md
   ├── CONTEXT.md
-  └── IMPLEMENTATION-PLAN.md
+  ├── IMPLEMENTATION-PLAN.md
+  ├── .cursor/rules/ (11 AI rule files)
+  └── .agents/ (9 AI agent prompts)
 
 Next steps:
   1. cd my-saas
@@ -102,6 +144,7 @@ Next steps:
 - [Full Template](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md)
 - [Examples](https://github.com/Srujan0798/Ultra-Dex/tree/main/@%20Ultra%20DeX/Saas%20plan/Examples)
 - [Methodology](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/03-METHODOLOGY.md)
+- [AI Agents](https://github.com/Srujan0798/Ultra-Dex/tree/main/agents)
 
 ## License
 

package/bin/ultra-dex.js

@@ -109,7 +109,7 @@ Setting up the implementation plan.
 program
   .name('ultra-dex')
   .description('CLI for Ultra-Dex SaaS Implementation Framework')
-  .version('1.0.0');
+  .version('1.3.0');
 
 program
   .command('init')
@@ -213,6 +213,12 @@ program
         message: 'Copy VERIFICATION.md & AGENT-INSTRUCTIONS.md to docs/?',
         default: true,
       },
+      {
+        type: 'confirm',
+        name: 'includeAgents',
+        message: 'Include AI agent prompts? (.agents/ folder)',
+        default: true,
+      },
     ]);
 
     const spinner = ora('Creating project files...').start();
@@ -325,6 +331,27 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
         }
       }
 
+      // Copy agents if requested
+      if (answers.includeAgents) {
+        const agentsDir = path.join(outputDir, '.agents');
+        await fs.mkdir(agentsDir, { recursive: true });
+
+        const agentsSourcePath = path.resolve(__dirname, '../../agents');
+        try {
+          const agentFiles = await fs.readdir(agentsSourcePath);
+          for (const file of agentFiles.filter(f => f.endsWith('.md'))) {
+            await fs.copyFile(
+              path.join(agentsSourcePath, file),
+              path.join(agentsDir, file)
+            );
+          }
+        } catch (err) {
+          // Agents not available (npm package, not local)
+          console.log(chalk.yellow('\n  Note: Agent prompts not bundled. Download from GitHub:'));
+          console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex/tree/main/agents'));
+        }
+      }
+
       spinner.succeed(chalk.green('Project created successfully!'));
 
       console.log('\n' + chalk.bold('Files created:'));
@@ -340,7 +367,10 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
         console.log(chalk.gray('  ├── docs/AI-PROMPTS.md'));
       }
       if (answers.includeCursorRules) {
-        console.log(chalk.gray('  └── .cursor/rules/ (11 AI rule files)'));
+        console.log(chalk.gray('  ├── .cursor/rules/ (11 AI rule files)'));
+      }
+      if (answers.includeAgents) {
+        console.log(chalk.gray('  └── .agents/ (9 AI agent prompts)'));
       }
 
       console.log('\n' + chalk.bold('Next steps:'));
@@ -522,4 +552,67 @@ program
     });
   });
 
+// Agent definitions
+const AGENTS = [
+  { name: 'cto', description: 'Architecture & tech decisions', file: 'cto.md' },
+  { name: 'backend', description: 'API, database, server logic', file: 'backend.md' },
+  { name: 'frontend', description: 'UI, components, styling', file: 'frontend.md' },
+  { name: 'database', description: 'Schema design, queries, migrations', file: 'database.md' },
+  { name: 'auth', description: 'Authentication & authorization', file: 'auth.md' },
+  { name: 'devops', description: 'Deployment, CI/CD, infrastructure', file: 'devops.md' },
+  { name: 'reviewer', description: 'Code review & quality check', file: 'reviewer.md' },
+  { name: 'debugger', description: 'Bug fixing & troubleshooting', file: 'debugger.md' },
+  { name: 'planner', description: 'Task breakdown & planning', file: 'planner.md' },
+];
+
+program
+  .command('agents')
+  .description('List available AI agent prompts')
+  .action(() => {
+    console.log(chalk.bold('\n🤖 Available Ultra-Dex Agents\n'));
+    console.log(chalk.gray('Copy these prompts into your AI tool (Cursor, Claude, ChatGPT, etc.)\n'));
+
+    AGENTS.forEach((agent, i) => {
+      console.log(chalk.cyan(`  ${i + 1}. ${agent.name}`) + chalk.gray(` - ${agent.description}`));
+    });
+
+    console.log('\n' + chalk.bold('Usage:'));
+    console.log(chalk.gray('  ultra-dex agent <name>   Show agent prompt (copy to clipboard)'));
+    console.log(chalk.gray('  ultra-dex agent backend  Example: show backend agent prompt'));
+
+    console.log('\n' + chalk.gray('Full docs: https://github.com/Srujan0798/Ultra-Dex/tree/main/agents\n'));
+  });
+
+program
+  .command('agent <name>')
+  .description('Show a specific agent prompt')
+  .action(async (name) => {
+    const agent = AGENTS.find(a => a.name.toLowerCase() === name.toLowerCase());
+
+    if (!agent) {
+      console.log(chalk.red(`\n❌ Agent "${name}" not found.\n`));
+      console.log(chalk.gray('Available agents:'));
+      AGENTS.forEach(a => console.log(chalk.cyan(`  - ${a.name}`)));
+      console.log('\n' + chalk.gray('Run "ultra-dex agents" to see all agents.\n'));
+      process.exit(1);
+    }
+
+    // Try to read agent file
+    const agentPath = path.resolve(__dirname, '../../agents', agent.file);
+    try {
+      const content = await fs.readFile(agentPath, 'utf-8');
+      console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
+      console.log(chalk.gray('─'.repeat(60)));
+      console.log(content);
+      console.log(chalk.gray('─'.repeat(60)));
+      console.log(chalk.bold('\n📋 Copy the above prompt and paste into your AI tool.\n'));
+    } catch (err) {
+      // Agent file not bundled (npm package)
+      console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
+      console.log(chalk.yellow('Agent prompts are not bundled with the npm package.'));
+      console.log(chalk.gray('\nDownload from GitHub:'));
+      console.log(chalk.blue(`  https://github.com/Srujan0798/Ultra-Dex/blob/main/agents/${agent.file}\n`));
+    }
+  });
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra-dex",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "CLI for Ultra-Dex SaaS Implementation Framework",
   "keywords": [
     "saas",