plan

Generates structured implementation plans with spec traceability, clarification funnels, and QA gate persistence.

Updated May 31, 2026
One-click install
npx skills add https://github.com/AlexanderNarbaev/agi --skill plan-alexandernarbaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/AlexanderNarbaev/agi/tree/main/.opencode/skills/plan
Command: npx skills add https://github.com/AlexanderNarbaev/agi --skill plan-alexandernarbaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature request or spec into an executable, reviewable implementation plan is error-prone: requirements get missed, tasks are oversized, and quality gates are configured inconsistently. This Skill enforces a disciplined planning protocol that produces traceable, right-sized plans with persisted QA configuration. ## Core Features & Use Cases - Spec-gated planning with traceability: Checks for .swarm/spec.md, detects stale specs, and verifies every FR-### maps to at least one task while flagging gold-plating tasks with no requirement source. - Four-stage clarification funnel: Inventories uncertainties, classifies them (self-resolved, critic-resolved, research-needed, user-decision), consults a critic sounding board, and surfaces a structured decision packet before saving the plan. - Task granularity and phase rules: Enforces small/medium/large sizing, splits oversized tasks, deduplicates redundant test tasks, and mandates multi-phase structure for larger plans. - QA gate and execution profile persistence: Collects user choices for eleven QA gates, parallel coder count, and commit policy, then persists them via set_qa_gates and a lockable execution_profile in save_plan. - Use Case: A user pastes an external plan and asks to prepare it for implementation. The Skill offers spec generation or direct ingestion, runs the clarification funnel, saves a phased plan, collects QA gate selections, and hands off to critic review before execution. ## Quick Start Ask the agent to create an implementation plan for your feature, for example: plan the user authentication feature from my spec and configure the QA gates.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I create an implementation plan from a spec file?

Place your spec at .swarm/spec.md and invoke planning mode. The protocol reads the spec, cross-references every FR-### requirement into tasks, runs a clarification funnel for open decisions, and saves a phased plan via the save_plan tool.

How do I import an external plan for implementation?

Paste the external plan with phrases like "ingest this plan" or "implement this plan". The protocol detects plan ingestion and offers to either reverse-engineer a spec from it first or proceed directly to planning without a spec.

What QA gates can be configured before execution?

Eleven gates are available: reviewer, test_engineer, sme_enabled, critic_pre_plan, sast_enabled, council_mode, hallucination_guard, mutation_test, phase_council, drift_check, and final_council. The user selects them in one exchange and they are persisted via set_qa_gates before any task dispatches.

Can tasks run in parallel during plan execution?

Yes, by setting an execution_profile in save_plan with parallelization_enabled and max_concurrent_tasks between 1 and 64. Locking the profile before the first task makes it immutable, and a locked serial profile blocks parallel dispatch even if global config enables it.

Why does the planner refuse to create separate test tasks?

The QA gate already runs test_engineer verification on every implementation task, so standalone test tasks duplicate effort and waste budget. Dedicated test tasks are only created for pure test infrastructure, cross-module integration tests, or explicit coverage requests.

What happens if the critic rejects the plan?

On NEEDS_REVISION the architect revises and resubmits the plan, with a maximum of two review cycles. If the critic still rejects after two cycles, the issue is escalated to the user with a full explanation before any execution begins.