dotagent

Audit dotagent docs for drift after ANY code/behavior change — new plugin, renamed field, moved file, changed default, new env var, new command, new event type, schema bump, path change. Always invoke before reporting a task as "done" if the change is user-visible. Returns a punch list of doc files that need updating with the specific lines/sections that are now stale, plus any links pointing to moved/renamed files. Never silently passes — when in doubt, flag.

Add a new subcommand to the `dotagent` CLI. Use when the user asks to "add a command", "expose X as CLI", "create dotagent subcommand", or any extension to the CLI surface. Handles clap enum entry + commands/ implementation + help text consistency.

Scaffold a new dotagent plugin (notify/preflight/sink). Use when the user asks to "add a plugin", "create a plugin for X", "support Pushover/Discord/Telegram/etc", or any new external integration. The skill produces a complete plugin crate that obeys the info/validate/invoke protocol and registers it in the workspace.

Migrate an agent from the Fish-based `lib/agent.fish` framework (in avelino/dotfiles) to dotagent. Use when the user says "porta X pro dotagent", "migra Y", "transforma meta.json em agent.toml". Produces a working agent.toml that points at the existing agent.fish without rewriting it.

Cut a new release of dotagent. Use when the user says "release X.Y.Z", "tag a release", "publish to crates.io". Handles version bump in workspace.package.version, CHANGELOG, git tag, and the cargo publish order across the workspace dependency graph.

Run the full validation pipeline for dotagent (fmt, clippy with -D warnings, workspace tests, and end-to-end smoke test). Use before claiming a change is "done", before opening a PR, or when CI fails and the user wants to reproduce locally. Reports each step and stops at the first failure.