worca-cc

File a new feature for worca-cc — triage size/complexity, then either create a lightweight GitHub feature request (no W-NNN, no plan file) or a full W-NNN plan (allocate the next plan ID, scaffold docs/plans/W-NNN-slug.md from _TEMPLATE.md, create the GitHub issue with the correct title/structure/labels, and link the plan file). Always asks which path unless the user gave an explicit instruction. Triggers on "new plan", "create plan", "start plan", "new feature plan", "feature request", "worca-plan-new", or any request to file a new feature for this repo.

Sign and POST a synthetic worca event to a configured webhook URL — verifies HMAC signing, network reachability, response handling, and (for control webhooks) the control-action response shape. Useful when adding or tuning a webhook subscriber without running a full pipeline. Triggers on "test webhook", "webhook test", "send test event", "worca-webhook-test", or any request to validate a webhook configuration.

Guided pipeline-template authoring, export, and import — interviews the user for intent, proposes reusing or extending existing templates, composes a minimal config delta, and writes it via CLI. Also exports template bundles (with secret redaction) and imports bundles from files, URLs, or gists. Triggers on "new template", "create pipeline template", "create template", "customize my pipeline", "export template", "import template", "share template", "bundle", "worca-template".

Wire a worca-ui surface to its docs.worca.dev page via the W-061 help-mode toggle — natural-language invocation ("add a docs link for the Pricing tab"). The skill locates the surface in worca-ui/app/views/, searches docs-site/src/content/docs/ for a matching page, picks or extends the HELP_LINKS registry entry, drops a `${helpFor('<id>')}` at the right anchor, updates the mapping table in worca-ui/docs/help-mode-prototype.md, and runs the L1 vitest to verify. If no matching doc page exists, proposes scaffolding a stub or escalating to a docs-authoring skill rather than wiring a 404 link. Triggers on "docs help", "add docs link", "wire help badge", "help-link this surface", "/worca-docs-help".

Author a new chapter for the docs-site video series at docs.worca.dev/introduction/watch. Drafts narration in the established short-sentence style, scaffolds a cue-driven Remotion diagram, registers it in src/lib/script.ts + diagrams/registry.ts, and optionally runs the full build pipeline (voiceover → captions → render → posters → publish). Triggers on "new video", "add a video", "new docs video", "create a video chapter", "worca-docs-video", or any request to add a video chapter to the worca docs site.

Analyze a GitHub issue, surface open design decisions with a recommended option for each, optionally append a `## Decisions` section to the issue body, recommend the most appropriate built-in/project/user pipeline template, and optionally launch a worktree-based pipeline for it. Triggers on `/worca-analyze <issue-url-or-number>`, on the natural phrase "analyze <github-issue-url>", and on "worca-analyze".

Send a chat notification through the worca-ui server's integrations subsystem (Telegram, Discord, Slack) using each platform's adapter — proper rendering (HTML / Markdown / mrkdwn), allowlist enforcement, rate limiting, and no raw API calls. Use when the user wants an out-of-band notification rather than a synchronous response. Triggers on `/worca-notify`, "notify me when X", "ping me when X", "send a chat message", "send a notification", "alert me via <platform>", or any phrase that names a chat platform ("via Telegram", "on Slack", "in Discord"). Does NOT fire on bare "tell me when…" or "let me know when…" — those are conversational and the user typically wants a sync answer.

Create a stable release for worca-cc (Python), @worca/ui (npm), or both. Bumps the version (micro or minor), commits, tags, and pushes — CI handles publishing and GitHub Release creation. Also promotes the docs site by fast-forwarding docs-live so docs.worca.dev matches the release. Triggers on "stable release", "cut a release", "release", "worca-release", or any request to create a non-RC release.

Author a diagram on the worca docs site (docs.worca.dev) in the canonical animated-SVG style — nodes + directional edges + hover tooltips, blue forward / amber return, light+dark, reduced-motion. Wraps the shared `docs-site/src/components/FlowDiagram.astro` so every diagram (pipeline, state graph, DAG) stays visually consistent. Triggers on "add a diagram", "stage graph", "state diagram", "flow diagram", "worca-docs-diagram", or any request to add/edit a diagram on the docs site.

Run the worca-cc pre-commit gauntlet — ruff, biome, vitest, conditional playwright, npm pack file-allowlist check, and a docs-site build. Picks the right subset based on what the current branch changed vs base. Triggers on "precommit", "pre-commit check", "before commit", "verify before commit", "worca-dev-precommit", or any request to validate changes before committing in this repo.

Publish the worca docs site by fast-forwarding docs-live to master (git push origin master:docs-live) so docs.worca.dev updates without cutting a version release. Builds docs-site locally first to catch breakage, shows which doc commits will go live, and confirms before pushing. Triggers on "publish docs", "publish documentation", "promote docs", "push docs live", "docs-publish", "worca-docs-publish", or any request to publish the docs site between releases.

Scaffold a new worca event type across every required file — `src/worca/events/types.py` constant + payload builder, `tests/test_event_types.py` coverage, and (for chat-notifiable events) a renderer entry in `worca-ui/server/integrations/renderers.js`. Adding an event manually touches 3-4 files and missing the renderer means the event fires but never reaches chat. Triggers on "new event", "add event", "add webhook event", "event type", "worca-event-add", or any request to add a new pipeline/fleet/workspace event.

Scaffold a new worca-ui card view following the `.run-card` layout pattern documented in `worca-ui/docs/card-layout.md` — top/meta/(stages)/actions, status pip via `statusIcon`, central variant map, no inline badge variants. Triggers on "new card", "add card", "card view", "worca-ui-add-card", or any request to add a new card-style view to worca-ui.

Scaffold a new worca-ui section (page) across every required wire-up point — view file, route handler, header title, sidebar entry, and WS/fetch hooks. Triggers on "new page", "new section", "add ui page", "add ui section", "worca-ui-add-page", or any request to add a new top-level UI section to worca-ui.

Run worca-cc Python coverage via `scripts/coverage.py` — supports `ci` one-shot, separate run/combine/report steps, baseline comparison, and the `--include-unit-tests` mode. Triggers on "coverage", "code coverage", "coverage report", "compare coverage", "worca-coverage", or any request to measure or compare Python coverage for this repo.

Read, list, or create GitHub issues for worca-cc using the correct `gh ... --json` invocation (works around classic-Projects deprecation), the W-NNN-vs-bug title convention, and the required label set. Triggers on "issue", "gh issue", "read issue", "list issues", "create bug", "worca-issue", or any request to view or file issues for this repo.

Pre-merge gate for a worca-cc PR — verifies branch is rebased on master, CI is green, no merge conflicts, then merges via `gh pr merge --merge` (never local merge). Triggers on "merge pr", "prepare to merge", "ready to merge", "pr ready", "worca-pr-prep", or any request to land a PR for this repo.

Load the pipeline state-action matrix specification before developing changes to states, actions, transitions, status rendering, or action gating. Triggers on "state matrix", "action matrix", "pipeline states", "pipeline actions", "state transitions", "actionAllowed", "state-actions", "pipeline_status", "stop_reason", or any work involving pipeline lifecycle state changes.

Sync a GitHub PR into a target worca-cc repo clone, rebuild worca-ui, upgrade the runtime, and start a project-scoped UI.

Sync a specific git commit or branch into a target worca-cc repo clone, rebuild worca-ui, upgrade the runtime, and start a project-scoped UI.

Install the worca autonomous pipeline into a project. Triggers on "install worca", "setup worca", "add worca", "create a pipeline", "set up autonomous development", "use worca-cc", "worca for my project", "let's create a pipeline", "run pipeline on my project", or any request to use worca to automate development on a target project. Requires a target project path (e.g. /worca-install /path/to/project).

Sync worca pipeline files from the worca-cc source repo to a target project. Use when updating a project with the latest worca pipeline files, or when the user says "sync worca", "update worca", or "copy worca files". Accepts an optional path argument to specify the worca-cc repo location.

Create or update agent prompt overrides for worca pipeline agents. Use when the user wants to customize agent behavior per-project, add project-specific rules, replace agent sections, or modify how planner/coordinator/implementer/tester/guardian agents work. Triggers on "override agent", "customize agent", "agent override", "change implementer rules", etc.

Cut a release candidate for both worca-cc (Python) and @worca/ui (npm). Triggers on "release candidate", "cut an RC", "bump RC", "new RC", "worca-rc", or any request to create a release candidate. No arguments required — versions are auto-detected and incremented.