| name | amaa-design-lifecycle-ops |
| description | Use when applying judgment guidelines, success criteria, or handoff formats. Trigger with lifecycle ops request. Loaded by ai-maestro-architect-agent-main-agent |
| context | fork |
| user-invocable | false |
| agent | ai-maestro-architect-agent-main-agent |
Design Lifecycle Operations
Overview
Operational references for design lifecycle: judgment calls, success verification, workflow checklists, ADR templates, and handoff document format.
Prerequisites
- Familiarity with design lifecycle states (see amaa-design-lifecycle skill)
Instructions
- Use judgment guidelines to decide when to research APIs, create ADRs, modularize, or escalate
- Verify each phase completion against success criteria before proceeding
- Follow workflow checklists for requirements analysis, design, and handoff phases
- Use ADR templates for architectural decisions and handoff format for AMOA delivery
Checklist
Copy this checklist and track your progress:
Reference Documents
| Document | Content |
|---|
| judgment-guidelines.md | When to research external APIs instead of using existing documentation, When to create an ADR instead of just documenting the decision, When to modularize a system instead of keeping it simple, When to escalate unclear requirements to AMCOS for clarification |
| success-criteria.md | Overview, Requirements Captured, Architecture Designed, APIs Researched, Modules Specified, Handoff Prepared |
| workflow-checklists.md | Introduction, Checklist: Requirements Analysis, Checklist: Design Phase, Checklist: Handoff Preparation |
| adr-templates.md | Standard ADR Template, Context, Decision, Alternatives Considered, Rationale, Consequences, Related Decisions |
| handoff-format.md | Overview, Handoff Validation Checklist, Handoff Document Template, Executive Summary, Design Artifacts, Implementation Sequence, Risks and Mitigations |
Examples
Example: Use judgment-guidelines.md to decide whether to create ADR for database choice, then verify with success-criteria.md
Error Handling
| Issue | Fix |
|---|
| Success criteria not met | Review checklist, complete missing items before proceeding |
| ADR incomplete | Use template sections, ensure all fields populated |
Output
| Type | Description |
|---|
| ADR documents | docs_dev/design/adrs/ |
| Handoff documents | docs_dev/design/handoff-{uuid}.md |
Resources
See Reference Documents table above.