From cd8fa138937d93182bec931fed938057cf2d6792 Mon Sep 17 00:00:00 2001 From: John Osumi <931193+sumitake@users.noreply.github.com> Date: Mon, 3 Aug 2026 13:48:49 -0700 Subject: [PATCH] orchestrate/teamwork: conditional tracer-bullet + expand-contract decomposition guidance v4.9.0 Second deferred follow-up from #83. Feature-implementation-only scope with named inapplicability; expand-contract reserved for genuine coexistence-required migrations (codemoddable changes run as checkpointed verified batches); bounded-worker-invocation sizing. Adapted portions attributed (to-tickets @2ab95809); both members mixed PolyForm AND MIT in SPDX. Co-Authored-By: Claude Fable 5 --- .claude-plugin/marketplace.base.json | 2 +- .claude-plugin/marketplace.json | 4 +- README.md | 20 +++++++- ...2026-08-03-decomposition-guidance-4.9.0.md | 14 ++++++ docs/third-party-skill-provenance.md | 8 ++++ .../agent-collab/.claude-plugin/plugin.json | 2 +- .../agent-collab/.codex-plugin/plugin.json | 2 +- plugins/agent-collab/README.md | 4 +- .../skills/agent-readiness/SKILL.md | 2 +- .../skills/agent-runtime-status/SKILL.md | 2 +- .../skills/ai-writing-auditor/SKILL.md | 2 +- .../agent-collab/skills/architect/SKILL.md | 2 +- .../skills/architecture-review/SKILL.md | 2 +- .../skills/autonomy-readiness/SKILL.md | 2 +- .../agent-collab/skills/brainstorm/SKILL.md | 2 +- .../skills/chain-configurator/SKILL.md | 2 +- plugins/agent-collab/skills/chain/SKILL.md | 2 +- .../agent-collab/skills/code-review/SKILL.md | 2 +- .../skills/compose-skills/SKILL.md | 2 +- .../skills/data-engineer/SKILL.md | 2 +- plugins/agent-collab/skills/debate/SKILL.md | 2 +- .../agent-collab/skills/decision-map/SKILL.md | 2 +- plugins/agent-collab/skills/delegate/SKILL.md | 2 +- .../agent-collab/skills/dev-delegate/SKILL.md | 2 +- .../skills/elixir-engineer/SKILL.md | 2 +- .../skills/eval-engineer/SKILL.md | 2 +- .../agent-collab/skills/go-engineer/SKILL.md | 2 +- .../skills/governance-review/SKILL.md | 2 +- .../hallucination-investigator/SKILL.md | 2 +- .../skills/incident-responder/SKILL.md | 2 +- .../agent-collab/skills/intent-check/SKILL.md | 2 +- .../skills/knowledge-compile/SKILL.md | 2 +- .../skills/kubernetes-specialist/SKILL.md | 2 +- .../skills/llm-architect/SKILL.md | 2 +- .../agent-collab/skills/logic-check/SKILL.md | 2 +- .../agent-collab/skills/long-context/SKILL.md | 2 +- .../skills/merge-resolve/SKILL.md | 2 +- .../skills/migration-doctor/SKILL.md | 2 +- .../skills/mlops-engineer/SKILL.md | 2 +- .../agent-collab/skills/orchestrate/SKILL.md | 47 ++++++++++++++++++- .../skills/postgres-engineer/SKILL.md | 2 +- .../skills/prompt-regression-tester/SKILL.md | 2 +- .../agent-collab/skills/prototype/SKILL.md | 2 +- .../agent-collab/skills/qa-verify/SKILL.md | 2 +- plugins/agent-collab/skills/red-team/SKILL.md | 2 +- plugins/agent-collab/skills/route/SKILL.md | 2 +- .../skills/rust-engineer/SKILL.md | 2 +- .../skills/second-opinion/SKILL.md | 2 +- .../skills/simulate-user/SKILL.md | 2 +- .../agent-collab/skills/sql-engineer/SKILL.md | 2 +- .../agent-collab/skills/sre-engineer/SKILL.md | 2 +- .../skills/start-inbox-monitor/SKILL.md | 2 +- plugins/agent-collab/skills/teamwork/SKILL.md | 44 ++++++++++++++++- .../skills/terraform-engineer/SKILL.md | 2 +- .../agent-collab/skills/ui-to-code/SKILL.md | 2 +- .../skills/untrusted-audit/SKILL.md | 2 +- .../skills/visual-review/SKILL.md | 2 +- plugins/agent-collab/skills/worker/SKILL.md | 2 +- scripts/build_release_evidence.py | 3 +- scripts/skill-build-config.json | 2 +- skill-specs/orchestrate.md | 45 ++++++++++++++++++ skill-specs/teamwork.md | 42 +++++++++++++++++ tests/test_release_evidence.py | 6 ++- 63 files changed, 279 insertions(+), 62 deletions(-) create mode 100644 changelog.d/2026-08-03-decomposition-guidance-4.9.0.md diff --git a/.claude-plugin/marketplace.base.json b/.claude-plugin/marketplace.base.json index 9a85e47..b298e5b 100644 --- a/.claude-plugin/marketplace.base.json +++ b/.claude-plugin/marketplace.base.json @@ -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" } } diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 36476e1..a621f60 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -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" }, @@ -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" } } diff --git a/README.md b/README.md index c7e2f04..47a2f94 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 diff --git a/changelog.d/2026-08-03-decomposition-guidance-4.9.0.md b/changelog.d/2026-08-03-decomposition-guidance-4.9.0.md new file mode 100644 index 0000000..f84f2df --- /dev/null +++ b/changelog.d/2026-08-03-decomposition-guidance-4.9.0.md @@ -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`. diff --git a/docs/third-party-skill-provenance.md b/docs/third-party-skill-provenance.md index 137a11e..63a5e65 100644 --- a/docs/third-party-skill-provenance.md +++ b/docs/third-party-skill-provenance.md @@ -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) @@ -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`. diff --git a/plugins/agent-collab/.claude-plugin/plugin.json b/plugins/agent-collab/.claude-plugin/plugin.json index 827fb2b..8f4011c 100644 --- a/plugins/agent-collab/.claude-plugin/plugin.json +++ b/plugins/agent-collab/.claude-plugin/plugin.json @@ -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" diff --git a/plugins/agent-collab/.codex-plugin/plugin.json b/plugins/agent-collab/.codex-plugin/plugin.json index 7125c79..12c0a0c 100644 --- a/plugins/agent-collab/.codex-plugin/plugin.json +++ b/plugins/agent-collab/.codex-plugin/plugin.json @@ -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" diff --git a/plugins/agent-collab/README.md b/plugins/agent-collab/README.md index 5c62f60..5f9aeb2 100644 --- a/plugins/agent-collab/README.md +++ b/plugins/agent-collab/README.md @@ -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 @@ -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 diff --git a/plugins/agent-collab/skills/agent-readiness/SKILL.md b/plugins/agent-collab/skills/agent-readiness/SKILL.md index ebff237..06accf1 100644 --- a/plugins/agent-collab/skills/agent-readiness/SKILL.md +++ b/plugins/agent-collab/skills/agent-readiness/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/agent-runtime-status/SKILL.md b/plugins/agent-collab/skills/agent-runtime-status/SKILL.md index a0bd5cd..925de24 100644 --- a/plugins/agent-collab/skills/agent-runtime-status/SKILL.md +++ b/plugins/agent-collab/skills/agent-runtime-status/SKILL.md @@ -1,6 +1,6 @@ --- name: agent-runtime-status -version: 4.8.0 +version: 4.9.0 defaults: tier: Fast effort: low diff --git a/plugins/agent-collab/skills/ai-writing-auditor/SKILL.md b/plugins/agent-collab/skills/ai-writing-auditor/SKILL.md index 05ee25c..263fa43 100644 --- a/plugins/agent-collab/skills/ai-writing-auditor/SKILL.md +++ b/plugins/agent-collab/skills/ai-writing-auditor/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/architect/SKILL.md b/plugins/agent-collab/skills/architect/SKILL.md index 05a549f..b7daf67 100644 --- a/plugins/agent-collab/skills/architect/SKILL.md +++ b/plugins/agent-collab/skills/architect/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/architecture-review/SKILL.md b/plugins/agent-collab/skills/architecture-review/SKILL.md index 52c2cda..4107fd3 100644 --- a/plugins/agent-collab/skills/architecture-review/SKILL.md +++ b/plugins/agent-collab/skills/architecture-review/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/autonomy-readiness/SKILL.md b/plugins/agent-collab/skills/autonomy-readiness/SKILL.md index 473c14a..6499c63 100644 --- a/plugins/agent-collab/skills/autonomy-readiness/SKILL.md +++ b/plugins/agent-collab/skills/autonomy-readiness/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/brainstorm/SKILL.md b/plugins/agent-collab/skills/brainstorm/SKILL.md index 62e4e4c..878f438 100644 --- a/plugins/agent-collab/skills/brainstorm/SKILL.md +++ b/plugins/agent-collab/skills/brainstorm/SKILL.md @@ -1,6 +1,6 @@ --- name: brainstorm -version: 4.8.0 +version: 4.9.0 defaults: tier: Fast effort: low diff --git a/plugins/agent-collab/skills/chain-configurator/SKILL.md b/plugins/agent-collab/skills/chain-configurator/SKILL.md index 5acdf40..8aaf0d5 100644 --- a/plugins/agent-collab/skills/chain-configurator/SKILL.md +++ b/plugins/agent-collab/skills/chain-configurator/SKILL.md @@ -1,6 +1,6 @@ --- name: chain-configurator -version: 4.8.0 +version: 4.9.0 defaults: tier: Standard effort: medium diff --git a/plugins/agent-collab/skills/chain/SKILL.md b/plugins/agent-collab/skills/chain/SKILL.md index 02b0612..3ac52f0 100644 --- a/plugins/agent-collab/skills/chain/SKILL.md +++ b/plugins/agent-collab/skills/chain/SKILL.md @@ -1,6 +1,6 @@ --- name: chain -version: 4.8.0 +version: 4.9.0 defaults: tier: Standard effort: medium diff --git a/plugins/agent-collab/skills/code-review/SKILL.md b/plugins/agent-collab/skills/code-review/SKILL.md index 65320b3..ce444a1 100644 --- a/plugins/agent-collab/skills/code-review/SKILL.md +++ b/plugins/agent-collab/skills/code-review/SKILL.md @@ -1,6 +1,6 @@ --- name: code-review -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/compose-skills/SKILL.md b/plugins/agent-collab/skills/compose-skills/SKILL.md index 6d958ef..f388ef6 100644 --- a/plugins/agent-collab/skills/compose-skills/SKILL.md +++ b/plugins/agent-collab/skills/compose-skills/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/data-engineer/SKILL.md b/plugins/agent-collab/skills/data-engineer/SKILL.md index e51136d..1258b4a 100644 --- a/plugins/agent-collab/skills/data-engineer/SKILL.md +++ b/plugins/agent-collab/skills/data-engineer/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/debate/SKILL.md b/plugins/agent-collab/skills/debate/SKILL.md index 1eba7e3..6cc0807 100644 --- a/plugins/agent-collab/skills/debate/SKILL.md +++ b/plugins/agent-collab/skills/debate/SKILL.md @@ -1,6 +1,6 @@ --- name: debate -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/decision-map/SKILL.md b/plugins/agent-collab/skills/decision-map/SKILL.md index bff53d7..fdd094b 100644 --- a/plugins/agent-collab/skills/decision-map/SKILL.md +++ b/plugins/agent-collab/skills/decision-map/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/delegate/SKILL.md b/plugins/agent-collab/skills/delegate/SKILL.md index 9873ad3..cbd4883 100644 --- a/plugins/agent-collab/skills/delegate/SKILL.md +++ b/plugins/agent-collab/skills/delegate/SKILL.md @@ -1,6 +1,6 @@ --- name: delegate -version: 4.8.0 +version: 4.9.0 defaults: tier: Fast effort: low diff --git a/plugins/agent-collab/skills/dev-delegate/SKILL.md b/plugins/agent-collab/skills/dev-delegate/SKILL.md index 933f8fd..86c0ab4 100644 --- a/plugins/agent-collab/skills/dev-delegate/SKILL.md +++ b/plugins/agent-collab/skills/dev-delegate/SKILL.md @@ -1,6 +1,6 @@ --- name: dev-delegate -version: 4.8.0 +version: 4.9.0 defaults: tier: Standard effort: medium diff --git a/plugins/agent-collab/skills/elixir-engineer/SKILL.md b/plugins/agent-collab/skills/elixir-engineer/SKILL.md index fe19834..c92114f 100644 --- a/plugins/agent-collab/skills/elixir-engineer/SKILL.md +++ b/plugins/agent-collab/skills/elixir-engineer/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/eval-engineer/SKILL.md b/plugins/agent-collab/skills/eval-engineer/SKILL.md index 1f42510..d5fffed 100644 --- a/plugins/agent-collab/skills/eval-engineer/SKILL.md +++ b/plugins/agent-collab/skills/eval-engineer/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/go-engineer/SKILL.md b/plugins/agent-collab/skills/go-engineer/SKILL.md index 6c7d2ed..0f5f37b 100644 --- a/plugins/agent-collab/skills/go-engineer/SKILL.md +++ b/plugins/agent-collab/skills/go-engineer/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/governance-review/SKILL.md b/plugins/agent-collab/skills/governance-review/SKILL.md index c9c1e31..d5c3183 100644 --- a/plugins/agent-collab/skills/governance-review/SKILL.md +++ b/plugins/agent-collab/skills/governance-review/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/hallucination-investigator/SKILL.md b/plugins/agent-collab/skills/hallucination-investigator/SKILL.md index 2378ff1..4a1847f 100644 --- a/plugins/agent-collab/skills/hallucination-investigator/SKILL.md +++ b/plugins/agent-collab/skills/hallucination-investigator/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/incident-responder/SKILL.md b/plugins/agent-collab/skills/incident-responder/SKILL.md index 4fb8355..4fdf8d6 100644 --- a/plugins/agent-collab/skills/incident-responder/SKILL.md +++ b/plugins/agent-collab/skills/incident-responder/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/intent-check/SKILL.md b/plugins/agent-collab/skills/intent-check/SKILL.md index 4b7922c..8122d47 100644 --- a/plugins/agent-collab/skills/intent-check/SKILL.md +++ b/plugins/agent-collab/skills/intent-check/SKILL.md @@ -1,6 +1,6 @@ --- name: intent-check -version: 4.8.0 +version: 4.9.0 defaults: tier: Fast effort: low diff --git a/plugins/agent-collab/skills/knowledge-compile/SKILL.md b/plugins/agent-collab/skills/knowledge-compile/SKILL.md index 2a38a7e..774f2a7 100644 --- a/plugins/agent-collab/skills/knowledge-compile/SKILL.md +++ b/plugins/agent-collab/skills/knowledge-compile/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/kubernetes-specialist/SKILL.md b/plugins/agent-collab/skills/kubernetes-specialist/SKILL.md index bc62be0..796fcb2 100644 --- a/plugins/agent-collab/skills/kubernetes-specialist/SKILL.md +++ b/plugins/agent-collab/skills/kubernetes-specialist/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/llm-architect/SKILL.md b/plugins/agent-collab/skills/llm-architect/SKILL.md index 37d0953..b5991fa 100644 --- a/plugins/agent-collab/skills/llm-architect/SKILL.md +++ b/plugins/agent-collab/skills/llm-architect/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/logic-check/SKILL.md b/plugins/agent-collab/skills/logic-check/SKILL.md index 4047496..8ac8d78 100644 --- a/plugins/agent-collab/skills/logic-check/SKILL.md +++ b/plugins/agent-collab/skills/logic-check/SKILL.md @@ -1,6 +1,6 @@ --- name: logic-check -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: xhigh diff --git a/plugins/agent-collab/skills/long-context/SKILL.md b/plugins/agent-collab/skills/long-context/SKILL.md index 43d6d10..42f1101 100644 --- a/plugins/agent-collab/skills/long-context/SKILL.md +++ b/plugins/agent-collab/skills/long-context/SKILL.md @@ -1,6 +1,6 @@ --- name: long-context -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/merge-resolve/SKILL.md b/plugins/agent-collab/skills/merge-resolve/SKILL.md index 012a69e..eac102e 100644 --- a/plugins/agent-collab/skills/merge-resolve/SKILL.md +++ b/plugins/agent-collab/skills/merge-resolve/SKILL.md @@ -1,6 +1,6 @@ --- name: merge-resolve -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/migration-doctor/SKILL.md b/plugins/agent-collab/skills/migration-doctor/SKILL.md index 250aa32..60421c6 100644 --- a/plugins/agent-collab/skills/migration-doctor/SKILL.md +++ b/plugins/agent-collab/skills/migration-doctor/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/mlops-engineer/SKILL.md b/plugins/agent-collab/skills/mlops-engineer/SKILL.md index ce38baa..1e07815 100644 --- a/plugins/agent-collab/skills/mlops-engineer/SKILL.md +++ b/plugins/agent-collab/skills/mlops-engineer/SKILL.md @@ -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. --- diff --git a/plugins/agent-collab/skills/orchestrate/SKILL.md b/plugins/agent-collab/skills/orchestrate/SKILL.md index e686252..7b6a660 100644 --- a/plugins/agent-collab/skills/orchestrate/SKILL.md +++ b/plugins/agent-collab/skills/orchestrate/SKILL.md @@ -1,6 +1,6 @@ --- name: orchestrate -version: 4.8.0 +version: 4.9.0 defaults: tier: Standard effort: medium @@ -39,3 +39,48 @@ route/action. Never embed provider commands in a graph. Safe mode permits local/async coordination only. Codex build remains a distinct typed-unavailable role; the Grok 4.5 `composer/codegen` compatibility route can return output-only code material for the trusted primary to apply and verify. + +## Slicing implementation nodes (conditional guidance) + +This guidance applies ONLY when the graph decomposes **product-feature +implementation** into build nodes. It does not apply to research, operations, +configuration, or decision-only graphs — do not force those into slices. + +- **Prefer tracer-bullet vertical slices**: each implementation node cuts a + narrow but complete path through every affected layer (schema, API, UI, + tests) rather than a horizontal slice of one layer. A completed node is + demoable or independently verifiable on its own, sized to one bounded worker + invocation with explicit acceptance criteria. Prefactoring nodes ("make the + change easy") come first and block the slices that need them. +- **Wide refactors are the exception.** When one mechanical change fans across + the codebase so no vertical slice can land green: if the change is + atomically codemoddable, run it as checkpointed batches with full + verification after each batch. Reserve **expand–contract** sequencing — + expand the new form beside the old, migrate call sites in batches (each its + own node blocked by the expand), contract the old form in a node blocked by + every migration batch — for cases where old and new forms must genuinely + coexist to keep callers and CI working during a staged migration. Do not + default to expand–contract merely because the blast radius is large. + +## Attribution and license + +The tracer-bullet slice rules and expand–contract sequencing above are adapted +from `skills/engineering/to-tickets/SKILL.md` in +[mattpocock/skills](https://github.com/mattpocock/skills) at commit +`2ab958093e83e0ec752e6c1c5932da465bf23e0c` (blob +`96deac51d4391a3f691478d48f85f43261516c08`); the remainder of this skill is +package-original. The adapted portions are and remain MIT-licensed: +Copyright (c) 2026 Matt Pocock. Permission is hereby granted, free of charge, +to any person obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to permit +persons to whom the Software is furnished to do so, subject to the following +conditions: The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. THE SOFTWARE +IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A +PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR +IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/plugins/agent-collab/skills/postgres-engineer/SKILL.md b/plugins/agent-collab/skills/postgres-engineer/SKILL.md index 2b4694b..67ab145 100644 --- a/plugins/agent-collab/skills/postgres-engineer/SKILL.md +++ b/plugins/agent-collab/skills/postgres-engineer/SKILL.md @@ -1,6 +1,6 @@ --- name: postgres-engineer -version: 4.8.0 +version: 4.9.0 description: Administers and hardens PostgreSQL at the engine level — configuration, replication, vacuum behavior, and locking under real workloads. Use when the user says "tune postgres for this workload", "design a vacuum strategy", "set up replication", or "fix our connection pooling", or "/agent-collab:postgres-engineer." Also offer this proactively when a PostgreSQL deployment shows replication lag, bloat, connection exhaustion, or a failover plan that has never been tested. --- diff --git a/plugins/agent-collab/skills/prompt-regression-tester/SKILL.md b/plugins/agent-collab/skills/prompt-regression-tester/SKILL.md index 3aeba9b..ede78b3 100644 --- a/plugins/agent-collab/skills/prompt-regression-tester/SKILL.md +++ b/plugins/agent-collab/skills/prompt-regression-tester/SKILL.md @@ -1,6 +1,6 @@ --- name: prompt-regression-tester -version: 4.8.0 +version: 4.9.0 description: Builds and runs comparison suites that catch behavioral drift when a prompt, model, or workflow configuration changes. Use when the user says "did the prompt change regress anything", "compare these prompt versions", "regression-test this prompt change", or "/agent-collab:prompt-regression-tester." Also offer this proactively when someone is about to swap a prompt, model, or tool wiring in a live workflow without a way to check whether existing behavior held. --- diff --git a/plugins/agent-collab/skills/prototype/SKILL.md b/plugins/agent-collab/skills/prototype/SKILL.md index 25955d0..a408855 100644 --- a/plugins/agent-collab/skills/prototype/SKILL.md +++ b/plugins/agent-collab/skills/prototype/SKILL.md @@ -1,6 +1,6 @@ --- name: prototype -version: 4.8.0 +version: 4.9.0 description: Build a throwaway prototype that answers one design question — an interactive terminal app to pressure-test a state model or logic shape, or several radically different UI variants on one route. Use when the user says "prototype this," "sanity-check this state model," "show me a few options for this page," "mock up some variations," or "/agent-collab:prototype." Also offer this proactively when a design conversation is circling a question that a runnable artifact would settle in minutes — how a state machine handles an awkward case, or which of several layouts actually works with real data. --- diff --git a/plugins/agent-collab/skills/qa-verify/SKILL.md b/plugins/agent-collab/skills/qa-verify/SKILL.md index 328848a..b16f389 100644 --- a/plugins/agent-collab/skills/qa-verify/SKILL.md +++ b/plugins/agent-collab/skills/qa-verify/SKILL.md @@ -1,6 +1,6 @@ --- name: qa-verify -version: 4.8.0 +version: 4.9.0 defaults: tier: Fast effort: low diff --git a/plugins/agent-collab/skills/red-team/SKILL.md b/plugins/agent-collab/skills/red-team/SKILL.md index 10bd856..b5e7940 100644 --- a/plugins/agent-collab/skills/red-team/SKILL.md +++ b/plugins/agent-collab/skills/red-team/SKILL.md @@ -1,6 +1,6 @@ --- name: red-team -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/route/SKILL.md b/plugins/agent-collab/skills/route/SKILL.md index 367ea1c..92b5a90 100644 --- a/plugins/agent-collab/skills/route/SKILL.md +++ b/plugins/agent-collab/skills/route/SKILL.md @@ -1,6 +1,6 @@ --- name: route -version: 4.8.0 +version: 4.9.0 description: Use when the operator says "ask Codex," "target=gemini," "target=grok," "target=composer," or explicitly names a managed backend. Also offer this proactively when routing needs dynamic primary-family exclusion. --- diff --git a/plugins/agent-collab/skills/rust-engineer/SKILL.md b/plugins/agent-collab/skills/rust-engineer/SKILL.md index dd5e27c..0be824e 100644 --- a/plugins/agent-collab/skills/rust-engineer/SKILL.md +++ b/plugins/agent-collab/skills/rust-engineer/SKILL.md @@ -1,6 +1,6 @@ --- name: rust-engineer -version: 4.8.0 +version: 4.9.0 description: Senior Rust engineer for ownership-heavy, performance-sensitive, and systems-level code. Use when the user says "review this Rust code for soundness", "help me fix this borrow checker error", "optimize this Rust hot path", or "/agent-collab:rust-engineer." Also offer this proactively when a diff introduces unsafe blocks, changes lifetime bounds, or touches an async task's cancellation path. --- diff --git a/plugins/agent-collab/skills/second-opinion/SKILL.md b/plugins/agent-collab/skills/second-opinion/SKILL.md index 1b8c9ae..5c14cc8 100644 --- a/plugins/agent-collab/skills/second-opinion/SKILL.md +++ b/plugins/agent-collab/skills/second-opinion/SKILL.md @@ -1,6 +1,6 @@ --- name: second-opinion -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/simulate-user/SKILL.md b/plugins/agent-collab/skills/simulate-user/SKILL.md index ebf2877..7d57fff 100644 --- a/plugins/agent-collab/skills/simulate-user/SKILL.md +++ b/plugins/agent-collab/skills/simulate-user/SKILL.md @@ -1,6 +1,6 @@ --- name: simulate-user -version: 4.8.0 +version: 4.9.0 defaults: tier: Fast effort: low diff --git a/plugins/agent-collab/skills/sql-engineer/SKILL.md b/plugins/agent-collab/skills/sql-engineer/SKILL.md index 4b6f3e0..b47dadb 100644 --- a/plugins/agent-collab/skills/sql-engineer/SKILL.md +++ b/plugins/agent-collab/skills/sql-engineer/SKILL.md @@ -1,6 +1,6 @@ --- name: sql-engineer -version: 4.8.0 +version: 4.9.0 description: Senior SQL specialist for query design, query optimization, and schema-aware performance work across relational databases. Use when the user says "optimize this SQL query", "explain this query plan", "design these indexes", or "/agent-collab:sql-engineer." Also offer this proactively when a diff adds a new query against a large table, changes a join or aggregation, or introduces a schema change that could affect an existing access pattern. --- diff --git a/plugins/agent-collab/skills/sre-engineer/SKILL.md b/plugins/agent-collab/skills/sre-engineer/SKILL.md index 179426e..58026ee 100644 --- a/plugins/agent-collab/skills/sre-engineer/SKILL.md +++ b/plugins/agent-collab/skills/sre-engineer/SKILL.md @@ -1,6 +1,6 @@ --- name: sre-engineer -version: 4.8.0 +version: 4.9.0 description: Builds and improves system reliability through SLO design, error-budget policy, toil reduction, and resilience architecture. Use when the user says "help me define SLOs for this service", "what's our error budget burn rate", or "reduce the toil in this on-call rotation", or "/agent-collab:sre-engineer." Also offer this proactively when a reliability review, capacity plan, or alert-quality audit is warranted ahead of a launch or growth milestone. --- diff --git a/plugins/agent-collab/skills/start-inbox-monitor/SKILL.md b/plugins/agent-collab/skills/start-inbox-monitor/SKILL.md index fa4e20c..8392775 100644 --- a/plugins/agent-collab/skills/start-inbox-monitor/SKILL.md +++ b/plugins/agent-collab/skills/start-inbox-monitor/SKILL.md @@ -1,6 +1,6 @@ --- name: start-inbox-monitor -version: 4.8.0 +version: 4.9.0 description: Use when the user says "start the inbox monitor", "keep monitoring agent messages", or "/agent-collab:start-inbox-monitor", or when an active cross-agent thread needs durable session-scoped inbox monitoring. Select the native Codex, Claude, or Antigravity lifecycle instead of inventing a universal polling loop. --- diff --git a/plugins/agent-collab/skills/teamwork/SKILL.md b/plugins/agent-collab/skills/teamwork/SKILL.md index dae6a67..940762c 100644 --- a/plugins/agent-collab/skills/teamwork/SKILL.md +++ b/plugins/agent-collab/skills/teamwork/SKILL.md @@ -1,6 +1,6 @@ --- name: teamwork -version: 4.8.0 +version: 4.9.0 defaults: tier: Standard effort: medium @@ -40,3 +40,45 @@ destructive decision. gate. Do not let a teammate merge, deploy, change secrets, or rewrite history. 7. Return an attributed ledger of each role's artifact and the primary's verification evidence. + +## Slicing worker milestones (conditional guidance) + +Applies ONLY when milestones decompose **product-feature implementation**; it +does not apply to research, operations, configuration, or decision-only +milestones — do not force those into slices. + +- **Prefer tracer-bullet vertical slices**: each worker milestone cuts a + narrow but complete path through every affected layer, is demoable or + independently verifiable on its own, and is sized to one bounded worker + invocation/session with explicit acceptance criteria. Prefactoring + milestones come first. +- **Wide refactors are the exception.** An atomically codemoddable mechanical + change runs as checkpointed batches with full verification per batch. + Reserve expand–contract sequencing (expand beside the old form; migrate + call sites in batch milestones; contract when no caller remains) for cases + where old and new forms must genuinely coexist to keep callers and CI + working during a staged migration — never merely because the blast radius + is large. + +## Attribution and license + +The tracer-bullet slice rules and expand–contract sequencing above are adapted +from `skills/engineering/to-tickets/SKILL.md` in +[mattpocock/skills](https://github.com/mattpocock/skills) at commit +`2ab958093e83e0ec752e6c1c5932da465bf23e0c` (blob +`96deac51d4391a3f691478d48f85f43261516c08`); the remainder of this skill is +package-original. The adapted portions are and remain MIT-licensed: +Copyright (c) 2026 Matt Pocock. Permission is hereby granted, free of charge, +to any person obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to permit +persons to whom the Software is furnished to do so, subject to the following +conditions: The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. THE SOFTWARE +IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A +PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR +IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/plugins/agent-collab/skills/terraform-engineer/SKILL.md b/plugins/agent-collab/skills/terraform-engineer/SKILL.md index 66dd7ad..f0fd2ff 100644 --- a/plugins/agent-collab/skills/terraform-engineer/SKILL.md +++ b/plugins/agent-collab/skills/terraform-engineer/SKILL.md @@ -1,6 +1,6 @@ --- name: terraform-engineer -version: 4.8.0 +version: 4.9.0 description: Designs, refactors, and reviews Terraform infrastructure-as-code across cloud providers, with a focus on module contracts, state safety, and reviewable plans. Use when the user says "review this Terraform plan", "help me design a reusable module", or "why did this apply want to replace my resource", or "/agent-collab:terraform-engineer." Also offer this proactively when a change touches module interfaces, state backend configuration, or resource lifecycle blocks. --- diff --git a/plugins/agent-collab/skills/ui-to-code/SKILL.md b/plugins/agent-collab/skills/ui-to-code/SKILL.md index 27d6fd0..b6dfd46 100644 --- a/plugins/agent-collab/skills/ui-to-code/SKILL.md +++ b/plugins/agent-collab/skills/ui-to-code/SKILL.md @@ -1,6 +1,6 @@ --- name: ui-to-code -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/untrusted-audit/SKILL.md b/plugins/agent-collab/skills/untrusted-audit/SKILL.md index 3870af8..caad5d8 100644 --- a/plugins/agent-collab/skills/untrusted-audit/SKILL.md +++ b/plugins/agent-collab/skills/untrusted-audit/SKILL.md @@ -1,6 +1,6 @@ --- name: untrusted-audit -version: 4.8.0 +version: 4.9.0 description: Audit an external or untrusted source before using it in code, skills, plugins, workflows, prompts, or operations. Use when the user says "audit this untrusted source," "can we use this repo," "review this gist," "prompt injection audit," "is this plugin safe," "evaluate this methodology," or "/agent-collab:untrusted-audit." Also offer this proactively when a task would incorporate third-party instructions, code, scripts, hooks, generated skills, package manifests, install steps, or auto-updated methodology into the workspace or agent environment. --- diff --git a/plugins/agent-collab/skills/visual-review/SKILL.md b/plugins/agent-collab/skills/visual-review/SKILL.md index 299f6fd..6eaa430 100644 --- a/plugins/agent-collab/skills/visual-review/SKILL.md +++ b/plugins/agent-collab/skills/visual-review/SKILL.md @@ -1,6 +1,6 @@ --- name: visual-review -version: 4.8.0 +version: 4.9.0 defaults: tier: Advanced effort: high diff --git a/plugins/agent-collab/skills/worker/SKILL.md b/plugins/agent-collab/skills/worker/SKILL.md index 0f74e4d..d79ea56 100644 --- a/plugins/agent-collab/skills/worker/SKILL.md +++ b/plugins/agent-collab/skills/worker/SKILL.md @@ -1,6 +1,6 @@ --- name: worker -version: 4.8.0 +version: 4.9.0 description: Use when the operator says "delegate this implementation," "use Gemini for this corpus," "ask Codex to build," or "use Composer for codegen." Also offer this proactively when a bounded non-governance task benefits from a managed worker. --- diff --git a/scripts/build_release_evidence.py b/scripts/build_release_evidence.py index 64ae06b..236f950 100644 --- a/scripts/build_release_evidence.py +++ b/scripts/build_release_evidence.py @@ -33,7 +33,8 @@ # Skills that are package-original with an MIT-derived adapted portion carry # a mixed per-file expression (same provenance document). MIXED_LICENSE_SKILL_MEMBERS = frozenset( - f"skills/{name}/SKILL.md" for name in ("code-review",) + f"skills/{name}/SKILL.md" + for name in ("code-review", "orchestrate", "teamwork") ) # The package as a whole contains PolyForm-owned material AND the MIT-derived # skill members above, so the package-level expression aggregates both. diff --git a/scripts/skill-build-config.json b/scripts/skill-build-config.json index d478f80..f0f6c6e 100644 --- a/scripts/skill-build-config.json +++ b/scripts/skill-build-config.json @@ -20,7 +20,7 @@ "tier_flash_resolves_to_claude": "an asynchronous Anthropic inbox review; never a synchronous invocation", "tier_pro_resolves_to_gemini": "an eligible managed Google-family reviewer at high effort", "tier_flash_resolves_to_gemini": "an eligible managed Google-family reviewer at low effort", - "skill_version": "4.8.0", + "skill_version": "4.9.0", "agent_runtime_status_defaults_block": "defaults:\n tier: Fast\n effort: low\n", "merge_resolve_defaults_block": "defaults:\n tier: Advanced\n effort: high\n", "merge_resolve_call_params": "`effort='high'` in every eligible advisory row and no `tier` request field", diff --git a/skill-specs/orchestrate.md b/skill-specs/orchestrate.md index a25e299..2d24b1f 100644 --- a/skill-specs/orchestrate.md +++ b/skill-specs/orchestrate.md @@ -36,3 +36,48 @@ route/action. Never embed provider commands in a graph. Safe mode permits local/async coordination only. Codex build remains a distinct typed-unavailable role; the Grok 4.5 `composer/codegen` compatibility route can return output-only code material for the trusted primary to apply and verify. + +## Slicing implementation nodes (conditional guidance) + +This guidance applies ONLY when the graph decomposes **product-feature +implementation** into build nodes. It does not apply to research, operations, +configuration, or decision-only graphs — do not force those into slices. + +- **Prefer tracer-bullet vertical slices**: each implementation node cuts a + narrow but complete path through every affected layer (schema, API, UI, + tests) rather than a horizontal slice of one layer. A completed node is + demoable or independently verifiable on its own, sized to one bounded worker + invocation with explicit acceptance criteria. Prefactoring nodes ("make the + change easy") come first and block the slices that need them. +- **Wide refactors are the exception.** When one mechanical change fans across + the codebase so no vertical slice can land green: if the change is + atomically codemoddable, run it as checkpointed batches with full + verification after each batch. Reserve **expand–contract** sequencing — + expand the new form beside the old, migrate call sites in batches (each its + own node blocked by the expand), contract the old form in a node blocked by + every migration batch — for cases where old and new forms must genuinely + coexist to keep callers and CI working during a staged migration. Do not + default to expand–contract merely because the blast radius is large. + +## Attribution and license + +The tracer-bullet slice rules and expand–contract sequencing above are adapted +from `skills/engineering/to-tickets/SKILL.md` in +[mattpocock/skills](https://github.com/mattpocock/skills) at commit +`2ab958093e83e0ec752e6c1c5932da465bf23e0c` (blob +`96deac51d4391a3f691478d48f85f43261516c08`); the remainder of this skill is +package-original. The adapted portions are and remain MIT-licensed: +Copyright (c) 2026 Matt Pocock. Permission is hereby granted, free of charge, +to any person obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to permit +persons to whom the Software is furnished to do so, subject to the following +conditions: The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. THE SOFTWARE +IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A +PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR +IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/skill-specs/teamwork.md b/skill-specs/teamwork.md index 065bf19..ffa8df5 100644 --- a/skill-specs/teamwork.md +++ b/skill-specs/teamwork.md @@ -37,3 +37,45 @@ destructive decision. gate. Do not let a teammate merge, deploy, change secrets, or rewrite history. 7. Return an attributed ledger of each role's artifact and the primary's verification evidence. + +## Slicing worker milestones (conditional guidance) + +Applies ONLY when milestones decompose **product-feature implementation**; it +does not apply to research, operations, configuration, or decision-only +milestones — do not force those into slices. + +- **Prefer tracer-bullet vertical slices**: each worker milestone cuts a + narrow but complete path through every affected layer, is demoable or + independently verifiable on its own, and is sized to one bounded worker + invocation/session with explicit acceptance criteria. Prefactoring + milestones come first. +- **Wide refactors are the exception.** An atomically codemoddable mechanical + change runs as checkpointed batches with full verification per batch. + Reserve expand–contract sequencing (expand beside the old form; migrate + call sites in batch milestones; contract when no caller remains) for cases + where old and new forms must genuinely coexist to keep callers and CI + working during a staged migration — never merely because the blast radius + is large. + +## Attribution and license + +The tracer-bullet slice rules and expand–contract sequencing above are adapted +from `skills/engineering/to-tickets/SKILL.md` in +[mattpocock/skills](https://github.com/mattpocock/skills) at commit +`2ab958093e83e0ec752e6c1c5932da465bf23e0c` (blob +`96deac51d4391a3f691478d48f85f43261516c08`); the remainder of this skill is +package-original. The adapted portions are and remain MIT-licensed: +Copyright (c) 2026 Matt Pocock. Permission is hereby granted, free of charge, +to any person obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to permit +persons to whom the Software is furnished to do so, subject to the following +conditions: The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. THE SOFTWARE +IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A +PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR +IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/tests/test_release_evidence.py b/tests/test_release_evidence.py index 12351f9..18e5062 100644 --- a/tests/test_release_evidence.py +++ b/tests/test_release_evidence.py @@ -261,7 +261,11 @@ def test_policy_only_spdx_output_preserves_project_only_license_contract(self) - "skills/decision-map/SKILL.md", "skills/prototype/SKILL.md", } - mixed_members = {"skills/code-review/SKILL.md"} + mixed_members = { + "skills/code-review/SKILL.md", + "skills/orchestrate/SKILL.md", + "skills/teamwork/SKILL.md", + } observed_mit = { item["fileName"] for item in sbom["files"]