agentsys 5.4.0 → 5.5.0

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "agentsys",
-  "description": "15 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, topic research, agent config linting, cross-tool AI consultation, structured AI debate, and workflow pattern learning",
-  "version": "5.4.0",
+  "description": "18 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, git intelligence, perf investigations, topic research, agent config linting, cross-tool AI consultation, structured AI debate, workflow pattern learning, codebase onboarding, and contributor guidance",
+  "version": "5.5.0",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -138,7 +138,7 @@
         "source": "url",
         "url": "https://github.com/agent-sh/agnix.git"
       },
-      "description": "Lint agent configuration files (SKILL.md, CLAUDE.md, hooks, MCP) against 155 rules across 10+ AI tools",
+      "description": "Lint agent configuration files (SKILL.md, CLAUDE.md, hooks, MCP) against 342 rules across 10+ AI tools",
       "version": "1.0.0",
       "category": "development",
       "homepage": "https://github.com/agent-sh/agnix"
@@ -186,6 +186,39 @@
       "version": "1.0.0",
       "category": "productivity",
       "homepage": "https://github.com/agent-sh/skillers"
+    },
+    {
+      "name": "git-map",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/agent-sh/git-map.git"
+      },
+      "description": "Git history analysis: hotspots, coupling, ownership, bus factor, AI commit detection - backed by agent-analyzer Rust binary with lazy download",
+      "version": "1.0.0",
+      "category": "development",
+      "homepage": "https://github.com/agent-sh/git-map"
+    },
+    {
+      "name": "onboard",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/agent-sh/onboard.git"
+      },
+      "description": "Codebase onboarding - automated data collection and interactive project orientation",
+      "version": "0.1.0",
+      "category": "productivity",
+      "homepage": "https://github.com/agent-sh/onboard"
+    },
+    {
+      "name": "can-i-help",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/agent-sh/can-i-help.git"
+      },
+      "description": "Find where to contribute to any project - matches developer skills to test gaps, stale docs, bugspots, and open issues",
+      "version": "0.1.0",
+      "category": "productivity",
+      "homepage": "https://github.com/agent-sh/can-i-help"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "keywords": [
     "workflow",

package/CHANGELOG.md

@@ -7,6 +7,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.4.1] - 2026-03-10
+
+### Added
+
+- **Project base branch** (`--base=BRANCH`) - `/next-task` now supports configuring a project-level base branch for batch workflows. All downstream operations (worktrees, diffs, PRs) use the configured branch instead of main.
+- **Free-text preference caching** - When users select "Other" for any policy decision and type a custom response, it gets cached and offered as an option next time. Auto-removed after 3 skips.
+- **Gate 0 hook** - SubagentStop hook blocks Phase 2 unless policy decisions are persisted to preference cache.
+- **Multi-tool transcript support** - `/skillers compact` now reads from Claude Code, Codex CLI, and OpenCode (was Claude Code only).
+
+### Fixed
+
+- **ship target branch validation** - `/ship` now reads `baseBranch` from flow state and validates non-default targets with user confirmation.
+- **Quality sweep** - Removed 95 lines of prose slop and duplication across ship and skillers.
+- **Pre-push hooks** - Fixed for repos without `npm test` script (falls back to JS syntax check).
+- **Cached source null check** - `getPolicyQuestions` no longer crashes when preference file has freeText but no source.
+
 ## [5.4.0] - 2026-03-10
 
 ### Added

package/README.md

@@ -8,8 +8,6 @@
   <strong>A modular runtime and orchestration system for AI agents.</strong>
 </p>
 
-> **Renamed from `awesome-slash`** — The `awesome-` prefix implies a curated list of links, but this project is a functional software suite and runtime. Please update your installs: `npm install -g agentsys`
-
 <p align="center">
   <a href="https://www.npmjs.com/package/agentsys"><img src="https://img.shields.io/npm/v/agentsys.svg" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/agentsys"><img src="https://img.shields.io/npm/dm/agentsys.svg" alt="npm downloads"></a>
@@ -21,7 +19,7 @@
 </p>
 
 <p align="center">
-  <b>15 plugins · 35 agents · 32 skills (across all repos) · 30k lines of lib code · 3,751 tests · 5 platforms</b><br>
+  <b>18 plugins · 38 agents · 36 skills (across all repos) · 30k lines of lib code · 3,575 tests · 5 platforms</b><br>
   <em>Plugins distributed as standalone repos under <a href="https://github.com/agent-sh">agent-sh</a> org — agentsys is the marketplace &amp; installer</em>
 </p>
 
@@ -43,11 +41,11 @@
 AI models can write code. That's not the hard part anymore. The hard part is everything around it — task selection, branch management, code review, artifact cleanup, CI, PR comments, deployment. **AgentSys is the runtime that orchestrates agents to handle all of it** — structured pipelines, gated phases, specialized agents, and persistent state that survives session boundaries.
 
 ---
-> Building custom skills, agents, hooks, or MCP tools? [agnix](https://github.com/agent-sh/agnix) is the CLI + LSP linter that catches config errors before they fail silently - real-time IDE validation, auto suggestions, auto-fix, and 155 rules for Cursor, Claude Code, Cline, Copilot, Codex, Windsurf, and more.
+> Building custom skills, agents, hooks, or MCP tools? [agnix](https://github.com/agent-sh/agnix) is the CLI + LSP linter that catches config errors before they fail silently - real-time IDE validation, auto suggestions, auto-fix, and 342 rules for Claude Code, Codex, OpenCode, Cursor, Kiro, Copilot, Gemini CLI, Cline, Windsurf, Roo Code, Amp, and more.
 
 ## What This Is
 
-An agent orchestration system — 15 plugins, 35 agents, and 32 skills that compose into structured pipelines for software development. Each plugin lives in its own standalone repo under the [agent-sh](https://github.com/agent-sh) org. agentsys is the marketplace and installer that ties them together.
+An agent orchestration system — 18 plugins, 38 agents, and 36 skills that compose into structured pipelines for software development. Each plugin lives in its own standalone repo under the [agent-sh](https://github.com/agent-sh) org. agentsys is the marketplace and installer that ties them together.
 
 Each agent has a single responsibility, a specific model assignment, and defined inputs/outputs. Pipelines enforce phase gates so agents can't skip steps. State persists across sessions so work survives interruptions.
 
@@ -80,6 +78,25 @@ This came from testing on 1,000+ repositories.
 <!-- GEN:START:readme-commands -->
 | Command | What it does |
 |---------|--------------|
+| [`/next-task`](#next-task) | Task workflow: discovery, implementation, PR, merge |
+| [`/agnix`](#agnix) | Lint agent configurations (342 rules) |
+| [`/ship`](#ship) | PR creation, CI monitoring, merge |
+| [`/deslop`](#deslop) | Clean AI slop patterns |
+| [`/perf`](#perf) | Performance investigation with baselines and profiling |
+| [`/drift-detect`](#drift-detect) | Compare plan vs implementation |
+| [`/audit-project`](#audit-project) | Multi-agent iterative code review |
+| [`/enhance`](#enhance) | Plugin, agent, and prompt analyzers |
+| [`/repo-map`](#repo-map) | AST-based repository map |
+| [`/sync-docs`](#sync-docs) | Sync documentation with code changes |
+| [`/learn`](#learn) | Research topics, create learning guides |
+| [`/consult`](#consult) | Cross-tool AI consultation |
+| [`/debate`](#debate) | Structured debate between AI tools |
+| [`/web-ctl`](#web-ctl) | Browser automation for AI agents |
+| [`/release`](#release) | Versioned release with ecosystem detection |
+| [`/skillers`](#skillers) | Workflow pattern learning and automation |
+| [`/git-map`](#git-map) | Git history analysis: hotspots, coupling, ownership, bus factor |
+| [`/onboard`](#onboard) | Codebase orientation for newcomers |
+| [`/can-i-help`](#can-i-help) | Match contributor skills to project needs |
 <!-- GEN:END:readme-commands -->
 
 Each command works standalone. Together, they compose into end-to-end pipelines.
@@ -89,10 +106,20 @@ Each command works standalone. Together, they compose into end-to-end pipelines.
 ## Skills
 
 <!-- GEN:START:readme-skills -->
-0 skills included across the plugins:
+36 skills included across the plugins:
 
 | Category | Skills |
 |----------|--------|
+| **Workflow** | `discover-tasks`, `orchestrate-review`, `validate-delivery` |
+| **Enhancement** | `enhance-agent-prompts`, `enhance-claude-memory`, `enhance-cross-file`, `enhance-docs`, `enhance-hooks`, `enhance-orchestrator`, `enhance-plugins`, `enhance-prompts`, `enhance-skills` |
+| **Performance** | `baseline`, `benchmark`, `code-paths`, `investigation-logger`, `perf-analyzer`, `profile`, `theory-gatherer`, `theory-tester` |
+| **Cleanup** | `deslop`, `sync-docs` |
+| **Code Review** | `audit-project` |
+| **AI Collaboration** | `consult`, `debate`, `learn`, `recommend`, `skillers-compact` |
+| **Onboarding** | `can-i-help`, `onboard` |
+| **Web** | `web-auth`, `web-browse` |
+| **Release** | `release` |
+| **Analysis** | `drift-analysis`, `git-mapping`, `repo-mapping` |
 <!-- GEN:END:readme-skills -->
 
 Skills are the reusable implementation units. Agents invoke skills; commands orchestrate agents. When you install a plugin, its skills become available to all agents in that session.
@@ -104,8 +131,8 @@ Skills are the reusable implementation units. Agents invoke skills; commands orc
 | Section | What's there |
 |---------|--------------|
 | [The Approach](#the-approach) | Why it's built this way |
-| [Commands](#commands) | All 14 commands overview |
-| [Skills](#skills) | 32 skills across plugins |
+| [Commands](#commands) | All 19 commands overview |
+| [Skills](#skills) | 36 skills across plugins |
 | [Command Details](#command-details) | Deep dive into each command |
 | [How Commands Work Together](#how-commands-work-together) | Standalone vs integrated |
 | [Design Philosophy](#design-philosophy) | The thinking behind the architecture |
@@ -144,7 +171,7 @@ Phase 9 uses the `orchestrate-review` skill to spawn parallel reviewers (code qu
 |-------|-------|------|
 | task-discoverer | sonnet | Finds and ranks tasks from your source |
 | worktree-manager | haiku | Creates git worktrees and branches |
-| exploration-agent | opus | Deep codebase analysis before planning |
+| exploration-agent | sonnet | Deep codebase analysis before planning |
 | planning-agent | opus | Designs step-by-step implementation plan |
 | implementation-agent | opus | Writes the actual code |
 | test-coverage-checker | sonnet | Validates tests exist and are meaningful |
@@ -192,10 +219,10 @@ agnix catches these issues before they cause problems.
 | **Security** | Prompt injection vectors, overpermissive tools, exposed secrets |
 | **Consistency** | Conflicting rules, duplicate definitions, broken references |
 | **Best Practices** | Tool restrictions, model selection, trigger phrase quality |
-| **Cross-Platform** | Compatibility across Claude Code, Cursor, Copilot, Codex, OpenCode, Gemini CLI, Cline, and more |
+| **Cross-Platform** | Compatibility across Claude Code, Codex, OpenCode, Cursor, Kiro, Copilot, Gemini CLI, Cline, Windsurf, Roo Code, Amp, and more |
 
-**155 validation rules** (57 auto-fixable) derived from:
-- Official tool specifications (Claude Code, Cursor, GitHub Copilot, Codex CLI, OpenCode, Gemini CLI, and more)
+**342 validation rules** (102 auto-fixable) derived from:
+- Official tool specifications (Claude Code, Codex CLI, OpenCode, Cursor, Kiro, GitHub Copilot, Gemini CLI, Cline, Windsurf, Roo Code, Amp, and more)
 - Research papers on agent reliability and prompt injection
 - Real-world testing across 500+ repositories
 - Community-reported issues and edge cases
@@ -210,6 +237,12 @@ agnix catches these issues before they cause problems.
 | MCP | `*.mcp.json`, MCP server configs |
 | Cursor | `.cursor/rules/*.mdc`, `.cursorrules` |
 | Copilot | `.github/copilot-instructions.md` |
+| Kiro | `.kiro/steering/**/*.md`, `.kiro/agents/*.json`, `.kiro/hooks/*.kiro.hook`, `POWER.md` |
+| Windsurf | `.windsurf/rules/**/*.md`, `.windsurf/workflows/**/*.md`, `.windsurfrules` |
+| Roo Code | `.roo/rules/*.md`, `.roo/rules-{mode}/*.md`, `.roomodes`, `.rooignore`, `.roorules` |
+| Gemini CLI | `GEMINI.md`, `.gemini/settings.json`, `gemini-extension.json` |
+| OpenCode | `opencode.json` |
+| Amp | `.agents/checks/**/*.md`, `.amp/settings.json` |
 
 **CI/CD Integration:**
 
@@ -610,7 +643,7 @@ agent-knowledge/
 /learn python async --no-enhance    # Skip enhancement pass
 ```
 
-**Agent:** learn-agent (opus model for research quality)
+**Agent:** learn-agent (sonnet model)
 
 ---
 
@@ -804,7 +837,115 @@ No per-turn overhead - it reads transcripts that Claude Code already saves.
 
 **Agents:** skillers-compactor (sonnet), skillers-recommender (opus)
 
-**Skills:** compact, recommend
+**Skills:** skillers-compact, recommend
+
+---
+
+### /git-map
+
+**Purpose:** Analyze git history to surface hotspots, coupling, ownership, bus factor, bugspots, area health, and AI attribution.
+
+**How it works:**
+
+The plugin wraps the [agent-analyzer](https://github.com/agent-sh/agent-analyzer) Rust binary. Run `init` once to scan git history and cache the result as `repo-intel.json`. Then run queries instantly.
+
+**21 query types:**
+
+| Category | Queries |
+|----------|---------|
+| Activity | `hotspots`, `coldspots`, `file-history` |
+| Quality | `bugspots`, `test-gaps`, `diff-risk` |
+| People | `ownership`, `contributors`, `bus-factor` |
+| Coupling | `coupling` |
+| Standards | `norms`, `conventions` |
+| Health | `areas`, `health`, `release-info` |
+| AI | `ai-ratio`, `recent-ai` |
+| Guidance | `onboard`, `can-i-help` |
+| Docs | `doc-drift` |
+
+**9 plugins consume git-map data automatically** - deslop, sync-docs, drift-detect, audit-project, next-task, enhance, ship, onboard, can-i-help.
+
+**Usage:**
+
+```bash
+/git-map init                      # First-time scan
+/git-map update                    # Add new commits
+/git-map query hotspots            # Most active files
+/git-map query ownership src/      # Who owns a path
+/git-map query bus-factor          # Knowledge risk
+```
+
+[Full query reference ->](https://github.com/agent-sh/git-map)
+
+---
+
+### /onboard
+
+**Purpose:** Get oriented in any codebase in under 3 minutes.
+
+**What happens when you run it:**
+
+1. **Collect** (68ms median) - Pure JavaScript scans manifest, structure, README, CLAUDE.md/AGENTS.md, CI, git, repo-intel (no LLM tokens)
+2. **Synthesize** - Opus agent produces a structured overview: tech stack, key files, active areas, conventions
+3. **Guide** - Interactive Q&A: ask about specific files, areas, or patterns
+
+**74% fewer tokens** than manual onboarding. Validated on 100 repos across JS/TS, Rust, Go, Python, C/C++, Java, and Deno.
+
+**Depth levels:**
+
+| Level | Time | Data |
+|-------|------|------|
+| quick | ~2s | Manifest + README + structure |
+| normal | ~5s | + CLAUDE.md/AGENTS.md + CI + repo-intel |
+| deep | ~15s | + repo-map AST symbols |
+
+**Supported manifests:** package.json, Cargo.toml, go.mod, pyproject.toml, deno.json, CMakeLists.txt, meson.build, setup.py, pom.xml, build.gradle. Detects monorepos (npm/pnpm/lerna/Cargo workspaces, Python libs/, Deno workspaces).
+
+**Usage:**
+
+```bash
+/onboard                    # Current repo
+/onboard /path/to/repo      # Specific repo
+/onboard --depth=deep       # Include AST data
+```
+
+**Agent:** onboard-agent (opus model)
+
+[Full documentation ->](https://github.com/agent-sh/onboard)
+
+---
+
+### /can-i-help
+
+**Purpose:** Match a contributor's skills to specific areas where they can help.
+
+**What happens when you run it:**
+
+1. **Collect** - Gathers project data + contributor signals (test gaps, doc drift, bugspots, good-first areas, open issues). Validated on 100 repos.
+2. **Match** - Opus agent asks about developer background and matches skills to project needs
+3. **Guide** - For each recommendation: reads code, explains what needs doing, gives a concrete first step
+
+**Matching:**
+
+| Developer profile | Gets recommended |
+|-------------------|------------------|
+| New to stack | Good-first areas with clear patterns |
+| Experienced | Hard problems in pain-point areas |
+| Test-focused | Test gaps in frequently-changed files |
+| Bug-focused | Bugspot files + relevant open issues |
+| Docs-focused | Stale documentation with code examples |
+
+**Usage:**
+
+```bash
+/can-i-help                       # Current repo
+/can-i-help /path/to/repo         # Specific repo
+/can-i-help --depth=deep          # Include AST data
+```
+
+**Agent:** can-i-help-agent (opus model)
+
+[Full documentation ->](https://github.com/agent-sh/can-i-help)
 
 ---
 
@@ -898,7 +1039,7 @@ Approve the plan. See the results. The middle is automated. One plan approval un
 **8. Right model for the task**
 
 Match model capability to task complexity:
-- **opus** - Exploration, planning, implementation, review orchestration
+- **opus** - Planning, implementation, review orchestration
 - **sonnet** - Pattern matching, validation, discovery
 - **haiku** - Git operations, file moves, CI polling
 
@@ -988,7 +1129,7 @@ agentsys --development              # Dev mode (bypasses marketplace)
 - ast-grep (`sg`) installed
 
 **For /agnix:**
-- [agnix CLI](https://github.com/agent-sh/agnix) installed (`cargo install agnix-cli` or `brew install agnix`)
+- [agnix CLI](https://github.com/agent-sh/agnix) installed (`npm install -g agnix`, `cargo install agnix-cli`, or `brew install agnix`)
 
 **Local diagnostics (optional):**
 ```bash
@@ -1011,7 +1152,7 @@ The system is built on research, not guesswork.
 - Instruction following reliability
 
 **Testing:**
-- 3,751 tests passing
+- 3,575 tests passing
 - Drift-detect validated on 1,000+ repositories
 - E2E workflow testing across all commands
 - Cross-platform validation (Claude Code, OpenCode, Codex CLI, Cursor, Kiro)