ava-workflow

Coordinates agents, humans, and reality through calibration, alignment, planning, and continuous evaluation phases.

1|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill ava-workflow-zhiyuan-zhang0206
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ava-workflow
Source: https://github.com/zhiyuan-zhang0206/Ava/tree/main/ava_builtins/skills/ava-workflow
Command: npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill ava-workflow-zhiyuan-zhang0206

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial tasks fail when agents act on vague goals, wrong assumptions about the system, or missing review. This Skill structures work into three phases — Calibrate, Align, Plan — with evaluation woven through every step, so large or ambiguous tasks stay grounded in reality and verified before delivery. ## Core Features & Use Cases - Calibrate: Sync agent and human mental models with a codebase, system, or domain through an interactive exploration loop that tracks drift and produces a calibration record. - Align: Grill the user with decision-tree question rounds, each carrying a recommended answer, until an alignment document with concrete success criteria is confirmed. - Plan: Decompose large or parallel work into an executable task graph with dependencies, checkpoints, risks, and capability matching. - Work & Evaluate: Execute step by step with adversarial self-challenge, routing failures back to the owning phase, and gating large tasks behind an independent adversarial review by a fresh agent. - Use Case: A user asks to migrate a production service. The agent calibrates the current architecture, aligns on success criteria and constraints, plans the parallel migration steps, executes with continuous self-verification, and spawns an independent reviewer before delivery. ## Quick Start Use the ava-workflow skill to align on the goal, plan the steps, and execute this task with continuous evaluation and an independent review before delivery.

Frequently Asked Questions about ava-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a large AI agent task with multiple phases?▼

Use the three-phase workflow: Calibrate to sync mental models with reality, Align to pin down goals and success criteria through questioning, and Plan to decompose large or parallel work into an executable task graph. Evaluation runs through every phase rather than as a final step.

When should an AI agent skip the planning phase?▼

Skip planning when the task is small and serial with a clear goal and acceptance criteria from alignment. Plan only earns its place for very large multi-session work or when parallel execution across agents requires a decomposition contract.

How does independent adversarial review work for agent tasks?▼

Spawn a fresh agent with no shared context, briefed with the alignment document, plan, and artifact locations. It reports a verdict with severity-ranked P0/P1/P2 findings and evidence; fix or rebut each finding and re-review until the verdict is clean.

What is the difference between self-challenge and independent review?▼

Self-challenge is a cheap per-step loop where the executing agent questions its own work, but it is structurally biased by the author's context. Independent review uses a fresh agent with no shared context and is mandatory for large, parallel, high-stakes, or unsupervised tasks.

When should I run the calibrate phase before aligning?▼

Run Calibrate when the user's statements about the subject are vague, hedged, or contradicted by what you find in the environment. Skip it when the user names specific files or behaviors correctly, and calibrate per-slice rather than per-task.