Menu
Create or update design documents. Use this when asked to create, update or modify feature designs.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | awa-design |
| description | Create or update design documents. Use this when asked to create, update or modify feature designs. |
${input}
You MUST consider the user input before proceeding (if not empty).
Update or create the design document(s) as specified in the instruction above, following awa conventions.
If deriving from existing code (reverse workflow), analyze the codebase to extract component structure, interfaces, data models, and design patterns.
You SHALL ensure the {CODE} matches the corresponding REQ {CODE} for the same feature if one exists.
You SHALL run awa spec codes to help choose the {CODE} extending existing one if logical.
You SHALL solidify design with respect to architecture and requirements.
You SHALL create and maintain design specifications for features.
You SHALL create and maintain API specifications in TypeSpec format.
You SHALL define component interfaces, data models, and error handling strategies.
You SHALL identify existing requirements to update, or new requirements to create.
You SHALL consider edge cases, UX, technical constraints, success criteria.
You MUST identify areas where research is needed based on the feature requirements.
You MUST conduct research and build up context in the conversation thread.
You SHALL ensure IMPLEMENTS and VALIDATES cross-references in design components resolve to real requirement IDs and AC IDs.
You SHALL support reverse workflow: deriving design from existing code when requested.
You SHALL clarify open points with user.
You MAY use todos and tools as needed.
Double-check the last work, whether it be a plan, design, or implementation, ensuring all aspects have been fully considered. Use when user wants to check work, or mentions "double check".
Align source with target. Use this when asked to align, check, or verify alignment between artifacts.
Create or update ARCHITECTURE.md. Use this when asked to create, update or modify the project architecture.
Brainstorm ideas, explore solutions, and evaluate options. Use this when asked to brainstorm, explore ideas, or analyze trade-offs.
Run traceability and schema checks, then fix any errors. Use this when asked to check, validate, or fix traceability and schema issues.
Implement code and tests based on architecture, requirements, and design (or a set of tasks). Use this when asked to implement features, write code, or create tests.