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

package/README.md

@@ -23,28 +23,83 @@ 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 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": true,
+  "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": true,
+  "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**
+**Step 5: Launch Claude Code**
+
+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.
+
+> **IMPORTANT**: Always launch Claude Code from inside your project directory, not from the parent directory.
+
+**Step 6: Use Framework Commands**
 ```bash
 npx agentic15 auth                         # One-time GitHub setup
 npx agentic15 plan                         # Enter interactive mode
@@ -56,9 +111,7 @@ npx agentic15 task next                    # Start first task
 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 7: 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.0",
   "description": "Structured AI-assisted development framework for Claude Code with enforced quality standards",
   "main": "src/index.js",
   "bin": {

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,36 @@ 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 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);
 }