@agentic15.com/agentic15-claude-zen 3.3.0 → 4.0.2

package/README.md

@@ -23,42 +23,109 @@ npx "@agentic15.com/agentic15-claude-zen" my-project
 cd my-project
 ```
 
-**Step 3: Launch Claude Code from Inside Project Directory**
+**Step 3: Initialize Git and Link to GitHub**
 
-Start Claude Code CLI from inside the `my-project` directory. Claude Code MUST be running from inside your project directory to access the framework files.
+```bash
+# Initialize git (if not already done)
+git init
+git branch -M main  # Rename master to main
+git add .
+git commit -m "Initial commit"
+
+# Create GitHub repository and link it
+gh repo create OWNER/REPO --public  # or --private
+git remote add origin https://github.com/OWNER/REPO.git
+git push -u origin main
+```
+
+Replace `OWNER/REPO` with your GitHub username and repository name (e.g., `myusername/my-project`).
+
+> **REQUIRED**: This step is mandatory. The framework needs a GitHub remote to create issues and pull requests.
 
 **Step 4: Configure Repository Settings (Recommended)**
+
+**For Bash/Mac/Linux:**
 ```bash
 # Prevent direct pushes to main - require PRs for all changes
+cat > /tmp/protection.json << 'EOF'
+{
+  "required_pull_request_reviews": {
+    "required_approving_review_count": 0
+  },
+  "enforce_admins": false,
+  "allow_force_pushes": false,
+  "allow_deletions": false,
+  "required_status_checks": null,
+  "restrictions": null
+}
+EOF
+
 gh api repos/OWNER/REPO/branches/main/protection -X PUT \
   -H "Accept: application/vnd.github+json" \
-  -f required_pull_request_reviews[required_approving_review_count]=0 \
-  -f enforce_admins=false \
-  -f allow_force_pushes=false \
-  -f allow_deletions=false
+  --input /tmp/protection.json
 
 # Auto-delete branches after PR merge
 gh api repos/OWNER/REPO -X PATCH \
   -H "Accept: application/vnd.github+json" \
   -f delete_branch_on_merge=true
 ```
+
+**For PowerShell (Windows):**
+```powershell
+# Prevent direct pushes to main - require PRs for all changes
+$body = @"
+{
+  "required_pull_request_reviews": {
+    "required_approving_review_count": 0
+  },
+  "enforce_admins": false,
+  "allow_force_pushes": false,
+  "allow_deletions": false,
+  "required_status_checks": null,
+  "restrictions": null
+}
+"@
+
+echo $body | gh api repos/OWNER/REPO/branches/main/protection -X PUT -H "Accept: application/vnd.github+json" --input -
+
+# Auto-delete branches after PR merge
+gh api repos/OWNER/REPO -X PATCH -H "Accept: application/vnd.github+json" -f delete_branch_on_merge=true
+```
+
 Replace `OWNER/REPO` with your GitHub username and repository name.
 
+
 **Step 5: Use Framework Commands**
 ```bash
 npx agentic15 auth                         # One-time GitHub setup
 npx agentic15 plan                         # Enter interactive mode
 # Type/paste your requirements, press Ctrl+D when done
+```
+
+
+**Step 6: Launch Claude Code in Another Terminal**
+
 # Open another terminal. Make sure that you in your project directory. Launch Claude
+Start Claude Code CLI from inside the `my-project` directory. Claude Code MUST be running from inside your project directory to access the framework files.
 # Ask Claude: "Read the requirements file and generate a task breakdown plan"
+
+
+**Step 7: User Termianl and Not Claude Terminal**
+```
+npx agentic15 plan                         # Generate Task Files and Lock Plan
 npx agentic15 task next                    # Start first task
-# Ask Claude: "Implement this task"
+```
+
+**Step 8: Claude Terminal**
+# Ask Claude: "Implement this Active task"
+
+**Step 9: User Termianl Not Claude Terminal**
+```
 npx agentic15 commit                       # Test, commit, push, PR
 ```
 
-> **IMPORTANT**: Always launch Claude Code from inside your project directory, not from the parent directory. The framework relies on `.claude/` configuration files that must be accessible from the working directory.
 
-**Step 6: Clean Up Local Branches**
+**Step 10: Clean Up Local Branches**
 ```bash
 # If auto-delete is enabled, only clean up local branches
 git branch -d feature/task-001

package/bin/agentic15.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { Command } from 'commander';
 import { AuthCommand } from '../src/cli/AuthCommand.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic15.com/agentic15-claude-zen",
-  "version": "3.3.0",
+  "version": "4.0.2",
   "description": "Structured AI-assisted development framework for Claude Code with enforced quality standards",
   "main": "src/index.js",
   "bin": {

package/src/cli/CommitCommand.js

@@ -45,7 +45,10 @@ export class CommitCommand {
     // Step 8: Update GitHub issue status
     await this.updateGitHubIssue(task, prUrl);
 
-    // Step 9: Display summary
+    // Step 9: Mark task as completed
+    this.markTaskCompleted(task);
+
+    // Step 10: Display summary
     this.displaySummary(task, prUrl, tracker);
   }
 
@@ -266,6 +269,28 @@ export class CommitCommand {
     }
   }
 
+  static markTaskCompleted(task) {
+    try {
+      const activePlanPath = join(process.cwd(), '.claude', 'ACTIVE-PLAN');
+      const planId = readFileSync(activePlanPath, 'utf-8').trim();
+      const trackerPath = join(process.cwd(), '.claude', 'plans', planId, 'TASK-TRACKER.json');
+
+      // Update tracker
+      const tracker = JSON.parse(readFileSync(trackerPath, 'utf-8'));
+      const taskInTracker = tracker.taskFiles.find(t => t.id === task.id);
+
+      if (taskInTracker) {
+        taskInTracker.status = 'completed';
+        taskInTracker.completedAt = new Date().toISOString();
+        writeFileSync(trackerPath, JSON.stringify(tracker, null, 2));
+        console.log(`\n✅ Marked ${task.id} as completed`);
+      }
+    } catch (error) {
+      console.log(`\n⚠️  Failed to mark task as completed: ${error.message}`);
+      console.log('   You may need to manually update TASK-TRACKER.json\n');
+    }
+  }
+
   static displaySummary(task, prUrl, tracker) {
     console.log('\n┌─────────────────────────────────────────┐');
     console.log('│  ✅ Commit Workflow Complete           │');

package/src/cli/TaskCommand.js

@@ -28,6 +28,9 @@ export class TaskCommand {
       process.exit(1);
     }
 
+    // Verify git remote is configured
+    this.validateGitRemote();
+
     // Load task tracker
     const tracker = this.loadTracker();
     const task = tracker.taskFiles.find(t => t.id === taskId);
@@ -248,4 +251,37 @@ export class TaskCommand {
     const planId = readFileSync(activePlanPath, 'utf-8').trim();
     return join(process.cwd(), '.claude', 'plans', planId, 'tasks', `${taskId}.json`);
   }
+
+  static validateGitRemote() {
+    try {
+      // Check if git remote origin exists
+      const remote = execSync('git remote get-url origin', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+
+      if (!remote || remote.length === 0) {
+        throw new Error('No remote URL');
+      }
+
+      // Validate it's a GitHub URL
+      if (!remote.includes('github.com')) {
+        console.log('\n⚠️  Warning: Remote is not a GitHub repository');
+        console.log(`   Remote URL: ${remote}`);
+        console.log('   GitHub integration features may not work.\n');
+      }
+    } catch (error) {
+      console.log('\n❌ Git remote "origin" is not configured');
+      console.log('\n   Before starting tasks, you must link your project to a GitHub repository:');
+      console.log('\n   1. Create a GitHub repository:');
+      console.log('      gh repo create OWNER/REPO --public (or --private)');
+      console.log('\n   2. Link it to your local project:');
+      console.log('      git remote add origin https://github.com/OWNER/REPO.git');
+      console.log('\n   3. Push your initial code:');
+      console.log('      git branch -M main');
+      console.log('      git add .');
+      console.log('      git commit -m "Initial commit"');
+      console.log('      git push -u origin main');
+      console.log('\n   4. Then start your task:');
+      console.log('      npx agentic15 task next\n');
+      process.exit(1);
+    }
+  }
 }

package/templates/.claude/hooks/complete-task.js

@@ -46,7 +46,7 @@ async function main() {
 
   if (!taskId) {
     console.error('\n❌ ERROR: Task ID required');
-    console.error('Usage: npm run task:done TASK-001\n');
+    console.error('Usage: Internal - called by npx agentic15 commit\n');
     process.exit(1);
   }
 
@@ -54,7 +54,7 @@ async function main() {
   const activePlanFile = '.claude/ACTIVE-PLAN';
   if (!fs.existsSync(activePlanFile)) {
     console.error('\n❌ ERROR: No active plan found');
-    console.error('Set active plan first: npm run plan:manager\n');
+    console.error('Set active plan first: npx agentic15 plan\n');
     process.exit(1);
   }
 
@@ -67,7 +67,7 @@ async function main() {
   if (!fs.existsSync(trackerFile)) {
     console.error('\n❌ ERROR: Task tracker not found');
     console.error(`Plan: ${activePlan}`);
-    console.error('Initialize first: npm run plan:init\n');
+    console.error('Initialize first: npx agentic15 plan\n');
     process.exit(1);
   }
 
@@ -208,7 +208,7 @@ async function main() {
     console.log('');
     console.log('📝 Next task:');
     console.log(`   ${nextPendingTask.id}: ${nextPendingTask.title}`);
-    console.log(`   Run: npm run task:start ${nextPendingTask.id}`);
+    console.log(`   Run: npx agentic15 task next`);
   } else {
     console.log('');
     console.log('🎉 All tasks completed!');

package/templates/.claude/hooks/session-start-context.js

@@ -67,7 +67,7 @@ if (activePlan && tracker) {
     }
   } else {
     log('\n   ⚠️  No active task - start one:', 'yellow');
-    log('   npm run task:next', 'yellow');
+    log('   npx agentic15 task next', 'yellow');
   }
 
   // Show progress
@@ -79,11 +79,9 @@ if (activePlan && tracker) {
 } else {
   log('❌ NO ACTIVE PROJECT PLAN', 'red');
   log('\n   You MUST work within the agentic15-claude-zen framework.', 'yellow');
-  log('   Create a plan first:', 'yellow');
-  log('   1. npm run plan:generate "Your requirements"', 'yellow');
-  log('   2. Create PROJECT-PLAN.json from requirements', 'yellow');
-  log('   3. npm run plan:init', 'yellow');
-  log('   4. npm run task:next\n', 'yellow');
+  log('   Initialize the plan and start execution:', 'yellow');
+  log('   npx agentic15 plan', 'yellow');
+  log('   npx agentic15 task next\n', 'yellow');
 }
 
 console.log('─'.repeat(70));
@@ -108,11 +106,11 @@ log('   ./node_modules/.agentic15-claude-zen/  # Bundled scripts & hooks', 'yell
 console.log('\n' + '─'.repeat(70));
 log('📋 AVAILABLE COMMANDS:', 'bold');
 console.log('─'.repeat(70));
-log('   npm run plan:generate <desc>   # Generate plan (non-interactive)', 'cyan');
-log('   npm run plan:init               # Lock plan', 'cyan');
-log('   npm run task:next               # Start next task', 'cyan');
-log('   npm run task:status             # View progress', 'cyan');
-log('   npm run task:done TASK-XXX      # Complete task', 'cyan');
+log('   npx agentic15 plan              # Generate and lock plan', 'cyan');
+log('   npx agentic15 task next         # Start next task', 'cyan');
+log('   npx agentic15 status            # View progress', 'cyan');
+log('   npx agentic15 commit            # Test, commit, push, PR', 'cyan');
+log('   npx agentic15 visual-test <url> # Capture UI screenshots', 'cyan');
 
 console.log('\n' + '─'.repeat(70));
 log('⚠️  ENFORCEMENT ACTIVE:', 'bold');

package/templates/.claude/hooks/start-task.js

@@ -53,7 +53,7 @@ async function main() {
 
   if (!taskId) {
     console.error('\n❌ ERROR: Task ID required');
-    console.error('Usage: npm run task:start TASK-001\n');
+    console.error('Usage: npx agentic15 task start TASK-001\n');
     process.exit(1);
   }
 
@@ -61,7 +61,7 @@ async function main() {
   const activePlanFile = '.claude/ACTIVE-PLAN';
   if (!fs.existsSync(activePlanFile)) {
     console.error('\n❌ ERROR: No active plan found');
-    console.error('Set active plan first: npm run plan:manager\n');
+    console.error('Set active plan first: npx agentic15 plan\n');
     process.exit(1);
   }
 
@@ -74,7 +74,7 @@ async function main() {
   if (!fs.existsSync(trackerFile)) {
     console.error('\n❌ ERROR: Task tracker not found');
     console.error(`Plan: ${activePlan}`);
-    console.error('Initialize first: npm run plan:init\n');
+    console.error('Initialize first: npx agentic15 plan\n');
     process.exit(1);
   }
 
@@ -218,11 +218,9 @@ async function main() {
 
   console.log(`\n📂 Task file: ${taskFile}`);
   console.log('\n📝 WORKFLOW:');
-  console.log(' 1. Make your changes on main branch');
-  console.log(' 2. Commit frequently with task reference:');
-  console.log(`     git commit -m "[${taskId}] Description of changes"`);
-  console.log(' 3. When finished:');
-  console.log(`     npm run task:done ${taskId}`);
+  console.log(' 1. Implement the task requirements');
+  console.log(' 2. When finished, commit and create PR:');
+  console.log(`     npx agentic15 commit`);
 
   process.exit(0);
 }