Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.base.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"plugins": [],
"metadata": {
"description": "Agent collaboration plugin marketplace",
"version": "4.8.0",
"version": "4.9.0",
"repository": "https://github.com/sumitake/agent-collab"
}
}
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
{
"name": "agent-collab",
"description": "Unified dynamic-host collaboration package. Centralized skills and async coordination work without legacy packages; every model-execution route requires the verified signed plugin artifact.",
"version": "4.8.0",
"version": "4.9.0",
"author": {
"name": "John Osumi"
},
Expand All @@ -32,7 +32,7 @@
],
"metadata": {
"description": "Agent collaboration plugin marketplace",
"version": "4.8.0",
"version": "4.9.0",
"repository": "https://github.com/sumitake/agent-collab"
}
}
20 changes: 18 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ trust:
primary's identity, model, and session dynamically — no per-host forks to
drift out of sync.

This public repository distributes that one package, **agent-collab** (v4.8.0), and is
This public repository distributes that one package, **agent-collab** (v4.9.0), and is
the source of truth for the coordinator policy, skills, migration tooling, the
fail-closed runtime client, contribution governance, and release-safety checks.
The signed and notarized darwin-arm64 native runtime is committed in this
Expand Down Expand Up @@ -129,7 +129,23 @@ Contributors need no access to the private build/sign system. See

| Package | Version | Role |
|---|---:|---|
| `agent-collab` | 4.8.0 | Unified skills, dynamic host policy, migration preflight, and verified native-runtime client |
| `agent-collab` | 4.9.0 | Unified skills, dynamic host policy, migration preflight, and verified native-runtime client |

## What's new - v4.9.0

- **Conditional decomposition guidance for `orchestrate` and `teamwork`.**
When a graph or milestone plan decomposes product-feature implementation,
both skills now prefer tracer-bullet vertical slices (complete narrow path
through every layer, demoable or independently verifiable, sized to one
bounded worker invocation with explicit acceptance criteria) and treat wide
refactors as the exception: atomically codemoddable changes run as
checkpointed, fully verified batches, and expand–contract sequencing is
reserved for migrations where old and new forms must genuinely coexist.
The guidance names its own inapplicability (research, operations,
configuration, decision-only work). Adapted portions from the MIT-licensed
mattpocock/skills `to-tickets` skill (pinned `2ab95809`); both specs carry
the full MIT notice and both members' SPDX expression is
`LicenseRef-PolyForm-Strict-1.0.0 AND MIT`.

## What's new - v4.8.0

Expand Down
14 changes: 14 additions & 0 deletions changelog.d/2026-08-03-decomposition-guidance-4.9.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
### Changed

- Stamp agent-collab 4.9.0: **conditional decomposition guidance in
`orchestrate` and `teamwork`** (second deferred follow-up from the 4.7.0
pack). Product-feature implementation graphs/milestones prefer
tracer-bullet vertical slices sized to one bounded worker invocation with
explicit acceptance criteria; wide refactors are the exception —
checkpointed fully-verified batches for atomically codemoddable changes,
expand–contract only where old and new forms must genuinely coexist during
a staged migration. Explicitly inapplicable to research, operations,
configuration, and decision-only work. Adapted portions attributed to
mattpocock/skills `to-tickets` @`2ab95809` (blob `96deac51`); both specs
carry the full MIT notice and both SPDX members read
`LicenseRef-PolyForm-Strict-1.0.0 AND MIT`.
8 changes: 8 additions & 0 deletions docs/third-party-skill-provenance.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ Upstream license file: `LICENSE` (blob `f1dd2c09108dde1a5f56097cee8461b3ea834499
| `skill-specs/architecture-review.md` → `plugins/agent-collab/skills/architecture-review/SKILL.md` | `skills/engineering/improve-codebase-architecture/SKILL.md` | `b56969e92f0705d70700f908b8ec929a1edfa782` |
| (same, inlined vocabulary) | `skills/engineering/codebase-design/SKILL.md` | `16620c24528b737408e78d95dd6a0e01a98d3d63` |
| `skill-specs/code-review.md` → `plugins/agent-collab/skills/code-review/SKILL.md` (adapted portions only; mixed `PolyForm AND MIT` member) | `skills/engineering/code-review/SKILL.md` | `2a0b5240731b927caa9ac0bf43c3e2af9dc3f0a7` |
| `skill-specs/orchestrate.md` → `plugins/agent-collab/skills/orchestrate/SKILL.md` (adapted portions only; mixed member) | `skills/engineering/to-tickets/SKILL.md` | `96deac51d4391a3f691478d48f85f43261516c08` |
| `skill-specs/teamwork.md` → `plugins/agent-collab/skills/teamwork/SKILL.md` (adapted portions only; mixed member) | `skills/engineering/to-tickets/SKILL.md` | `96deac51d4391a3f691478d48f85f43261516c08` |

## Adaptations applied (this package is not a verbatim mirror)

Expand Down Expand Up @@ -52,3 +54,9 @@ every blob SHA above in the same change, and re-verify the adaptations list.
(`Spec`/`Smell` severities, `spec_ref`), and everything else in that skill
are package-original. Per-file SPDX for this member is
`LicenseRef-PolyForm-Strict-1.0.0 AND MIT`.
- `orchestrate` + `teamwork` (adapted portions, v4.9.0): the conditional
tracer-bullet slice rules and expand–contract sequencing are adapted from
upstream `to-tickets`; the conditionality boundaries (feature-work-only,
codemoddable-batch alternative, coexistence-required trigger) and the rest
of both skills are package-original. Per-file SPDX for both members is
`LicenseRef-PolyForm-Strict-1.0.0 AND MIT`.
2 changes: 1 addition & 1 deletion plugins/agent-collab/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "agent-collab",
"version": "4.8.0",
"version": "4.9.0",
"description": "Unified dynamic-host collaboration package with centralized skills, migration preflight, and a verified plugin-relative native runtime boundary. The signed runtime artifact is intentionally absent until the private build/sign integration completes.",
"author": {
"name": "John Osumi"
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "agent-collab",
"version": "4.8.0",
"version": "4.9.0",
"description": "Unified dynamic-host collaboration package with centralized skills, migration preflight, and a verified plugin-relative native runtime boundary. The signed runtime artifact is intentionally absent until the private build/sign integration completes.",
"author": {
"name": "John Osumi"
Expand Down
4 changes: 2 additions & 2 deletions plugins/agent-collab/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ verifiable compliance evidence, and operator final-say, delivered as one
package for every supported host. This document is the package's technical
reference; the repository README carries the purpose and governance narrative.

Current: **4.8.0**
Current: **4.9.0**

It resolves `primary_id`, `primary_family`, `active_model`, `host_runtime`, and
`session_identifier` from the current host or explicit configuration. On a
Expand Down Expand Up @@ -78,7 +78,7 @@ one macOS `LC_BUILD_VERSION` with minimum macOS 14.0 instead of trusting those
manifest labels. The broker transport and provider protocol are both version 2.
The package
carries both `.claude-plugin/plugin.json` and `.codex-plugin/plugin.json`; both
identify this same 4.8.0 package.
identify this same 4.9.0 package.

Codex, Gemini, OpenCode, Grok, and Composer are broker-only contracts. Their sealed requests cross a
mode-`0600`, digest-bound per-user launchd Unix socket; launchd starts the exact
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/agent-readiness/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: agent-readiness
version: 4.8.0
version: 4.9.0
description: Evaluate whether an agent, model, CLI, plugin, or role is ready for a proposed responsibility. Use when the user says "agent readiness," "is this agent ready," "can Codex be primary," "can Grok handle this role," "promote this agent," "evaluate this worker," "review model readiness," or "/agent-collab:agent-readiness." Also offer this proactively before assigning a new primary, reviewer, worker, delegate, headless, release, or merge-related role to Claude, Codex, Antigravity/Gemini, Grok, or a future agent.
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: agent-runtime-status
version: 4.8.0
version: 4.9.0
defaults:
tier: Fast
effort: low
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/ai-writing-auditor/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: ai-writing-auditor
version: 4.8.0
version: 4.9.0
description: Audits prose for the tells of machine-generated writing and rewrites it to read as if a careful human wrote it, without softening the actual content. Use when the user says "de-AI this text", "audit this writing for AI patterns", "make this read human", or "/agent-collab:ai-writing-auditor." Also offer this proactively when a piece of customer-facing or published prose is dense with the stock phrasing and mechanical structure typical of unedited model output.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/architect/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: architect
version: 4.8.0
version: 4.9.0
description: Request read-only architecture consultation for codebase analysis, system design, implementation planning, decomposition, or long-horizon coding strategy. Use when the user says "ask the architect," "have Grok design this," "architecture consultation," "plan this implementation," "decompose this build," "analyze the system design," or "/agent-collab:architect." Also offer this proactively before a substantial multi-system or long-horizon implementation where an independent architecture pass can reduce rework. This role never edits files, runs shell commands or tests, mutates a worktree, opens PRs, merges, or deploys.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/architecture-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: architecture-review
version: 4.8.0
version: 4.9.0
description: Self-executed sweep of a codebase for module-deepening opportunities — shallow interfaces, scattered locality, untestable seams — presented as a visual report the user picks a candidate from, then explored interactively. Unlike `architect` (routed consultation) and `code-review` (diff review), this skill is run by the active primary on the whole codebase. Use when the user says "architecture review," "find deepening opportunities," "where is this codebase getting muddy," "improve the architecture," or "/agent-collab:architecture-review." Also offer this proactively when repeated friction in a working session traces to shallow modules — bouncing between many files to follow one concept, or tests that cannot reach behavior through the current interfaces.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/autonomy-readiness/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: autonomy-readiness
version: 4.8.0
version: 4.9.0
description: Evaluate whether an autonomous, always-on, scheduled, headless, or self-evolving workflow is ready to run safely. Use when the user says "autonomy readiness," "activation gate review," "is this workflow ready to run autonomously," "go/no-go autonomy," "always-on readiness," "headless operation review," or "/agent-collab:autonomy-readiness." Also offer this proactively before enabling background agents, recurring automations, auto-merge/self-evolution, external actions, unattended host runs, or any workflow that can continue without a human watching.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/brainstorm/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: brainstorm
version: 4.8.0
version: 4.9.0
defaults:
tier: Fast
effort: low
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/chain-configurator/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: chain-configurator
version: 4.8.0
version: 4.9.0
defaults:
tier: Standard
effort: medium
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/chain/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: chain
version: 4.8.0
version: 4.9.0
defaults:
tier: Standard
effort: medium
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/code-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: code-review
version: 4.8.0
version: 4.9.0
defaults:
tier: Advanced
effort: high
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/compose-skills/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: compose-skills
version: 4.8.0
version: 4.9.0
description: Select a bounded, token-aware combination of collaboration skills or task lenses before execution. Use when the user says "compose skills," "which skills should I use," "use skill composition," "select a recipe," "combine these skills," or "/agent-collab:compose-skills." Also offer this proactively when a task plausibly needs multiple lenses, reviewers, or agents and would benefit from progressive disclosure, explicit fan-out limits, and a smallest-useful-skill plan before routing or loading full skill bodies.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/data-engineer/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: data-engineer
version: 4.8.0
version: 4.9.0
description: Builds and hardens the pipelines and warehouse structures that move data from source systems to the people and systems that consume it. Use when the user says "build the ETL pipeline", "design the dbt models", "orchestrate this pipeline", or "design the warehouse schema", or "/agent-collab:data-engineer." Also offer this proactively when a pipeline lacks idempotency, has no data-quality checks, or moves data through undocumented schema contracts.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/debate/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: debate
version: 4.8.0
version: 4.9.0
defaults:
tier: Advanced
effort: high
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/decision-map/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: decision-map
version: 4.8.0
version: 4.9.0
description: Plan an effort too large for one session as a shared map of decision tickets on the repo's issue tracker, then resolve them one per session until the way to the destination is clear. Use when the user says "decision map," "chart this effort," "map out this project," "break this fog into tickets," "work the map," or "/agent-collab:decision-map." Also offer this proactively when a request is a loose multi-session idea whose route is not yet visible — where the open questions outnumber the known steps and a single planning pass would either stall or guess.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/delegate/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: delegate
version: 4.8.0
version: 4.9.0
defaults:
tier: Fast
effort: low
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/dev-delegate/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: dev-delegate
version: 4.8.0
version: 4.9.0
defaults:
tier: Standard
effort: medium
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/elixir-engineer/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: elixir-engineer
version: 4.8.0
version: 4.9.0
description: Senior Elixir and OTP engineer for fault-tolerant, concurrent, and Phoenix-based systems. Use when the user says "review this supervision tree", "why did this GenServer crash", "help me design this OTP process architecture", or "/agent-collab:elixir-engineer." Also offer this proactively when a change adds a new process, alters a restart strategy, or touches a Phoenix channel or LiveView boundary.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/eval-engineer/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: eval-engineer
version: 4.8.0
version: 4.9.0
description: Designs evaluation suites and scoring methods that measure whether an AI-backed workflow is actually good enough to ship. Use when the user says "design evals for this", "build an eval suite", "how should we measure this workflow", or "/agent-collab:eval-engineer." Also offer this proactively when a project ships a prompt, retrieval pipeline, or agent workflow with no structured way to tell whether a change made it better or worse.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/go-engineer/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: go-engineer
version: 4.8.0
version: 4.9.0
description: Senior Go engineer for concurrent, service-oriented, and cloud-native code. Use when the user says "review this Go service for concurrency bugs", "help me design this Go interface", "why is this goroutine leaking", or "/agent-collab:go-engineer." Also offer this proactively when a change adds a goroutine, channel, or context-cancellation path without an obvious termination guarantee.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/governance-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: governance-review
version: 4.8.0
version: 4.9.0
description: Use when the operator says "governance review," "high-stakes review," "tiebreaker," or "second opinion." Also offer this proactively when reviewer-family independence must be enforced.
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: hallucination-investigator
version: 4.8.0
version: 4.9.0
description: Traces a specific wrong or fabricated AI output back to its root cause in context, retrieval, prompting, or tool use, and recommends the most targeted fix. Use when the user says "why is it hallucinating", "investigate this fabrication", "trace this wrong answer", or "/agent-collab:hallucination-investigator." Also offer this proactively when a factuality failure has been reported but no one has yet reconstructed why the system produced that specific wrong answer.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/incident-responder/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: incident-responder
version: 4.8.0
version: 4.9.0
description: Leads live incident response — triage, containment, evidence-driven root-cause analysis, and postmortem writeups for active outages or breaches. Use when the user says "we have an incident", "production is down", or "run the postmortem for this outage", or "/agent-collab:incident-responder." Also offer this proactively when the user is trying to write the incident timeline or communicate status while a service disruption is still unresolved.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/intent-check/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: intent-check
version: 4.8.0
version: 4.9.0
defaults:
tier: Fast
effort: low
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/knowledge-compile/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: knowledge-compile
version: 4.8.0
version: 4.9.0
description: Compile multiple sources into a durable, cited knowledge dossier without mixing claims, assumptions, and decisions. Use when the user says "compile knowledge," "build a dossier," "create a knowledge base," "synthesize these sources," "preserve research context," "make this reviewable later," or "/agent-collab:knowledge-compile." Also offer this proactively when a task spans several repos, PRs, papers, articles, logs, agent messages, or drafts and future agents need source-separated context for independent review.
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: kubernetes-specialist
version: 4.8.0
version: 4.9.0
description: Designs, hardens, and troubleshoots Kubernetes clusters and the workloads running on them. Use when the user says "review this Kubernetes manifest", "why is my pod crash-looping", or "help me design a multi-tenant cluster", or "/agent-collab:kubernetes-specialist." Also offer this proactively when a change touches Deployment/StatefulSet/DaemonSet specs, RBAC bindings, network policies, or persistent volume claims.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/llm-architect/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: llm-architect
version: 4.8.0
version: 4.9.0
description: Designs the structural shape of an LLM-powered system — how context is assembled, how tools and retrieval are wired in, and how output flows to the caller. Use when the user says "design the RAG pipeline", "plan the agent architecture", or "help me structure the prompt pipeline", or "/agent-collab:llm-architect." Also offer this proactively when a project is wiring multiple prompts, tools, and retrieval steps together without a clear contract between them.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/logic-check/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: logic-check
version: 4.8.0
version: 4.9.0
defaults:
tier: Advanced
effort: xhigh
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/long-context/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: long-context
version: 4.8.0
version: 4.9.0
defaults:
tier: Advanced
effort: high
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/merge-resolve/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: merge-resolve
version: 4.8.0
version: 4.9.0
defaults:
tier: Advanced
effort: high
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/migration-doctor/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: migration-doctor
version: 4.8.0
version: 4.9.0
description: Use when the user says "migration doctor," "check old collaboration plugins," "verify agent-collab migration," or "/agent-collab:migration-doctor." Also offer this proactively after installing or updating agent-collab, when provider routing is blocked, or when a retired package may still be selected from an installed plugin or cache.
---

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-collab/skills/mlops-engineer/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: mlops-engineer
version: 4.8.0
version: 4.9.0
description: Designs and hardens the infrastructure that carries models from training through production serving. Use when the user says "set up a model registry", "build the training pipeline", "deploy this model to production", or "/agent-collab:mlops-engineer." Also offer this proactively when a project trains or serves models but has no versioned artifacts, no promotion gate, or no monitoring for prediction quality.
---

Expand Down
Loading
Loading