|
|
@@ -24,9 +24,11 @@ From Python async patterns to Rust ownership models, from AWS Fargate deployment
|
|
|
|
|
|
**v3.0.0** (June 2026)
|
|
|
- **Skills-first restructure** - *Breaking:* the expert-agent layer was cut from 23 to 3. Per Anthropic's guidance, knowledge belongs in skills (progressive disclosure, single source of truth) and subagents are reserved for context isolation — so *all* domain-knowledge agents became `-ops` skills (the 11 language/framework experts → their twins; cypress/cloudflare/bash/craftcms/payloadcms/asus-router → new skills; claude-architect/aws-fargate folded into existing skills). The 3 remaining agents are pure isolation/worker roles: `git-agent` (background commits/PRs), `firecrawl-expert` (noisy multi-page scrapes), `project-organizer` (bulk restructure). Dispatching skills now route `general-purpose` agents that preload skill references.
|
|
|
-- **`claude-code-ops` skill** - claude-code-debug/-headless/-hooks merged and rebuilt from current official docs: the 30-event hook catalog with per-event JSON contracts, today's SKILL.md frontmatter spec, headless/CLI reference, and extension-debugging decision trees.
|
|
|
-- **Three new skills, doc-verified** - `claude-api-ops` (Messages API, tool use, prompt caching, structured outputs, Agent SDK), `playwright-ops` (selector hierarchy, fixtures, CI sharding, flake hunting), `terraform-ops` (state, modules, OIDC plan/apply, secrets).
|
|
|
-- **Media stack** - `ffmpeg-ops` (probe-first ffmpeg/ffprobe: ~30-command cookbook, EDL-driven editing, `.cube` LUT grading, VMAF gates, loudnorm, Whisper prep) and `ytdlp-ops` (the yt-dlp acquisition layer feeding it: format doctrine, clip-at-download, incremental channel syncs), each shipping a §7 staleness verifier.
|
|
|
+- **`claude-code-ops` skill** - the machinery of Claude Code itself in one skill: the complete 30-event hook catalog with per-event stdin/stdout JSON contracts and all five hook types; the current `SKILL.md` frontmatter spec (`when_to_use`, `context: fork`, skill-scoped hooks); a headless/CLI reference (`claude -p`, `stream-json`, structured output, background agents); and extension-debugging decision trees. Merges and rebuilds the old claude-code-debug/-headless/-hooks skills against the live June-2026 docs - the stale `$TOOL_INPUT` hook contract is gone (stdin JSON is current), with claude-architect's extension-architecture guidance folded in.
|
|
|
+- **`claude-api-ops` skill** - building applications *on* Claude: the Messages API, tool-use loops, prompt caching, structured outputs (`output_config.format`), the Batches API, extended/adaptive thinking, a current model-selection + pricing table, and the Claude Agent SDK (Python + TypeScript). Carries a cost-optimization checklist and a `check-model-table.py` verifier that flags model/pricing drift against the live API.
|
|
|
+- **`playwright-ops` skill** - end-to-end testing done right: the role-first selector hierarchy and web-first assertions (no manual waits), fixtures / Page-Object patterns, network mocking and HAR replay, `storageState` auth, sharding and parallelism, visual regression, and a flake-hunting playbook with a `triage-flakes.py` ranker. Ships a production `playwright.config.ts` template.
|
|
|
+- **`terraform-ops` skill** - Terraform/OpenTofu infrastructure-as-code: directory-per-environment layout, remote-state management (`moved`/`import`/`removed`, drift detection, state-surgery discipline), module composition, write-only secrets, and native `terraform test`. Ships an OIDC plan-on-PR / apply-on-merge GitHub Actions workflow template and a `check-action-refs.sh` verifier (the check that would have caught the `trivy-action` tag bug).
|
|
|
+- **Media stack** - two paired skills covering the acquire→process pipeline. `ffmpeg-ops`: probe-first ffmpeg/ffprobe with a ~30-command cookbook and footgun table, EDL-driven editing, `.cube`/Hald-CLUT colour grading (a ~40-recipe look catalog), VMAF/SSIM quality gates, two-pass loudnorm, hardware-encoder proofing, and Whisper/STT prep. `ytdlp-ops`: the yt-dlp acquisition layer feeding it - format-selection doctrine, clip-at-download, incremental channel syncs, and a failure-triage ladder. Each ships a §7 staleness verifier.
|
|
|
- **Live security guards, zero hand-wiring** - `config-change-guard.sh` scans Claude settings files for worm-persistence IOCs the moment they're edited; `worktree-guard.sh` mechanically enforces worktree boundaries. Plugin-level `hooks/hooks.json` auto-wires the security set on install.
|
|
|
- **Skill Resource Protocol** - one build standard for skill scripts and assets ([docs/SKILL-RESOURCE-PROTOCOL.md](docs/SKILL-RESOURCE-PROTOCOL.md)), headlined by the staleness-verifier pattern: offline checks gate PR CI, live drift checks run weekly without ever blocking a PR. Four verifiers ship with it.
|
|
|
- **fleet-ops v2** - repositioned as landing discipline (sequential queue, test-gated merge, pre-land scrub, one-shot revert, new `fleet track`) on top of native agent teams and background agents, which now own session spawning.
|