@agentic15.com/agentic15-claude-zen 2.0.6 → 2.0.9

package/CHANGELOG.md

@@ -7,6 +7,121 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Copyright 2024-2025 agentic15.com
 
+## [2.0.9] - 2025-12-25
+
+### Changed
+- **BREAKING**: Removed obfuscated scripts directory (contained old v1.x minified code)
+- **BREAKING**: Removed npm scripts (plan:generate, plan:init) - no longer needed
+- Refactored PlanCommand.js to have plan generation/locking logic built-in (no external scripts)
+- Package now uses ONLY CLI commands as documented in WORKFLOWS.md
+- Package size: 45.7 kB compressed, 176.5 kB unpacked (52 files)
+- TaskIssueMapper now follows .github/ISSUE_TEMPLATE/task.md structure for consistency
+- CommitCommand now follows .github/PULL_REQUEST_TEMPLATE.md structure for PRs
+- Updated onboarding instructions to show v2.0 CLI commands (removed outdated npm scripts)
+
+### Added
+- GitHub issue and PR templates (.github/ISSUE_TEMPLATE/task.md, PULL_REQUEST_TEMPLATE.md)
+- CLI now uses templates for consistent issue/PR formatting
+- Built-in plan generation logic in PlanCommand class
+- Built-in plan locking logic with task extraction
+- Support for v2.0 schema (singular 'project' at root) in extractTasks()
+- Standardized issue body format with sections: Task Description, Completion Criteria, Dependencies, Phase
+- Standardized PR body format with sections: Task, Description, Changes, Testing, Notes
+
+### Fixed
+- **BUG #1**: Incorrect import path in bin/create-agentic15-claude-zen.js (dist/index.js → src/index.js)
+- **BUG #2**: Wrong template path in TemplateManager.js (needed to go up 2 levels from src/core/)
+- **BUG #3**: Removed obsolete extractBundledFiles() call (tried to copy non-existent scripts)
+- **BUG #4**: extractTasks() now handles v2.0 schema with singular 'project' key
+- **BUG #5**: TaskCommand.js calls correct TaskIssueMapper methods (not non-existent mapTaskToIssue)
+
+### Removed
+- All obfuscated v1.x scripts (19 files, ~248KB of minified code)
+- npm run plan:* commands from templates
+- extractBundledFiles() method call from ProjectInitializer
+
+### Testing
+- Black box testing completed with 5 bugs found and fixed
+- Successfully tested: project creation, auth setup, plan generation, plan locking, task extraction, feature branch creation
+- Test repository: https://github.com/agentic15/agentic15-test-v2
+
+## [2.0.8] - 2025-12-25
+
+### Changed
+- Removed entire dist/ folder (48 minified files)
+- Changed to ship source code only (no minification)
+- Updated package.json main entry from dist/index.js to src/index.js
+- Removed all build/minification scripts
+
+### Fixed
+- Fixed obfuscated/minified code showing wrong v1.x commands
+
+## [2.0.7] - 2025-12-25
+
+### Removed
+- Deleted CLAUDE.md (1,100+ lines of obsolete v1.x documentation)
+- Deleted ONBOARDING.md (86 lines of obsolete v1.x onboarding)
+
+### Changed
+- Updated templates/README.md with v2.0 commands
+
+## [2.0.6] - 2025-12-25
+
+### Changed
+- Added PowerShell syntax to README.md and WORKFLOWS.md
+- PowerShell requires quotes: `npx "@agentic15.com/agentic15-claude-zen" my-project`
+
+## [2.0.5] - 2025-12-25
+
+### Changed
+- Simplified README.md from 307 lines to 68 lines
+- README now just points to WORKFLOWS.md for detailed workflows
+
+## [2.0.4] - 2025-12-25
+
+### Fixed
+- Fixed package README.md with broken documentation links
+- Removed references to deleted docs/ folder
+
+## [2.0.3] - 2025-12-25
+
+### Changed
+- Further simplified README.md to match WORKFLOWS.md style
+- Consolidated all workflow documentation
+
+## [2.0.2] - 2025-12-25
+
+### Changed
+- Simplified README.md to focus on quick start and command reference
+- All detailed workflows now in WORKFLOWS.md
+
+## [2.0.1] - 2025-12-25
+
+### Changed
+- Updated package README with correct v2.0 commands
+- Fixed mermaid diagram syntax errors in WORKFLOWS.md
+
+## [2.0.0] - 2025-12-25
+
+### Added
+- CLI-based architecture (`npx agentic15` commands)
+- Dedicated agentic15 CLI binary for all automation
+- Single WORKFLOWS.md with mermaid diagrams
+- Visual testing feedback loop
+- Auto-generated commit messages
+- Feature branch workflow with PRs
+- GitHub issue/PR integration
+
+### Removed
+- All npm run task:* commands (replaced by CLI)
+- 9 workflow documentation files (3,526 lines)
+- docs/ folder
+
+### Changed
+- Workflow now requires feature branches + PRs (no direct main commits)
+- Simplified documentation to <20 line POST-INSTALL.md + WORKFLOWS.md
+- Commit messages auto-generated as [TASK-XXX] title
+
 ## [1.0.1] - 2025-12-24
 
 ### Changed

package/bin/create-agentic15-claude-zen.js

@@ -176,7 +176,7 @@ async function main() {
 
   // Import and run initialization
   try {
-    const { initializeProject } = await import('../dist/index.js');
+    const { initializeProject } = await import('../src/index.js');
     await initializeProject(projectName, targetDir, { initGit, installDeps });
 
     console.log('\n✅ Project created successfully!\n');

package/package.json

@@ -1,19 +1,17 @@
 {
   "name": "@agentic15.com/agentic15-claude-zen",
-  "version": "2.0.6",
+  "version": "2.0.9",
   "description": "Structured AI-assisted development framework for Claude Code with enforced quality standards",
-  "main": "dist/index.js",
+  "main": "src/index.js",
   "bin": {
     "agentic15-claude-zen": "./bin/create-agentic15-claude-zen.js",
     "agentic15": "./bin/agentic15.js"
   },
   "type": "module",
   "scripts": {
-    "build": "node esbuild.config.js",
     "test": "node test/integration.test.js",
     "test:e2e": "node test/e2e-verification.test.js",
-    "test:site": "node test/verify-test-site.js",
-    "prepublishOnly": "npm run build"
+    "test:site": "node test/verify-test-site.js"
   },
   "keywords": [
     "agentic15",
@@ -44,7 +42,6 @@
   "files": [
     "bin/",
     "src/",
-    "dist/",
     "templates/",
     "templates/.gitignore",
     "README.md",

package/src/cli/CommitCommand.js

@@ -178,13 +178,29 @@ export class CommitCommand {
         taskData = task;
       }
 
-      // Build PR body
-      let prBody = taskData.description || '';
+      // Build PR body following .github/PULL_REQUEST_TEMPLATE.md structure
+      let prBody = `## Task\n\n`;
 
       if (taskData.githubIssue) {
-        prBody += `\n\nCloses #${taskData.githubIssue}`;
+        prBody += `Closes #${taskData.githubIssue}\n\n`;
+      } else {
+        prBody += `${task.id}\n\n`;
       }
 
+      prBody += `## Description\n\n`;
+      prBody += `${taskData.description || task.description || commitMessage}\n\n`;
+
+      prBody += `## Changes\n\n`;
+      prBody += `- Implemented ${task.title}\n\n`;
+
+      prBody += `## Testing\n\n`;
+      prBody += `- [x] Unit tests pass (\`npm test\`)\n`;
+      prBody += `- [ ] Visual tests pass (if applicable) (\`npx playwright test\`)\n`;
+      prBody += `- [ ] Code follows project conventions\n\n`;
+
+      prBody += `## Notes\n\n`;
+      prBody += `Auto-generated by Agentic15 Claude Zen`;
+
       // Create PR using gh CLI
       const prCommand = `gh pr create --title "${commitMessage}" --body "${prBody}" --base ${mainBranch}`;
       const prOutput = execSync(prCommand, { encoding: 'utf-8' });

package/src/cli/PlanCommand.js

@@ -1,4 +1,3 @@
-import { execSync } from 'child_process';
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
 import { join } from 'path';
 
@@ -49,31 +48,75 @@ export class PlanCommand {
     console.log('\n📋 Generating new plan...\n');
 
     try {
-      // Run plan:generate script
-      execSync(`npm run plan:generate "${description}"`, { stdio: 'inherit' });
+      // Create plan ID
+      const planId = this.getNextPlanId();
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
 
-      // Find the generated plan
-      const plansDir = join(process.cwd(), '.claude', 'plans');
-      const plans = readdirSync(plansDir)
-        .filter(name => name.startsWith('plan-') && name.includes('-generated'));
+      // Create plan directory
+      mkdirSync(planPath, { recursive: true });
 
-      if (plans.length === 0) {
-        console.log('\n❌ Failed to generate plan\n');
-        process.exit(1);
-      }
+      // Create PROJECT-REQUIREMENTS.txt
+      const requirementsPath = join(planPath, 'PROJECT-REQUIREMENTS.txt');
+      const requirementsContent = `PROJECT REQUIREMENTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+${description}
+
+Generated: ${new Date().toISOString()}
+PLAN ID: ${planId}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+INSTRUCTIONS FOR CLAUDE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Please analyze the requirements above and create a comprehensive project plan.
+
+1. Read the PLAN-SCHEMA.json to understand the plan structure
+2. Read the PROJECT-PLAN-TEMPLATE.json for the format
+3. Create a PROJECT-PLAN.json file in this directory with:
+   - Clear project/subproject/milestone hierarchy
+   - Detailed tasks with IDs (TASK-001, TASK-002, etc.)
+   - Proper dependencies between tasks
+   - Realistic time estimates
+   - Phases: design, implementation, testing, deployment
+   - Completion criteria for each task
+
+4. Structure the plan to follow these phases:
+   - DESIGN: Architecture, UI/UX, database schema
+   - IMPLEMENTATION: Core features, API, frontend
+   - TESTING: Unit tests, integration tests, E2E tests
+   - DEPLOYMENT: Build, CI/CD, documentation
+
+5. Ensure tasks are:
+   - Granular (2-8 hours each)
+   - Clearly defined with specific deliverables
+   - Properly sequenced with dependencies
+   - Grouped logically by feature/component
+
+6. After creating the plan, tell the user to run:
+   npx agentic15 plan
 
-      // Use the most recent generated plan
-      const planId = plans[plans.length - 1];
+This will lock the plan and generate the task tracker.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+GENERATED: ${new Date().toISOString()}
+`;
+
+      writeFileSync(requirementsPath, requirementsContent);
 
       // Set as active plan
-      const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
+      const claudeDir = join(process.cwd(), '.claude');
+      if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+      }
+      const activePlanPath = join(claudeDir, 'ACTIVE-PLAN');
       writeFileSync(activePlanPath, planId);
 
-      console.log(`\n✅ Plan requirements created: ${planId}`);
+      console.log(`✅ Plan requirements created: ${planId}`);
       console.log(`   Location: .claude/plans/${planId}/PROJECT-REQUIREMENTS.txt\n`);
       console.log('💡 Next steps:');
       console.log(`   1. Tell Claude: "Create the project plan"`);
-      console.log(`   2. When Claude is done, run: agentic15 plan\n`);
+      console.log(`   2. When Claude is done, run: npx agentic15 plan\n`);
     } catch (error) {
       console.log(`\n❌ Failed to generate plan: ${error.message}\n`);
       process.exit(1);
@@ -84,20 +127,106 @@ export class PlanCommand {
     console.log(`📋 Locking plan: ${planId}\n`);
 
     try {
-      // Run plan:init script
-      execSync('npm run plan:init', { stdio: 'inherit' });
+      const planPath = join(process.cwd(), '.claude', 'plans', planId);
+      const projectPlanPath = join(planPath, 'PROJECT-PLAN.json');
 
-      console.log('\n✅ Plan locked successfully\n');
+      // Verify PROJECT-PLAN.json exists
+      if (!existsSync(projectPlanPath)) {
+        console.log('\n❌ PROJECT-PLAN.json not found');
+        console.log('   Tell Claude to create the plan first\n');
+        process.exit(1);
+      }
 
-      this.showPlanStatus(planId);
+      // Read the plan
+      const plan = JSON.parse(readFileSync(projectPlanPath, 'utf-8'));
 
-      console.log('💡 Next step: agentic15 task next\n');
+      // Extract tasks from plan
+      const tasks = [];
+      this.extractTasks(plan, tasks);
+
+      // Create task files
+      const tasksDir = join(planPath, 'tasks');
+      if (!existsSync(tasksDir)) {
+        mkdirSync(tasksDir, { recursive: true });
+      }
+
+      // Write individual task files
+      tasks.forEach(task => {
+        const taskPath = join(tasksDir, `${task.id}.json`);
+        writeFileSync(taskPath, JSON.stringify(task, null, 2));
+      });
+
+      // Create task tracker
+      const tracker = {
+        planId,
+        lockedAt: new Date().toISOString(),
+        taskFiles: tasks.map(task => ({
+          id: task.id,
+          title: task.title,
+          phase: task.phase || 'implementation',
+          status: 'pending',
+          description: task.description
+        }))
+      };
+
+      const trackerPath = join(planPath, 'TASK-TRACKER.json');
+      writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
+
+      // Mark as locked
+      const lockedPath = join(planPath, '.plan-locked');
+      writeFileSync(lockedPath, new Date().toISOString());
+
+      console.log('✅ Plan locked successfully\n');
+      this.showPlanStatus(planId);
+      console.log('💡 Next step: npx agentic15 task next\n');
     } catch (error) {
       console.log(`\n❌ Failed to lock plan: ${error.message}\n`);
       process.exit(1);
     }
   }
 
+  static extractTasks(obj, tasks) {
+    // Recursively extract all tasks from the plan structure
+    if (obj.tasks && Array.isArray(obj.tasks)) {
+      tasks.push(...obj.tasks);
+    }
+
+    // Check nested structures
+    if (obj.milestones && Array.isArray(obj.milestones)) {
+      obj.milestones.forEach(milestone => this.extractTasks(milestone, tasks));
+    }
+
+    if (obj.subprojects && Array.isArray(obj.subprojects)) {
+      obj.subprojects.forEach(subproject => this.extractTasks(subproject, tasks));
+    }
+
+    if (obj.projects && Array.isArray(obj.projects)) {
+      obj.projects.forEach(project => this.extractTasks(project, tasks));
+    }
+
+    // Handle singular 'project' at root level (v2.0 schema)
+    if (obj.project && typeof obj.project === 'object') {
+      this.extractTasks(obj.project, tasks);
+    }
+  }
+
+  static getNextPlanId() {
+    const plansDir = join(process.cwd(), '.claude', 'plans');
+
+    if (!existsSync(plansDir)) {
+      mkdirSync(plansDir, { recursive: true });
+    }
+
+    const existingPlans = readdirSync(plansDir)
+      .filter(name => name.match(/^plan-\d{3}-/i))
+      .map(name => parseInt(name.match(/^plan-(\d{3})-/i)[1]))
+      .filter(num => !isNaN(num));
+
+    const nextNum = existingPlans.length > 0 ? Math.max(...existingPlans) + 1 : 1;
+
+    return `plan-${String(nextNum).padStart(3, '0')}-generated`;
+  }
+
   static showPlanStatus(planId) {
     const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
 

package/src/cli/TaskCommand.js

@@ -152,7 +152,9 @@ export class TaskCommand {
       const taskPath = this.getTaskPath(task.id);
       const taskData = JSON.parse(readFileSync(taskPath, 'utf-8'));
 
-      const { title, body, labels } = TaskIssueMapper.mapTaskToIssue(taskData);
+      const title = TaskIssueMapper.taskToIssueTitle(taskData);
+      const body = TaskIssueMapper.taskToIssueBody(taskData);
+      const labels = TaskIssueMapper.taskStatusToLabels(taskData.status || 'pending', taskData.phase);
       const issueNumber = await client.createIssue(title, body, labels);
 
       if (issueNumber) {

package/src/core/ProjectInitializer.js

@@ -53,25 +53,22 @@ export class ProjectInitializer {
     // Step 1: Copy templates
     await this.templateManager.copyTemplates(projectName, targetDir);
 
-    // Step 2: Extract bundled scripts and hooks
-    await this.templateManager.extractBundledFiles(targetDir);
-
-    // Step 3: Initialize git repository
+    // Step 2: Initialize git repository
     if (initGit) {
       await this.gitInitializer.initialize(targetDir);
     }
 
-    // Step 4: Install dependencies
+    // Step 3: Install dependencies
     if (installDeps) {
       await this.dependencyInstaller.install(targetDir);
     }
 
-    // Step 5: Setup git hooks
+    // Step 4: Setup git hooks
     if (initGit) {
       await this.hookInstaller.install(targetDir);
     }
 
-    // Step 6: Display onboarding instructions
+    // Step 5: Display onboarding instructions
     this.displayOnboarding();
   }
 
@@ -80,26 +77,25 @@ export class ProjectInitializer {
    */
   displayOnboarding() {
     console.log('\n' + '═'.repeat(70));
-    console.log('🎯 CRITICAL: NEXT STEP FOR CLAUDE CODE');
+    console.log('🎯 PROJECT CREATED SUCCESSFULLY');
     console.log('═'.repeat(70));
     console.log('\n📖 READ THIS FILE: .claude/POST-INSTALL.md');
-    console.log('\n   This file contains the COMPLETE 6-step setup workflow.');
-    console.log('   Single clear path - no confusion or multiple options.\n');
-    console.log('🚀 QUICK START (6 steps):');
-    console.log('  1. npm run plan:generate "description"');
-    console.log('  2. Claude creates PROJECT-PLAN.json');
-    console.log('  3. echo "plan-001-generated" > .claude/ACTIVE-PLAN');
-    console.log('  4. npm run plan:init');
-    console.log('  5. npm run task:start TASK-001');
-    console.log('  6. Work on task (9-step workflow in POST-INSTALL.md)');
+    console.log('\n   Complete workflow documentation with examples.\n');
+    console.log('🚀 QUICK START:');
+    console.log('  1. npx agentic15 auth');
+    console.log('  2. npx agentic15 plan "Your project description"');
+    console.log('  3. Tell Claude: "Create the project plan"');
+    console.log('  4. npx agentic15 plan (locks the plan)');
+    console.log('  5. npx agentic15 task next');
+    console.log('  6. Tell Claude: "Write code for TASK-001"');
+    console.log('  7. npx agentic15 commit');
     console.log('\n📂 Your Workspace:');
-    console.log('  ./Agent/     - Edit your source code here');
-    console.log('  ./scripts/   - Edit your scripts here');
-    console.log('  ./.claude/   - Framework files (DO NOT EDIT)');
-    console.log('\n⚠️  Work on main branch only - NO feature branches');
-    console.log('⚠️  Hooks enforce rules - violations will be BLOCKED');
+    console.log('  ./Agent/src/     - Your source code');
+    console.log('  ./Agent/tests/   - Your test files');
+    console.log('  ./test-site/     - Test site for visual verification');
+    console.log('  ./.claude/       - Framework files (auto-managed)');
     console.log('\n' + '═'.repeat(70));
-    console.log('✅ Setup complete! Read .claude/POST-INSTALL.md to continue.');
+    console.log('✅ Setup complete! See .claude/POST-INSTALL.md for details.');
     console.log('═'.repeat(70) + '\n');
   }
 }

package/src/core/TaskIssueMapper.js

@@ -34,48 +34,52 @@ export class TaskIssueMapper {
   }
 
   /**
-   * Generate GitHub issue body from task
+   * Generate GitHub issue body from task using issue template format
    *
    * @param {Object} task - Task object
    * @returns {string} Issue body in markdown format
    */
   static taskToIssueBody(task) {
-    let body = `## Task: ${task.title}\n\n`;
+    // Follow .github/ISSUE_TEMPLATE/task.md structure
+    let body = `## Task Description\n\n`;
 
     if (task.description) {
       body += `${task.description}\n\n`;
     }
 
-    if (task.phase) {
-      body += `**Phase:** ${task.phase}\n`;
-    }
-
     if (task.estimatedHours) {
-      body += `**Estimated Hours:** ${task.estimatedHours}h\n`;
+      body += `**Estimated Hours:** ${task.estimatedHours}h\n\n`;
     }
 
+    body += `## Completion Criteria\n\n`;
     if (task.completionCriteria && task.completionCriteria.length > 0) {
-      body += `\n### Completion Criteria\n\n`;
       task.completionCriteria.forEach(criteria => {
         body += `- [ ] ${criteria}\n`;
       });
+    } else {
+      body += `*No specific criteria defined*\n`;
     }
 
+    body += `\n## Dependencies\n\n`;
     if (task.dependencies && task.dependencies.length > 0) {
-      body += `\n### Dependencies\n\n`;
       task.dependencies.forEach(dep => {
         body += `- ${dep}\n`;
       });
+    } else {
+      body += `*No dependencies*\n`;
     }
 
+    body += `\n## Phase\n\n`;
+    body += `${task.phase || 'implementation'}\n`;
+
     if (task.testCases && task.testCases.length > 0) {
-      body += `\n### Test Cases\n\n`;
+      body += `\n## Test Cases\n\n`;
       task.testCases.forEach(test => {
         body += `- ${test}\n`;
       });
     }
 
-    body += `\n---\n*Auto-created by Agentic15 Claude Zen*`;
+    body += `\n---\n*Auto-generated by Agentic15 Claude Zen*`;
 
     return body;
   }

package/src/core/TemplateManager.js

@@ -28,7 +28,8 @@ const __dirname = dirname(__filename);
  */
 export class TemplateManager {
   constructor() {
-    this.templatesDir = join(__dirname, '..', 'templates');
+    // From src/core/, go up two levels to package root, then into templates
+    this.templatesDir = join(__dirname, '..', '..', 'templates');
     this.distDir = join(__dirname, '.');
   }
 

package/templates/.github/ISSUE_TEMPLATE/task.md

@@ -0,0 +1,23 @@
+---
+name: Task
+about: Auto-generated task from Agentic15 plan
+title: '[TASK-XXX] '
+labels: 'task'
+assignees: ''
+---
+
+## Task Description
+
+<!-- Auto-generated from PROJECT-PLAN.json -->
+
+## Completion Criteria
+
+<!-- Auto-populated from task definition -->
+
+## Dependencies
+
+<!-- Auto-populated from task definition -->
+
+## Phase
+
+<!-- Auto-populated from task definition -->

package/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+# Pull Request
+
+## Task
+
+Closes #
+
+## Description
+
+<!-- Auto-generated from task description -->
+
+## Changes
+
+-
+
+## Testing
+
+- [ ] Unit tests pass (`npm test`)
+- [ ] Visual tests pass (if applicable) (`npx playwright test`)
+- [ ] Code follows project conventions
+
+## Notes
+
+<!-- Additional context or notes -->