@zik000/archai 0.1.0 → 0.1.2

package/README.md

@@ -89,7 +89,7 @@ This agent system implements a **three-phase iteration architecture**:
 
 ```bash
 # Install globally
-npm install -g archai
+npm install -g @zik000/archai
 
 # Initialize in your project
 cd your-project

package/dist/bin/cli.js

@@ -3,6 +3,8 @@ import { Command } from 'commander';
 import { init } from '../commands/init.js';
 import { generate } from '../commands/generate.js';
 import { doctor } from '../commands/doctor.js';
+import { setupProject } from '../commands/setup-project.js';
+import { setupConfig } from '../commands/setup-config.js';
 const program = new Command();
 program
     .name('archai')
@@ -24,5 +26,15 @@ program
     .command('doctor')
     .description('Validate archai setup and check for issues')
     .action(doctor);
+program
+    .command('setup-project')
+    .description('Interactive wizard to fill out project description')
+    .option('--force', 'Overwrite existing content')
+    .action(setupProject);
+program
+    .command('setup-config')
+    .description('Interactive wizard to configure archai.config.md')
+    .option('--force', 'Overwrite existing content')
+    .action(setupConfig);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,2DAA2D,CAAC;KACxE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;KACrD,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;KAChE,MAAM,CAAC,IAAI,CAAC,CAAC;AAEhB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;KACzE,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;KAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,2DAA2D,CAAC;KACxE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;KACrD,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;KAChE,MAAM,CAAC,IAAI,CAAC,CAAC;AAEhB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;KACzE,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;KAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,SAAS,EAAE,4BAA4B,CAAC;KAC/C,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,SAAS,EAAE,4BAA4B,CAAC;KAC/C,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiCD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyI9D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiCD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2I9D"}

package/dist/commands/init.js

@@ -137,9 +137,11 @@ export async function init(options) {
     console.log('');
     console.log(chalk.white('1. Fill in the project description:'));
     console.log(chalk.cyan('   → .knowledge/context/project-description.md'));
+    console.log(chalk.gray('   (or run: archai setup-project)'));
     console.log('');
     console.log(chalk.white('2. Complete the configuration:'));
     console.log(chalk.cyan('   → archai.config.md'));
+    console.log(chalk.gray('   (or run: archai setup-config)'));
     console.log('');
     console.log(chalk.white('3. Generate specialist agents:'));
     console.log(chalk.cyan('   → archai generate'));

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup-config.d.ts

@@ -0,0 +1,6 @@
+interface SetupConfigOptions {
+    force?: boolean;
+}
+export declare function setupConfig(options: SetupConfigOptions): Promise<void>;
+export {};
+//# sourceMappingURL=setup-config.d.ts.map

package/dist/commands/setup-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-config.d.ts","sourceRoot":"","sources":["../../src/commands/setup-config.ts"],"names":[],"mappings":"AAMA,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAoDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6M5E"}

package/dist/commands/setup-config.js

@@ -0,0 +1,532 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import { logger } from '../utils/logger.js';
+const FILE_PATH = 'archai.config.md';
+const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun', 'pip', 'cargo', 'go', 'other'];
+export async function setupConfig(options) {
+    logger.banner();
+    // Check if file exists
+    const exists = await fs.pathExists(FILE_PATH);
+    if (!exists) {
+        logger.error('archai.config.md not found!');
+        console.log('');
+        logger.info('Run `archai init` first to create the configuration file.');
+        return;
+    }
+    // Load existing config
+    const existing = await parseExistingConfig();
+    console.log('');
+    logger.section('Configuration Wizard');
+    console.log(chalk.gray('   Configure your project settings and define specialists.'));
+    console.log(chalk.gray('   Press Enter to keep existing values.'));
+    console.log('');
+    // Section 1: Tech Stack
+    logger.section('1. Tech Stack');
+    console.log('');
+    const stackAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'languages',
+            message: 'Programming languages:',
+            default: existing.languages || '',
+        },
+        {
+            type: 'input',
+            name: 'frameworks',
+            message: 'Frameworks/libraries:',
+            default: existing.frameworks || '',
+        },
+        {
+            type: 'input',
+            name: 'testing',
+            message: 'Testing framework:',
+            default: existing.testing || '',
+        },
+        {
+            type: 'input',
+            name: 'additionalTech',
+            message: 'Additional technologies (databases, caching, etc.):',
+            default: '',
+        },
+    ]);
+    // Section 2: Commands
+    console.log('');
+    logger.section('2. Commands');
+    console.log('');
+    const pmDefault = existing.packageManager || 'npm';
+    const pmCommands = getPackageManagerCommands(pmDefault);
+    const commandAnswers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'packageManager',
+            message: 'Package manager:',
+            choices: PACKAGE_MANAGERS,
+            default: pmDefault,
+        },
+        {
+            type: 'input',
+            name: 'installCommand',
+            message: 'Install command:',
+            default: (answers) => {
+                const cmds = getPackageManagerCommands(answers.packageManager);
+                return existing.installCommand || cmds.install || '';
+            },
+        },
+        {
+            type: 'input',
+            name: 'buildCommand',
+            message: 'Build command:',
+            default: (answers) => {
+                const cmds = getPackageManagerCommands(answers.packageManager);
+                return existing.buildCommand || cmds.build || '';
+            },
+        },
+        {
+            type: 'input',
+            name: 'testCommand',
+            message: 'Test command:',
+            default: (answers) => {
+                const cmds = getPackageManagerCommands(answers.packageManager);
+                return existing.testCommand || cmds.test || '';
+            },
+        },
+        {
+            type: 'input',
+            name: 'lintCommand',
+            message: 'Lint command:',
+            default: (answers) => {
+                const cmds = getPackageManagerCommands(answers.packageManager);
+                return existing.lintCommand || cmds.lint || '';
+            },
+        },
+        {
+            type: 'input',
+            name: 'devCommand',
+            message: 'Dev/run command:',
+            default: (answers) => {
+                const cmds = getPackageManagerCommands(answers.packageManager);
+                return existing.devCommand || cmds.dev || '';
+            },
+        },
+    ]);
+    // Section 3: Project Structure
+    console.log('');
+    logger.section('3. Project Structure');
+    console.log('');
+    const structureAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'sourceDirectory',
+            message: 'Source directory:',
+            default: existing.sourceDirectory || 'src/',
+        },
+        {
+            type: 'input',
+            name: 'testsDirectory',
+            message: 'Tests directory:',
+            default: existing.testsDirectory || 'tests/',
+        },
+        {
+            type: 'input',
+            name: 'keyFiles',
+            message: 'Key files agents should know about (comma-separated, format: "file:purpose"):',
+            default: '',
+        },
+    ]);
+    // Section 4: Specialists
+    console.log('');
+    logger.section('4. Specialist Agents');
+    console.log('');
+    console.log(chalk.gray('   Define specialist agents for your project.'));
+    console.log(chalk.gray('   Common types: frontend, backend, api, database, auth, devops, testing'));
+    console.log('');
+    const specialists = await specialistWizard();
+    // Section 5: MCP/Skills info
+    console.log('');
+    logger.section('5. MCP Servers & Skills');
+    console.log('');
+    console.log(chalk.gray('   MCP servers extend agent capabilities with external tools.'));
+    console.log(chalk.yellow('   Note: MCP configuration is added as a placeholder.'));
+    console.log(chalk.yellow('   Edit the config file manually to configure MCP servers.'));
+    console.log(chalk.cyan('   → See Claude Code documentation for MCP setup'));
+    console.log('');
+    // Combine answers
+    const answers = {
+        ...stackAnswers,
+        ...commandAnswers,
+        ...structureAnswers,
+        specialists,
+    };
+    // Generate config
+    console.log('');
+    const spinner = ora('Updating configuration...').start();
+    const content = generateConfig(answers, existing);
+    await fs.writeFile(FILE_PATH, content);
+    spinner.succeed('Updated archai.config.md');
+    // Final output
+    console.log('');
+    logger.divider();
+    console.log('');
+    logger.success('Configuration updated!');
+    console.log('');
+    if (specialists.length > 0) {
+        console.log(chalk.white(`Defined ${specialists.length} specialist(s):`));
+        specialists.forEach(s => {
+            console.log(chalk.cyan(`   • ${s.name}-specialist`));
+        });
+        console.log('');
+    }
+    logger.section('Next Steps');
+    console.log('');
+    console.log(chalk.white('1. Review your configuration:'));
+    console.log(chalk.cyan('   → archai.config.md'));
+    console.log('');
+    console.log(chalk.white('2. Configure MCP servers (optional):'));
+    console.log(chalk.cyan('   → Edit the "MCP Servers & Skills" section in archai.config.md'));
+    console.log('');
+    console.log(chalk.white('3. Generate specialist agents:'));
+    console.log(chalk.cyan('   → archai generate'));
+    console.log('');
+}
+async function specialistWizard() {
+    const specialists = [];
+    const { addSpecialists } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'addSpecialists',
+            message: 'Would you like to define specialist agents?',
+            default: true,
+        }]);
+    if (!addSpecialists) {
+        return specialists;
+    }
+    let addMore = true;
+    while (addMore) {
+        console.log('');
+        const { name } = await inquirer.prompt([{
+                type: 'input',
+                name: 'name',
+                message: 'Specialist name (e.g., "frontend", "api", "database"):',
+                validate: (input) => {
+                    if (!input.trim())
+                        return 'Name is required';
+                    if (input.includes(' '))
+                        return 'Use lowercase with no spaces (e.g., "frontend" not "front end")';
+                    return true;
+                },
+            }]);
+        const { focus } = await inquirer.prompt([{
+                type: 'input',
+                name: 'focus',
+                message: `What does ${name}-specialist focus on?`,
+                default: '',
+            }]);
+        const { concerns } = await inquirer.prompt([{
+                type: 'input',
+                name: 'concerns',
+                message: 'Key concerns (comma-separated):',
+                default: '',
+            }]);
+        const keyConcerns = concerns
+            .split(',')
+            .map((c) => c.trim())
+            .filter(Boolean);
+        specialists.push({ name: name.toLowerCase(), focus, keyConcerns });
+        console.log(chalk.green(`   ✓ Added ${name}-specialist`));
+        const { more } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'more',
+                message: 'Add another specialist?',
+                default: specialists.length < 3,
+            }]);
+        addMore = more;
+    }
+    return specialists;
+}
+async function parseExistingConfig() {
+    const defaults = {
+        projectName: 'my-project',
+        projectType: '',
+        isMonorepo: false,
+        languages: '',
+        frameworks: '',
+        testing: '',
+        packageManager: 'npm',
+        installCommand: '',
+        buildCommand: '',
+        testCommand: '',
+        lintCommand: '',
+        devCommand: '',
+        sourceDirectory: 'src/',
+        testsDirectory: 'tests/',
+    };
+    try {
+        const content = await fs.readFile(FILE_PATH, 'utf-8');
+        // Parse basic info
+        const nameMatch = content.match(/\*\*Name:\*\*\s*(.+)/);
+        if (nameMatch)
+            defaults.projectName = nameMatch[1].trim();
+        const typeMatch = content.match(/\*\*Type:\*\*\s*(.+)/);
+        if (typeMatch && !typeMatch[1].includes('[TODO')) {
+            defaults.projectType = typeMatch[1].trim();
+        }
+        const monoMatch = content.match(/\*\*Monorepo:\*\*\s*(Yes|No)/i);
+        if (monoMatch)
+            defaults.isMonorepo = monoMatch[1].toLowerCase() === 'yes';
+        // Parse tech stack
+        const langMatch = content.match(/\*\*Languages:\*\*\s*(.+)/);
+        if (langMatch && !langMatch[1].includes('[TODO')) {
+            defaults.languages = langMatch[1].trim();
+        }
+        const fwMatch = content.match(/\*\*Frameworks:\*\*\s*(.+)/);
+        if (fwMatch && !fwMatch[1].includes('[TODO')) {
+            defaults.frameworks = fwMatch[1].trim();
+        }
+        const testMatch = content.match(/\*\*Testing:\*\*\s*(.+)/);
+        if (testMatch && !testMatch[1].includes('[TODO')) {
+            defaults.testing = testMatch[1].trim();
+        }
+        // Parse package manager
+        const pmMatch = content.match(/\*\*Package Manager:\*\*\s*(.+)/);
+        if (pmMatch && !pmMatch[1].includes('[TODO')) {
+            defaults.packageManager = pmMatch[1].trim();
+        }
+        // Parse commands from table
+        const installMatch = content.match(/\| Install \| (.+) \|/);
+        if (installMatch && !installMatch[1].includes('[TODO')) {
+            defaults.installCommand = installMatch[1].trim();
+        }
+        const buildMatch = content.match(/\| Build \| (.+) \|/);
+        if (buildMatch && !buildMatch[1].includes('[TODO')) {
+            defaults.buildCommand = buildMatch[1].trim();
+        }
+        const testCmdMatch = content.match(/\| Test \| (.+) \|/);
+        if (testCmdMatch && !testCmdMatch[1].includes('[TODO')) {
+            defaults.testCommand = testCmdMatch[1].trim();
+        }
+        const lintMatch = content.match(/\| Lint \| (.+) \|/);
+        if (lintMatch && !lintMatch[1].includes('[TODO')) {
+            defaults.lintCommand = lintMatch[1].trim();
+        }
+        const devMatch = content.match(/\| Dev \| (.+) \|/);
+        if (devMatch && !devMatch[1].includes('[TODO')) {
+            defaults.devCommand = devMatch[1].trim();
+        }
+        // Parse structure
+        const srcMatch = content.match(/\*\*Source Directory:\*\*\s*(.+)/);
+        if (srcMatch)
+            defaults.sourceDirectory = srcMatch[1].trim();
+        const testsMatch = content.match(/\*\*Tests Directory:\*\*\s*(.+)/);
+        if (testsMatch)
+            defaults.testsDirectory = testsMatch[1].trim();
+    }
+    catch {
+        // Use defaults if parsing fails
+    }
+    return defaults;
+}
+function getPackageManagerCommands(pm) {
+    const commands = {
+        npm: {
+            install: 'npm install',
+            build: 'npm run build',
+            test: 'npm test',
+            lint: 'npm run lint',
+            dev: 'npm run dev',
+        },
+        pnpm: {
+            install: 'pnpm install',
+            build: 'pnpm build',
+            test: 'pnpm test',
+            lint: 'pnpm lint',
+            dev: 'pnpm dev',
+        },
+        yarn: {
+            install: 'yarn',
+            build: 'yarn build',
+            test: 'yarn test',
+            lint: 'yarn lint',
+            dev: 'yarn dev',
+        },
+        bun: {
+            install: 'bun install',
+            build: 'bun run build',
+            test: 'bun test',
+            lint: 'bun run lint',
+            dev: 'bun run dev',
+        },
+        pip: {
+            install: 'pip install -r requirements.txt',
+            build: 'python -m build',
+            test: 'pytest',
+            lint: 'ruff check .',
+            dev: 'python main.py',
+        },
+        cargo: {
+            install: 'cargo build',
+            build: 'cargo build --release',
+            test: 'cargo test',
+            lint: 'cargo clippy',
+            dev: 'cargo run',
+        },
+        go: {
+            install: 'go mod download',
+            build: 'go build',
+            test: 'go test ./...',
+            lint: 'golangci-lint run',
+            dev: 'go run .',
+        },
+        other: {
+            install: '',
+            build: '',
+            test: '',
+            lint: '',
+            dev: '',
+        },
+    };
+    return commands[pm] || commands.other;
+}
+function generateConfig(answers, existing) {
+    const formatAdditionalTech = (input) => {
+        if (!input.trim())
+            return '-';
+        return input.split(',')
+            .map(item => `- ${item.trim()}`)
+            .filter(Boolean)
+            .join('\n');
+    };
+    const formatKeyFiles = (input) => {
+        if (!input.trim())
+            return '| | |';
+        return input.split(',')
+            .map(item => {
+            const [file, purpose] = item.split(':').map(s => s.trim());
+            return `| ${file || ''} | ${purpose || ''} |`;
+        })
+            .join('\n');
+    };
+    const formatSpecialists = (specialists) => {
+        if (specialists.length === 0) {
+            return `### 1. [TODO: Specialist Name]
+**Focus:** [What this specialist handles]
+**Key Concerns:**
+- [Concern 1]
+- [Concern 2]
+
+### 2. [Add more as needed]
+**Focus:**
+**Key Concerns:**
+-`;
+        }
+        return specialists.map((s, i) => {
+            const concerns = s.keyConcerns.length > 0
+                ? s.keyConcerns.map(c => `- ${c}`).join('\n')
+                : '- [Add key concerns]';
+            return `### ${i + 1}. ${s.name}
+**Focus:** ${s.focus || '[What this specialist handles]'}
+**Key Concerns:**
+${concerns}`;
+        }).join('\n\n');
+    };
+    return `# archai Project Configuration
+
+> Configuration for your archai agent system.
+> Run \`archai generate\` after updating this file.
+
+---
+
+## Project Info
+
+**Name:** ${existing.projectName}
+**Type:** ${existing.projectType || '[TODO: web, mobile, cli, game, ml, devops]'}
+**Monorepo:** ${existing.isMonorepo ? 'Yes' : 'No'}
+
+---
+
+## Tech Stack
+
+**Languages:** ${answers.languages || '[TODO: TypeScript, Python, Go, etc.]'}
+**Frameworks:** ${answers.frameworks || '[TODO: React, Express, Django, etc.]'}
+**Testing:** ${answers.testing || '[TODO: vitest, jest, pytest, etc.]'}
+
+### Additional Technologies
+${formatAdditionalTech(answers.additionalTech)}
+
+---
+
+## Commands
+
+**Package Manager:** ${answers.packageManager}
+
+| Command | Script |
+|---------|--------|
+| Install | ${answers.installCommand || '[TODO]'} |
+| Build | ${answers.buildCommand || '[TODO]'} |
+| Test | ${answers.testCommand || '[TODO]'} |
+| Lint | ${answers.lintCommand || '[TODO]'} |
+| Dev | ${answers.devCommand || '[TODO]'} |
+
+---
+
+## Project Structure
+
+**Source Directory:** ${answers.sourceDirectory}
+**Tests Directory:** ${answers.testsDirectory}
+
+### Key Files
+| File | Purpose |
+|------|---------|
+${formatKeyFiles(answers.keyFiles)}
+
+---
+
+## Specialists to Generate
+
+<!--
+These specialist agents will be generated by Claude Code.
+Run \`archai generate\` to create them.
+-->
+
+${formatSpecialists(answers.specialists)}
+
+---
+
+## MCP Servers & Skills
+
+<!--
+Configure MCP servers to extend agent capabilities.
+MCP (Model Context Protocol) allows agents to interact with external tools and services.
+
+Example configuration (edit manually):
+
+### Database Tools
+- Server: @anthropic/mcp-server-postgres
+- Purpose: Query and manage database
+
+### File System
+- Server: @anthropic/mcp-server-filesystem
+- Purpose: Enhanced file operations
+
+For setup instructions, see Claude Code documentation.
+-->
+
+[TODO: Configure MCP servers if needed]
+
+---
+
+## Permissions
+
+<!-- Commands agents are allowed to run -->
+- ${answers.packageManager} *
+- npx *
+
+---
+
+## Notes
+
+<!-- Any additional context for agents -->
+
+`;
+}
+//# sourceMappingURL=setup-config.js.map

package/dist/commands/setup-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-config.js","sourceRoot":"","sources":["../../src/commands/setup-config.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup-project.d.ts

@@ -0,0 +1,6 @@
+interface SetupProjectOptions {
+    force?: boolean;
+}
+export declare function setupProject(options: SetupProjectOptions): Promise<void>;
+export {};
+//# sourceMappingURL=setup-project.d.ts.map

package/dist/commands/setup-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-project.d.ts","sourceRoot":"","sources":["../../src/commands/setup-project.ts"],"names":[],"mappings":"AAMA,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+BD,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgO9E"}

package/dist/commands/setup-project.js

@@ -0,0 +1,359 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import { logger } from '../utils/logger.js';
+const FILE_PATH = '.knowledge/context/project-description.md';
+export async function setupProject(options) {
+    logger.banner();
+    // Check if file exists
+    const exists = await fs.pathExists(FILE_PATH);
+    if (exists && !options.force) {
+        const { mode } = await inquirer.prompt([{
+                type: 'list',
+                name: 'mode',
+                message: 'project-description.md already exists. What would you like to do?',
+                choices: [
+                    { name: 'Update (fill in placeholders, keep custom content)', value: 'update' },
+                    { name: 'Overwrite (start fresh)', value: 'overwrite' },
+                    { name: 'Cancel', value: 'cancel' }
+                ]
+            }]);
+        if (mode === 'cancel') {
+            logger.info('Setup cancelled.');
+            return;
+        }
+        if (mode === 'update') {
+            logger.info('Update mode: Existing custom content will be preserved where possible.');
+        }
+    }
+    // Load defaults from config if available
+    const defaults = await loadConfigDefaults();
+    console.log('');
+    logger.section('Project Description Wizard');
+    console.log(chalk.gray('   Fill in details about your project for AI agents.'));
+    console.log(chalk.gray('   Press Enter to skip questions you\'re unsure about.'));
+    console.log('');
+    // Section 1: Overview
+    logger.section('1. Project Overview');
+    console.log('');
+    const overviewAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'oneLineDescription',
+            message: 'One-line description (what does this project do?):',
+            default: '',
+        },
+        {
+            type: 'editor',
+            name: 'detailedDescription',
+            message: 'Detailed description (2-3 paragraphs - opens editor):',
+            default: '[Describe the project purpose, target users, and core functionality]',
+        },
+    ]);
+    // Section 2: Architecture
+    console.log('');
+    logger.section('2. Architecture');
+    console.log('');
+    const architectureAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'architecture',
+            message: 'High-level architecture (client/server, microservices, monolith, etc.):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'keyModules',
+            message: 'Key modules/packages (comma-separated):',
+            default: defaults.isMonorepo ? 'packages/, apps/' : 'src/',
+        },
+    ]);
+    // Section 3: Domain
+    console.log('');
+    logger.section('3. Domain Concepts');
+    console.log('');
+    const domainAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'coreEntities',
+            message: 'Core entities/domain objects (comma-separated):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'keyWorkflows',
+            message: 'Key workflows/user flows (comma-separated):',
+            default: '',
+        },
+    ]);
+    // Section 4: Technical Constraints
+    console.log('');
+    logger.section('4. Technical Constraints');
+    console.log('');
+    const technicalAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'performanceRequirements',
+            message: 'Performance requirements (e.g., "1000 concurrent users"):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'compatibilityRequirements',
+            message: 'Compatibility requirements (e.g., "Modern browsers, iOS 14+"):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'securityConsiderations',
+            message: 'Security considerations (e.g., "Auth required, data encryption"):',
+            default: '',
+        },
+    ]);
+    // Section 5: Development Guidelines
+    console.log('');
+    logger.section('5. Development Guidelines');
+    console.log('');
+    const guidelinesAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'codeStyle',
+            message: 'Code style/patterns to follow:',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'whatToAvoid',
+            message: 'What to avoid (anti-patterns, deprecated approaches):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'testingPhilosophy',
+            message: 'Testing philosophy (how thorough? what must be tested?):',
+            default: '',
+        },
+    ]);
+    // Section 6: External Integrations
+    console.log('');
+    logger.section('6. External Integrations');
+    console.log('');
+    const integrationsAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'externalIntegrations',
+            message: 'External services/APIs (comma-separated, format: "Service:Purpose"):',
+            default: '',
+        },
+    ]);
+    // Section 7: Current State
+    console.log('');
+    logger.section('7. Current State');
+    console.log('');
+    const stateAnswers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'workingFeatures',
+            message: 'What\'s currently working (comma-separated):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'knownIssues',
+            message: 'Known issues (comma-separated):',
+            default: '',
+        },
+        {
+            type: 'input',
+            name: 'upcomingPriorities',
+            message: 'Upcoming priorities (comma-separated):',
+            default: '',
+        },
+    ]);
+    // Combine all answers
+    const answers = {
+        ...overviewAnswers,
+        ...architectureAnswers,
+        ...domainAnswers,
+        ...technicalAnswers,
+        ...guidelinesAnswers,
+        ...integrationsAnswers,
+        ...stateAnswers,
+    };
+    // Generate content
+    console.log('');
+    const spinner = ora('Generating project description...').start();
+    const content = generateProjectDescription(answers, defaults);
+    await fs.ensureDir('.knowledge/context');
+    await fs.writeFile(FILE_PATH, content);
+    spinner.succeed('Created project-description.md');
+    // Final output
+    console.log('');
+    logger.divider();
+    console.log('');
+    logger.success('Project description updated!');
+    console.log('');
+    logger.section('Next Steps');
+    console.log('');
+    console.log(chalk.white('1. Review and refine:'));
+    console.log(chalk.cyan('   → .knowledge/context/project-description.md'));
+    console.log('');
+    console.log(chalk.white('2. Generate specialist agents:'));
+    console.log(chalk.cyan('   → archai generate'));
+    console.log('');
+}
+async function loadConfigDefaults() {
+    const defaults = {
+        projectName: 'my-project',
+        languages: '',
+        frameworks: '',
+        testFramework: '',
+        isMonorepo: false,
+    };
+    try {
+        if (await fs.pathExists('archai.config.md')) {
+            const content = await fs.readFile('archai.config.md', 'utf-8');
+            // Parse project name
+            const nameMatch = content.match(/\*\*Name:\*\*\s*(.+)/);
+            if (nameMatch)
+                defaults.projectName = nameMatch[1].trim();
+            // Parse languages
+            const langMatch = content.match(/\*\*Languages:\*\*\s*(.+)/);
+            if (langMatch && !langMatch[1].includes('[TODO')) {
+                defaults.languages = langMatch[1].trim();
+            }
+            // Parse frameworks
+            const fwMatch = content.match(/\*\*Frameworks:\*\*\s*(.+)/);
+            if (fwMatch && !fwMatch[1].includes('[TODO')) {
+                defaults.frameworks = fwMatch[1].trim();
+            }
+            // Parse testing
+            const testMatch = content.match(/\*\*Testing:\*\*\s*(.+)/);
+            if (testMatch && !testMatch[1].includes('[TODO')) {
+                defaults.testFramework = testMatch[1].trim();
+            }
+            // Parse monorepo
+            const monoMatch = content.match(/\*\*Monorepo:\*\*\s*(Yes|No)/i);
+            if (monoMatch)
+                defaults.isMonorepo = monoMatch[1].toLowerCase() === 'yes';
+        }
+    }
+    catch {
+        // Use defaults if config can't be read
+    }
+    return defaults;
+}
+function generateProjectDescription(answers, defaults) {
+    const formatList = (input, prefix = '- ') => {
+        if (!input.trim())
+            return `${prefix}[TODO]`;
+        return input.split(',')
+            .map(item => item.trim())
+            .filter(Boolean)
+            .map(item => `${prefix}${item}`)
+            .join('\n');
+    };
+    const formatEntities = (input) => {
+        if (!input.trim())
+            return '- **Entity1**: Description\n- **Entity2**: Description';
+        return input.split(',')
+            .map(item => item.trim())
+            .filter(Boolean)
+            .map(item => `- **${item}**: [Description]`)
+            .join('\n');
+    };
+    const formatWorkflows = (input) => {
+        if (!input.trim())
+            return '1. Workflow: [Description]';
+        return input.split(',')
+            .map((item, i) => `${i + 1}. ${item.trim()}: [Description]`)
+            .join('\n');
+    };
+    const formatIntegrations = (input) => {
+        if (!input.trim())
+            return '| [Service] | [Purpose] | [Notes] |';
+        return input.split(',')
+            .map(item => {
+            const [service, purpose] = item.split(':').map(s => s.trim());
+            return `| ${service || '[Service]'} | ${purpose || '[Purpose]'} | |`;
+        })
+            .join('\n');
+    };
+    return `# Project Description
+
+> This file provides context to all agents. Keep it updated.
+
+## Project Overview
+
+**Name:** ${defaults.projectName}
+
+**One-line description:**
+${answers.oneLineDescription || '[What does this project do in one sentence?]'}
+
+**Detailed description:**
+${answers.detailedDescription || '[2-3 paragraphs explaining the project, its purpose, target users, and core functionality]'}
+
+## Tech Stack
+
+**Languages:** ${defaults.languages || '[TODO: Add your languages]'}
+**Frameworks:** ${defaults.frameworks || '[TODO: Add your frameworks]'}
+**Testing:** ${defaults.testFramework || '[TODO: Add your test framework]'}
+
+## Architecture
+
+**High-level architecture:**
+${answers.architecture || '[Describe how the system is structured - client/server, microservices, monolith, etc.]'}
+
+**Key modules/packages:**
+${formatList(answers.keyModules)}
+
+## Domain Concepts
+
+**Core entities:**
+${formatEntities(answers.coreEntities)}
+
+**Key workflows:**
+${formatWorkflows(answers.keyWorkflows)}
+
+## Technical Constraints
+
+**Performance requirements:**
+${formatList(answers.performanceRequirements)}
+
+**Compatibility requirements:**
+${formatList(answers.compatibilityRequirements)}
+
+**Security considerations:**
+${formatList(answers.securityConsiderations)}
+
+## Development Guidelines
+
+**Code style:**
+${answers.codeStyle || '[Any specific conventions, patterns to follow]'}
+
+**What to avoid:**
+${answers.whatToAvoid || '[Anti-patterns, deprecated approaches, things NOT to do]'}
+
+**Testing philosophy:**
+${answers.testingPhilosophy || '[How thorough should tests be? What must be tested?]'}
+
+## External Integrations
+
+| Service | Purpose | Notes |
+|---------|---------|-------|
+${formatIntegrations(answers.externalIntegrations)}
+
+## Current State
+
+**What's working:**
+${formatList(answers.workingFeatures)}
+
+**Known issues:**
+${formatList(answers.knownIssues)}
+
+**Upcoming priorities:**
+${formatList(answers.upcomingPriorities)}
+`;
+}
+//# sourceMappingURL=setup-project.js.map

package/dist/commands/setup-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-project.js","sourceRoot":"","sources":["../../src/commands/setup-project.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zik000/archai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Multi-agent AI development workflow setup for any project",
   "keywords": [
     "claude",

package/templates/ARCHAI_README.md

@@ -323,4 +323,4 @@ After 4 iterations, the requirements might be unclear. Provide more context or s
 
 ---
 
-*Powered by archai - Multi-agent AI development workflow*
+*Powered by [@zik000/archai](https://www.npmjs.com/package/@zik000/archai) - Multi-agent AI development workflow*

package/templates/core-agents/iteration-controller.md

@@ -80,6 +80,37 @@ You are a development workflow orchestrator with a THREE-PHASE ITERATION archite
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
 
+## Step -1: Git Branch Verification (MANDATORY FIRST)
+
+**STOP. Before ANYTHING else, verify you are on a feature branch.**
+
+### Check Current Branch
+```bash
+git branch --show-current
+```
+
+### If on main/master/develop:
+1. **DO NOT PROCEED** with any work
+2. Create a feature branch immediately:
+   ```bash
+   git checkout -b agent/[task-id]-[short-description]
+   ```
+3. Example: `git checkout -b agent/TASK-001-add-user-auth`
+
+### If already on feature branch:
+- Verify branch follows pattern: `agent/*` or `feature/*`
+- Proceed to Step 0
+
+### Branch Naming Convention
+- Format: `agent/[task-id]-[short-description]`
+- Lowercase with hyphens, description under 30 chars
+- Examples: `agent/TASK-042-fix-login`, `agent/epic-15-refactor-auth`
+
+### Protected Branches (NEVER work directly on these)
+`main`, `master`, `develop`, `release/*`
+
+---
+
 ## Project Context
 
 Read project context from:

package/templates/core-agents/task-orchestrator.md

@@ -62,6 +62,35 @@ branch: null | branch-name
 
 ## Orchestration Protocol
 
+### Step 0: Git Branch Verification (MANDATORY FIRST)
+
+**Before doing ANYTHING else, verify your git status.**
+
+```bash
+# Check current branch
+git branch --show-current
+
+# Check for uncommitted changes
+git status
+```
+
+#### If on main/master/develop:
+1. **DO NOT claim any task yet**
+2. If you know which task you'll work on, create the branch now:
+   ```bash
+   git checkout -b agent/[task-id]-[short-description]
+   ```
+3. If unsure which task, proceed to Step 1 to select a task, then return here to create the branch
+
+#### If you have uncommitted changes:
+- Stash or commit them to the appropriate branch
+- Never leave work uncommitted when switching contexts
+
+#### Protected Branches (NEVER work directly on these)
+`main`, `master`, `develop`, `release/*`
+
+---
+
 ### Step 1: Claim a Task
 
 Find highest priority task in inbox:
@@ -76,13 +105,23 @@ Claim it by:
 2. Set `assignee` to current session
 3. Move to `.tasks/epics/`
 
-### Step 2: Create Branch
+### Step 2: Create/Verify Branch
+
+**Verify you are NOT on a protected branch before proceeding.**
+
+If not already on a feature branch (from Step 0), create one:
 
 ```bash
 # Create feature branch
 git checkout -b agent/[task-id]-[short-description]
 ```
 
+Branch naming:
+- Format: `agent/[task-id]-[short-description]`
+- Lowercase with hyphens
+- Description under 30 chars
+- Example: `agent/TASK-042-fix-login-bug`
+
 Update task file with branch name.
 
 ### Step 3: Execute Workflow