Support mode:autonomous argument for unattended/scheduled runs.
In autonomous mode: skip all user questions, apply safe actions
directly, mark ambiguous cases as stale with conservative confidence,
and generate a detailed report for after-the-fact human review.
Documents five skill design patterns discovered during testing:
platform-agnostic tool references, auto-archive consistency,
smart triage for broad scope, replacement subagents over
ce:compound handoff, and file tools over shell commands.
- Broad scope triage: inventory + impact clustering + spot-check drift
for 9+ docs, recommends highest-impact area instead of blind ask
- Drift classification: sharp boundary between Update (fix references
in-skill) and Replace (subagent writes successor learning)
- Replacement subagents: sequential subagents write new learnings using
ce:compound's document format with investigation evidence already
gathered, avoiding redundant research
- Stale fallback: when evidence is insufficient for a confident
replacement, mark as stale and recommend ce:compound later
- Use platform-agnostic interactive question tool phrasing with examples
for Claude Code and Codex instead of hardcoding AskUserQuestion
- Fix contradiction between Phase 2 auto-archive criteria and Phase 3
always-ask-before-archive rule so unambiguous archives proceed without
unnecessary user prompts
Adds a new skill that reviews existing docs/solutions/ learnings against the
current codebase and decides whether to keep, update, replace, or archive them.
Also enhances ce:compound with Phase 2.5 selective refresh checks.
Co-Authored-By: Claude <noreply@anthropic.com>
Name specific blocking question tools (AskUserQuestion, request_user_input,
ask_user) so agents actually invoke them instead of printing questions as
text output. Updates skill compliance checklist to match.
Add a highest-leverage-move question to the product pressure test,
a challenger option in approach exploration, and a low-cost change
check to the finalization checklist.
Prevents future agent resolution failures by requiring skills to use
compound-engineering:<category>:<agent-name> instead of short names.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Explains how to test local plugin changes across Claude Code (shell
alias with --plugin-dir) and Codex (local path install) without
disrupting production installs.
Rebased onto main after #251 restructured commands into skills/.
Applied the same namespace fix to the new skill file locations
(ce-brainstorm, ce-plan, ce-review SKILL.md files).
Short agent names like `repo-research-analyst` are replaced with
fully-qualified `compound-engineering:research:repo-research-analyst`
to ensure correct agent resolution across all plugin targets.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Deduplicate colon-separated command name logic across all 4 targets
(opencode, droid, gemini, qwen) into a single resolveCommandPath()
helper in utils/files.ts.
Addresses review feedback on PR #251.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Update CLAUDE.md, AGENTS.md, plugin CLAUDE.md, and versioning docs
to make clear that contributors should not hand-bump plugin versions
or cut changelog entries in normal PRs. The automated release process
decides the next version after choosing which merged changes ship
together.
Anthropic now maintains a better skill-creator at
github.com/anthropics/skills/tree/main/skills/skill-creator.
Removes the bundled skill-creator and updates component counts
from 47 to 46 skills.
The /technical_review command was removed in v2.32.0 but references
remained in ce:plan and deepen-plan menus. Remove them entirely -
the existing 'Review and refine' option (document-review) already
covers plan review.
Fixes#244
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
On Windows/NTFS, colons are reserved for alternate data streams, so
filenames like "ce:plan.md" are invalid. Split colon-separated command
names into nested directories (e.g. "ce:plan" -> "ce/plan.md"),
matching the approach already used by the Qwen target.
Applied to opencode, droid, and gemini targets.
Fixes#226
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Move all 27 command .md files from commands/ to skills/*/SKILL.md
format. Claude Code 2.1.3+ merged commands and skills - both create
slash commands and work identically. Skills add optional features
like supporting files and automatic context loading.
- commands/ce/*.md -> skills/ce-*/SKILL.md
- commands/workflows/*.md -> skills/workflows-*/SKILL.md
- commands/*.md -> skills/*/SKILL.md
- Update plugin.json and marketplace.json descriptions
- Update CLAUDE.md directory structure docs
- Update deploy-docs and generate_command references
Fixes#116
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The `create-agent-skills` SKILL.md contained literal `!`command`` dynamic
context injection directives as documentation examples. Claude Code's
preprocessor executes these directives as plain text before the skill
content is sent to the model — it does not parse markdown, so fenced code
blocks and inline code spans offer no protection.
When loading this skill, the preprocessor attempted to run `command`,
`gh pr diff`, and `gh pr diff --name-only` as shell commands, producing:
Bash command failed for pattern "!`command`":
(eval):1: redirection with no command
This caused the skill to fail silently or error on every invocation.
Fix: replace the literal directives with a prose description of the
syntax, add a warning about the preprocessor behavior, and link to
`references/official-spec.md` § "Dynamic Context Injection" for the
concrete example (reference files are loaded on-demand by Claude via the
Read tool and are not preprocessed).
Upstream context:
- anthropics/claude-code#27149 (closed, wontfix): preprocessor correctly
executes bare text; workaround is to describe the syntax in prose
- anthropics/claude-code#28024 (closed as duplicate of #13655)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Bump plugin to 2.39.0 with features from Matt Van Horn (@mvanhorn):
context budget precheck, plan sequence numbers, review serial mode,
agent-browser debugging commands, test-browser port detection, lfg
phase gating, and Context7 API key auth.
Also fixes MCP server merge order so plugin servers correctly
overwrite stale entries during sync.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>