@agentic15.com/agentic15-claude-zen 7.0.0 → 8.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "agentic15-claude-zen",
+  "version": "8.0.0",
+  "description": "Claude Code skills plugin for Agentic15 framework - provides native /agentic15:* slash commands",
+  "author": {
+    "name": "Agentic15",
+    "email": "developers@agentic15.com"
+  },
+  "homepage": "https://github.com/agentic15/claude-zen",
+  "repository": "https://github.com/agentic15/claude-zen",
+  "license": "Apache-2.0",
+  "keywords": [
+    "agentic15",
+    "workflow",
+    "task-management",
+    "ai-development",
+    "claude-code",
+    "productivity"
+  ]
+}

package/.claude-plugin/skills/commit.md

@@ -0,0 +1,52 @@
+---
+name: agentic15:commit
+description: Commit completed task and create pull request
+---
+
+# agentic15:commit
+
+Commit your completed task and create a pull request.
+
+## Usage
+
+```
+/agentic15:commit
+```
+
+## What it does
+
+1. Marks the current task as completed in the task tracker
+2. Stages all changes (including updated TASK-TRACKER.json)
+3. Creates a commit with a descriptive message
+4. Pushes the feature branch to remote
+5. Creates a pull request on GitHub/Azure DevOps
+6. Updates the GitHub issue (if one exists)
+7. Shows the PR URL
+
+## Error Handling
+
+- **No active task**: Start a task first with `/agentic15:task-next`
+- **Uncommitted changes on main**: You can't commit directly to main branch
+- **No active plan**: Create a plan first
+- **Task tracker not found**: Lock the plan first
+
+## Commit Message Format
+
+```
+[TASK-XXX] Task Title
+
+- Changes made
+- Features added
+- Issues fixed
+
+🤖 Generated with Claude Code
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+```
+
+## Next Steps
+
+After committing:
+1. Review the PR on GitHub/Azure DevOps
+2. Merge the PR when ready
+3. Run `/agentic15:sync` to sync with main
+4. Start the next task with `/agentic15:task-next`

package/.claude-plugin/skills/plan.md

@@ -0,0 +1,45 @@
+---
+name: agentic15:plan
+description: Create and lock project plans for Agentic15 workflow
+---
+
+# agentic15:plan
+
+Create and lock project plans for the Agentic15 workflow.
+
+## Usage
+
+**Generate a new plan:**
+```
+/agentic15:plan "Build a task management app with React"
+```
+
+**Lock an existing plan:**
+```
+/agentic15:plan
+```
+
+## What it does
+
+### Generate Plan Mode (with requirements)
+1. Creates `.claude/plans/plan-XXX-generated/` directory
+2. Creates `PROJECT-REQUIREMENTS.txt` with your requirements
+3. Sets the `ACTIVE-PLAN` pointer
+4. Prompts you to tell Claude: "Create the project plan"
+
+### Lock Plan Mode (no requirements)
+1. Validates `PROJECT-PLAN.json` exists and is well-formed
+2. Creates `TASK-TRACKER.json` from the plan tasks
+3. Marks the plan as locked
+4. Shows task count and next steps
+
+## Error Handling
+
+- **No requirements provided and no active plan**: You must provide requirements to generate a new plan
+- **Plan already locked**: The current plan is already locked, start working on tasks
+- **PROJECT-PLAN.json not found**: The plan file hasn't been created yet by Claude
+- **Active plan exists**: You can't create a new plan while one is active
+
+## Next Steps
+
+After locking: `/agentic15:task-next` to start the first task

package/.claude-plugin/skills/status.md

@@ -0,0 +1,66 @@
+---
+name: agentic15:status
+description: Show current project and task status
+---
+
+# agentic15:status
+
+Display the current status of your project, plan, and tasks.
+
+## Usage
+
+```
+/agentic15:status
+```
+
+## What it shows
+
+**Plan Information:**
+- Plan ID and name
+- Total number of tasks
+- Completed vs pending tasks
+
+**Current Task (if any):**
+- Task ID and title
+- Current status (in_progress)
+- Changed files in working directory
+
+**Progress Overview:**
+- Completion percentage
+- Tasks remaining
+- Next suggested action
+
+## Example Output
+
+```
+📊 Task Status
+
+   Plan: plan-002-plugin
+   Progress: 5/10 completed (5 pending)
+
+   🔄 Currently working on: TASK-006
+   📌 Implement agentic15:commit skill
+
+   📝 Changed files:
+      - plugin/skills/commit.js
+      - plugin/tests/commit.test.js
+```
+
+## When to Use
+
+Check status anytime during development:
+- Before starting work each day
+- To see which task you're on
+- To check overall progress
+- To see what files you've modified
+
+## Error Handling
+
+- **No active plan**: Create a plan first with `/agentic15:plan`
+- **Task tracker not found**: Lock the plan first
+
+## Next Steps
+
+The status command suggests what to do next:
+- If no task in progress: Start one with `/agentic15:task-next`
+- If task in progress: Continue working or commit when done

package/.claude-plugin/skills/sync.md

@@ -0,0 +1,49 @@
+---
+name: agentic15:sync
+description: Sync with main branch after PR merge
+---
+
+# agentic15:sync
+
+Sync your local repository with the main branch after merging a pull request.
+
+## Usage
+
+```
+/agentic15:sync
+```
+
+## What it does
+
+1. Verifies you're on a feature/plan/admin branch or main
+2. Checks for uncommitted changes (blocks if found)
+3. Verifies the PR has been merged (safety check)
+4. Switches to the main branch
+5. Pulls the latest changes from remote
+6. Deletes the feature/plan/admin branch locally
+7. Shows next steps
+
+## When to Use
+
+Run this command after:
+- Merging a PR on GitHub/Azure DevOps
+- Completing a task
+- Before starting the next task
+
+## Error Handling
+
+- **Uncommitted changes detected**: Commit or stash your changes first
+- **Invalid branch**: This command works on feature/plan/admin branches
+- **PR not merged**: Merge the PR before syncing to prevent data loss
+- **Not a git repository**: Run this in a git repository
+
+## Safety Features
+
+The sync command includes critical safety checks:
+- Blocks if PR is still open (prevents losing work)
+- Blocks if branch has unpushed commits
+- Warns if PR was closed without merging
+
+## Next Steps
+
+After syncing: `/agentic15:task-next` to start the next task

package/.claude-plugin/skills/task-next.md

@@ -0,0 +1,36 @@
+---
+name: agentic15:task-next
+description: Start the next pending task in the active plan
+---
+
+# agentic15:task-next
+
+Automatically start the next pending task in your active plan.
+
+## Usage
+
+```
+/agentic15:task-next
+```
+
+## What it does
+
+1. Finds the next pending task in the task tracker
+2. Switches to main branch and pulls latest changes
+3. Creates a feature branch: `feature/task-XXX`
+4. Marks the task as `in_progress`
+5. Creates a GitHub issue (if auto-create is enabled)
+6. Shows task details and next steps
+
+## Error Handling
+
+- **No active plan**: You must create and lock a plan first
+- **Task tracker not found**: The plan hasn't been locked yet
+- **No pending tasks**: All tasks are completed! 🎉
+- **Task already in progress**: Complete the current task before starting a new one
+
+## Next Steps
+
+After starting: Tell Claude "Write code for this task"
+
+When done: `/agentic15:commit`

package/.claude-plugin/skills/task-start.md

@@ -0,0 +1,44 @@
+---
+name: agentic15:task-start
+description: Start a specific task by ID
+---
+
+# agentic15:task-start
+
+Start a specific task by its ID (e.g., TASK-003) instead of starting the next pending task.
+
+## Usage
+
+```
+/agentic15:task-start TASK-003
+```
+
+## What it does
+
+1. Validates the task ID format (must be TASK-XXX)
+2. Checks that the task exists and is not completed
+3. Switches to main branch and pulls latest changes
+4. Creates a feature branch: `feature/task-XXX`
+5. Marks the task as `in_progress`
+6. Creates a GitHub issue (if auto-create is enabled)
+7. Shows task details and next steps
+
+## Task ID Format
+
+- Must be uppercase: `TASK-` prefix
+- Must have exactly 3 digits: `001`, `002`, etc.
+- Examples: `TASK-001`, `TASK-042`, `TASK-999`
+
+## Error Handling
+
+- **No task ID provided**: You must specify which task to start
+- **Invalid task ID format**: Must match `TASK-XXX` format (uppercase, 3 digits)
+- **Task not found**: The specified task doesn't exist in the tracker
+- **Task already completed**: This task has already been finished
+- **Another task in progress**: Complete the current task first
+
+## Next Steps
+
+After starting: Tell Claude "Write code for this task"
+
+When done: `/agentic15:commit`

package/.claude-plugin/skills/visual-test.md

@@ -0,0 +1,77 @@
+---
+name: agentic15:visual-test
+description: Capture screenshots and console errors for UI debugging
+---
+
+# agentic15:visual-test
+
+Capture screenshots, console errors, and accessibility issues from your web application for AI-assisted debugging.
+
+## Usage
+
+```
+/agentic15:visual-test http://localhost:3000
+```
+
+## What it does
+
+1. Launches Playwright in headless browser mode
+2. Navigates to the specified URL
+3. Captures screenshots (full page + viewport)
+4. Records console errors and warnings
+5. Logs network errors (4xx/5xx responses)
+6. Runs accessibility audit with axe-core
+7. Saves page HTML for debugging
+8. Stores all results in `.claude/visual-test/`
+
+## Prerequisites
+
+Install Playwright first:
+```bash
+npx playwright install chromium
+```
+
+## Generated Files
+
+The command creates these files in `.claude/visual-test/`:
+- `fullpage.png` - Full page screenshot
+- `viewport.png` - Viewport screenshot
+- `console-errors.log` - JavaScript errors (if any)
+- `console-warnings.log` - JavaScript warnings (if any)
+- `network-errors.log` - Failed HTTP requests (if any)
+- `accessibility.log` - A11y violations (if any)
+- `page.html` - Page source for debugging
+
+## Error Handling
+
+- **No URL provided**: You must specify a URL to test
+- **Invalid URL format**: URL must start with `http://` or `https://`
+- **Playwright not installed**: Install with `npx playwright install chromium`
+
+## Example Workflow
+
+1. Start your dev server:
+   ```bash
+   npm run dev
+   ```
+
+2. Run visual test:
+   ```
+   /agentic15:visual-test http://localhost:3000
+   ```
+
+3. Ask Claude to analyze results:
+   > "Analyze the visual test results in .claude/visual-test/"
+
+4. Claude reviews screenshots and logs, suggests fixes
+
+5. Implement fixes and re-test
+
+## Use Cases
+
+- UI regression testing
+- Debugging layout issues
+- Finding console errors
+- Accessibility compliance
+- Network request debugging
+- Cross-page testing

package/CHANGELOG.md

@@ -7,6 +7,130 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Copyright 2024-2026 agentic15.com
 
+## [8.0.0] - 2026-01-05
+
+### 🎉 MAJOR RELEASE - Integrated Claude Code Plugin
+
+**BREAKING CHANGES**: This release integrates the Claude Code plugin directly into the framework package. Users upgrading from v7.x will need to update their configuration.
+
+### Summary
+The Claude Code plugin has been integrated into the main framework package, eliminating the need for a separate `@agentic15.com/claude-code-zen-plugin` package. Users now get both CLI and Claude Code skills in a single installation.
+
+### 💥 Breaking Changes
+
+**Plugin Integration**
+- **Package Consolidation**: Claude Code plugin now included in `@agentic15.com/agentic15-claude-zen`
+- **Settings Update Required**: Users must update `.claude/settings.json` to use `@agentic15.com/agentic15-claude-zen` instead of `@agentic15.com/claude-code-zen-plugin`
+- **Installation Change**: Single package installation instead of two separate packages
+
+**Migration Required**:
+```bash
+# OLD (v7.x)
+npm install -g @agentic15.com/agentic15-claude-zen
+npm install -g @agentic15.com/claude-code-zen-plugin
+
+# NEW (v8.0) - Choose one method:
+npx @agentic15.com/agentic15-claude-zen init  # No install (recommended)
+npm install --save-dev @agentic15.com/agentic15-claude-zen  # Local install
+npm install -g @agentic15.com/agentic15-claude-zen  # Global install
+```
+
+**Settings Update**:
+```json
+// OLD (.claude/settings.json)
+{
+  "plugins": {
+    "@agentic15.com/claude-code-zen-plugin": {
+      "enabled": true
+    }
+  }
+}
+
+// NEW (.claude/settings.json)
+{
+  "plugins": {
+    "@agentic15.com/agentic15-claude-zen": {
+      "enabled": true
+    }
+  }
+}
+```
+
+### ✨ Added
+
+**Integrated Claude Code Plugin**
+- **7 Skills**: `/agentic15:plan`, `/agentic15:task-next`, `/agentic15:task-start`, `/agentic15:commit`, `/agentic15:sync`, `/agentic15:status`, `/agentic15:visual-test`
+- **Plugin Architecture**: `plugin/` directory with skills, utilities, and tests
+- **Marketplace Support**: `.claude-plugin/` configuration for Claude marketplace distribution
+- **Skill Documentation**: Markdown documentation for all 7 skills
+- **Test Suite**: 85 validation-only tests (100% pass rate, no side effects)
+- **Plugin Entry Point**: `plugin/index.js` with skill exports and metadata
+
+**Package Configuration**
+- **claudePlugin Metadata**: Added namespace and skill list to package.json
+- **Test Scripts**: `test:plugin` and `test:all` commands
+- **Keywords**: Added `claude-plugin`, `workflow-automation`, `skills`
+
+**Documentation**
+- **INSTALLATION.md**: Complete installation guide for both NPM and marketplace
+- **PUBLISHING.md**: Publishing instructions for dual distribution
+- **E2E-TESTING-GUIDE.md**: End-to-end testing workflows
+- **INTEGRATION-SUMMARY.md**: Detailed integration documentation
+
+### 🔧 Changed
+
+**Package Structure**
+- **Size**: Increased from ~350KB to 446KB (unpacked) due to plugin integration
+- **Files**: Added `plugin/` and `.claude-plugin/` directories to published package
+- **Total Files**: 80 files (70 framework + 10 plugin)
+
+**Marketplace Configuration**
+- **Source Path**: Updated from `./plugin` to `./Agent`
+- **Package Name**: Unified naming as `agentic15-claude-zen`
+
+### 📦 Package Statistics
+
+**Version**: 8.0.0
+**Size**: 101.4 KB (compressed), 446.1 KB (unpacked)
+**Total Files**: 80
+**Tests**: 85 plugin tests + existing framework tests
+
+### 🎯 Benefits
+
+- **Single Installation**: One package provides both CLI and Claude Code integration
+- **Version Synchronization**: Framework and plugin always in sync
+- **Simpler Maintenance**: Single package.json, version, and publish command
+- **Better UX**: No confusion about which packages to install
+- **Consistent Naming**: Package name matches repository
+
+### 📖 Migration Guide
+
+See `INTEGRATION-SUMMARY.md` for complete migration instructions.
+
+For existing users:
+1. Uninstall old plugin (if installed): `npm uninstall -g @agentic15.com/claude-code-zen-plugin`
+2. Choose installation method:
+   - **npx** (no install): `npx @agentic15.com/agentic15-claude-zen@8.0.0 status`
+   - **Local**: `npm install --save-dev @agentic15.com/agentic15-claude-zen@8.0.0`
+   - **Global**: `npm install -g @agentic15.com/agentic15-claude-zen@8.0.0`
+3. Update `.claude/settings.json` plugin name (if using explicit config)
+4. Verify: `/plugin list` and `/agentic15:status`
+
+---
+
+## [7.0.1] - 2026-01-04
+
+### Fixed
+- **README.md**: Reduced from 806 lines to 340 lines (58% smaller)
+- **Documentation**: Removed embedded platform guides, added links to separate docs
+- **Organization**: GitHub and Azure DevOps setup now link to detailed guides instead of embedding 400+ lines
+
+### Changed
+- **README.md**: Clean, lean structure (9.0kB vs 20.8kB)
+- **Platform Integration**: Quick setup + links instead of full embedded documentation
+
+---
+
 ## [7.0.0] - 2026-01-04
 
 ### 🎉 MAJOR RELEASE - Token-Efficient Architecture & Autonomous UI Verification