acp.design-create

Command: design-create

🤖 Agent Directive: If you are reading this file, the command @acp.design-create has been invoked.

This is a CREATION command - you will create files directly, no shell scripts needed.

Follow the steps below to create a design document with proper namespace and automatic package updates.

Namespace: acp Version: 1.0.0 Created: 2026-02-21 Last Updated: 2026-02-21 Status: Active Scripts: None

---

Purpose: Create design documents with namespace enforcement, draft support, and automatic package updates Category: Creation Frequency: As Needed

---

What This Command Does

This command creates a new design document with intelligent namespace handling, optional draft file support, and automatic updates to package.yaml and README.md. It provides a guided workflow for creating well-structured design documents that follow ACP conventions.

Key Features:

• Context-aware (detects if in package vs project)
• Automatic namespace enforcement
• Draft file support with clarification workflow
• Auto-updates package.yaml and README.md
• Uses design.template.md as base

Use this when: Creating a new design document in an ACP project or package.

---

Prerequisites

• ACP installed in current directory
• Design template exists (agent/design/design.template.md)
• (Optional) Draft file prepared if using draft workflow

---

Arguments

Context Capture Arguments (optional — passed to @acp.clarification-capture directive):

Argument	Alias	Behavior
--from-clarification <file>	--from-clar	Capture decisions from a specific clarification file
--from-clarifications	--from-clars	Capture from all recent clarifications
--from-chat-context	--from-chat	Capture decisions from chat conversation
--from-context	(none)	Shorthand for all sources (clarifications + chat)
--include-clarifications	(none)	Alias for --from-clars