plan-spec-acceptance

Generate engineering plans with scope, architecture, risks, and acceptance criteria.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/JuanTaco4You/codex-agent-skills --skill plan-spec-acceptance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-spec-acceptance
Source: https://github.com/JuanTaco4You/codex-agent-skills/tree/main/plan-spec-acceptance
Command: npx skills add https://github.com/JuanTaco4You/codex-agent-skills --skill plan-spec-acceptance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to generate a concrete, engineer-grade plan with defined scope, architecture, risks, and acceptance criteria, eliminating guesswork and alignment issues.

Core Features & Use Cases

  • Comprehensive planning: Restates the problem, collects requirements, assesses current state, and outlines a phased design and implementation strategy.
  • Structured outputs: Produces a document with sections for design, risks, tests, and acceptance criteria that developers can follow.
  • Use Case: When starting a new feature, generate an end-to-end plan that a team can execute, including success metrics and acceptance criteria.

Quick Start

Use the plan-spec-acceptance skill to generate a phased implementation plan for a new authentication module.

Frequently Asked Questions about plan-spec-acceptance

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

FAQPage Schema
How do I create a project plan with clear acceptance criteria and risk management?

To create a project plan with acceptance criteria, restate the problem, gather requirements, assess the current state, and outline a phased design with specific tests and risk mitigation strategies. This approach yields an engineer-grade document developers can follow.

What is an engineering-grade project plan and when do I need one?

An engineering-grade project plan is a structured document defining scope, architecture, risks, and acceptance criteria. You need one for projects requiring formal upfront planning to eliminate guesswork and ensure team alignment before implementation begins.

How do I structure a phased implementation plan for a new software feature?

Structure a phased implementation plan by defining sections for requirements, current state reconnaissance, proposed design, phased execution steps, tests, risks, and acceptance criteria to guide the engineering team through the delivery lifecycle.

Can I use this approach to plan architecture and scope for complex engineering projects?

Yes, this planning approach is designed for complex engineering projects requiring formal upfront design. It generates a comprehensive document covering problem restatement, architecture design, implementation phases, and success metrics for team execution.

What should be included in engineering requirements and design documents?

Engineering requirements and design documents should include a problem restatement, current-state reconnaissance, proposed architecture, a phased implementation strategy, testing protocols, risk assessments, and clear acceptance criteria to ensure measurable success.

Why does my software project plan lack clear milestones and acceptance criteria?

Your software project plan lacks clear milestones because it omits formal upfront planning steps like problem restatement, current-state reconnaissance, and phased design, which are required to define concrete acceptance criteria and risk management strategies.