/SKILL.md
# agvv ## 1) Role Boundary `agvv` is deterministic orchestration infrastructure, not a coding-quality judge. It is responsible for: - task/run state files under `.agvv/` - daemon-driven auto runs - worktree/process lifecycle - Git-backed completion checkpoints The orchestrator agent is responsible for planning, retry policy, and merge decisions. ## 2) Authoritative CLI Surface Top-level commands: - `agvv daemon` - `agvv projects` - `agvv tasks` - `agvv feedback` Not available as top-lev
npx skillsauth add niuyunda/agent-wave agent-waveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
agvv is deterministic orchestration infrastructure, not a coding-quality judge.
It is responsible for:
.agvv/The orchestrator agent is responsible for planning, retry policy, and merge decisions.
Top-level commands:
agvv daemonagvv projectsagvv tasksagvv feedbackNot available as top-level commands:
runssessionscheckpointsstatusUse projects and tasks for state inspection.
Projects:
agvv projectsagvv projects listagvv projects show <repo_path>agvv projects remove <repo_path>Tasks:
agvv tasks [--project <repo_path>]agvv tasks list [--project <repo_path>]agvv tasks show <task_name> [--project <repo_path>]agvv tasks add --project <repo_path> --file <task_md> [--create-project] [--agent <name>]agvv tasks merge <task_name> [--project <repo_path>]Daemon:
agvv daemon startagvv daemon statusagvv daemon stopFeedback:
agvv feedback --title <text> [--body <text>] [--type bug|feature|refactor] [--issue]tasks add Side Effectstasks add does all of the following:
.agvv/config.json, hooks directory, task/archive folders)~/.agvv/projects.jsonruns/ directoryauto_manage: trueAGVV_SKIP_DAEMON_AUTOSTART is truthyAgent selection for daemon auto-runs:
task.md field agent (or --agent override)default_agentclaudeRequired task.md front matter:
nameValidation rules:
name must match [A-Za-z0-9._-]+status is rejectedAll extra front matter keys are preserved.
base_commit.review runs must also write a non-empty report file at report_path.agent_runner after a zero exit code.done.pending.blocked.agvv tasks add --project /repo/app --file /tmp/fix-login.md --agent codex
agvv projects show /repo/app
agvv tasks show fix-login --project /repo/app
agvv tasks merge fix-login --project /repo/app
Run discipline:
tasks show before mergefailed or blocked--project when task name might not be globally uniqueWhen behavior is incorrect, file reproducible evidence in:
docs/issues/docs/issues/ISSUE_TEMPLATE.mdtools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.