acd-plan

Create agent-executable specifications with intent, behavior, constraints, and acceptance criteria.

1|Updated Jan 13, 2023
One-click install
npx skills add https://github.com/theodrosyimer/.dotfiles --skill acd-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acd-plan
Source: https://github.com/theodrosyimer/.dotfiles/tree/main/claude/skills/dev__acd-plan
Command: npx skills add https://github.com/theodrosyimer/.dotfiles --skill acd-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The ACD Plan skill helps teams turn vague ideas into clear, agent‑executable specifications, avoiding endless back‑and‑forth and ensuring a single, well‑defined slice of work can be implemented without clarification.

Core Features & Use Cases

  • Structured discovery loop: Guides the user through framing, deep‑dive questions, drafting, and stress‑testing.
  • Standardized specification format: Generates Intent, User‑Facing Behavior, Feature Description, and Acceptance Criteria sections.
  • Scope management: Detects when a request is too large and proposes thin vertical slices.
  • Use cases: Planning new features, breaking down tasks, or refining ambiguous requirements for rapid implementation.

Quick Start

Ask the acd‑plan skill to “plan a feature that adds a search filter to the structure view”.

Frequently Asked Questions about acd-plan

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

FAQPage Schema
How do I create agent-executable specifications from vague feature ideas?

Agent-executable specifications are created by guiding users through a structured discovery loop of high-signal questions to produce a self-contained spec with clear intent, behavior, and acceptance criteria.

What is the best way to break down large feature requests for implementation?

The best way to break down large feature requests is using scope management to detect oversized tasks and propose thin vertical slices, ensuring each unit of work can be implemented without further clarification.

How does the ACD discovery loop work for task planning?

The ACD discovery loop works by taking the user through sequential phases of framing, deep-dive questions, drafting, and stress-testing to refine ambiguous requirements into a standardized specification format.

What sections are included in a standardized ACD specification?

A standardized ACD specification includes Intent, User-Facing Behavior, Feature Description, and Acceptance Criteria sections to fully define a single unit of work for rapid implementation.

Do I need any specific frameworks or dependencies to generate task specifications?

No specific frameworks or dependencies are required to generate task specifications, as the skill operates independently using internal scripts and references to guide the planning process.