eaa-design-management

name	eaa-design-management
description	Use when managing design documents. Trigger with design search, validation, or creation requests.
version	1.0.0
license	Apache-2.0
compatibility	Requires Python 3.10 or higher. Requires AI Maestro installed.
metadata	{"author":"Emasoft"}
agent	eaa-main
context	fork
user-invocable	false
workflow-instruction	Step 7
procedure	proc-create-design

Design Document Management

Overview

This skill provides comprehensive tooling for managing design documents in the design/ directory hierarchy. It covers creating documents from templates, searching with structured queries, and validating frontmatter compliance.

Prerequisites

Before using this skill, ensure:

1. Python 3.10 or higher is installed
2. The design/ directory structure exists in the project root
3. Write access to the design document directories

Instructions

1. Read the UUID Specification reference to understand the GUUID format
2. Review the Document Types reference to select the appropriate document type for your needs
3. Use the Creating Documents reference to create new design documents with proper frontmatter
4. Use the Searching Documents reference to query and filter existing documents by metadata or content
5. Use the Validating Documents reference to ensure all documents meet frontmatter compliance requirements
6. Consult the Troubleshooting reference if you encounter errors or validation issues

Checklist

Copy this checklist and track your progress:

• Read UUID Specification reference (understand GUUID format)
• Review Document Types reference (select appropriate type: pdr, spec, feature, decision, architecture, template)
• Create design document using python scripts/eaa_design_create.py --type <type> --title "<title>"
• Verify document was created with proper UUID and frontmatter
• Search existing documents if needed: python scripts/eaa_design_search.py --type <type> --status <status>
• Validate all documents: python scripts/eaa_design_validate.py --all
• Fix any validation errors reported
• Consult Troubleshooting reference if errors persist

Output

Output Type	Description	Example
Created Document