| name | apply-attribute-driven-design |
| description | WHEN/WHERE/WHO: [Scheduling: Software architects or lead developers designing a new feature or greenfield system.] HOW: [Structural: Use this SKILL to systematically execute the 7-step ADD 3.0 methodology to map drivers to design patterns.] WHY: [Scheduling: Ensures the architecture handles all constraints and quality attributes instead of just functional requirements.]
|
Apply Attribute-Driven Design (ADD 3.0)
Who
Software architects, technical leads, and developers responsible for translating requirements into a concrete system design. The agent uses this skill to facilitate structured design iterations.
What
This skill executes the Attribute-Driven Design (ADD) 3.0 methodology. It produces a documented architectural design by systematically selecting design concepts (patterns/tactics) to satisfy specific architectural drivers.
When
Invoke this skill after architectural drivers have been defined, and before code implementation begins. Trigger phrases include: "design the architecture," "use ADD 3.0," "create a system design," or "decide on the architecture patterns."
Where
Applies to technical design documents, ADRs (Architecture Decision Records), and architecture strategy wikis.
Why
Ad hoc architecture design often ignores non-functional requirements until it's too late. ADD 3.0 enforces a disciplined, iterative approach that guarantees quality attributes (like scalability and security) drive the core structural decisions.
Inputs
- Architectural Drivers (Use cases, Quality Attribute Scenarios, Constraints).
- Context diagram or system boundaries.
Output (Logical Evidence)
- Instantiated elements and allocated responsibilities.
- Sketches of architectural views (Logical, Deployment, etc.).
- Recorded design decisions.
Optimization Readiness
- Failure Signals: Design choices ignore the selected drivers, iterations become a one-pass architecture dump, or recorded decisions are not traceable back to measurable quality goals.
- Evidence To Collect: Prioritized drivers, allocation sketches, view drafts, ADR notes, and iteration reviews showing whether the selected drivers were satisfied.
- Safe Mutation Boundaries: Refine iteration prompts, design-allocation guidance, and documentation structure without changing the core driver-led, iterative ADD workflow.
- Acceptance Criteria: Accept revisions only if every design decision traces to an explicit driver and each iteration has a bounded goal, clear allocation, and recorded rationale.
- Rejected Revision Handling: Record preference-driven design choices, unbounded redesign loops, and driverless decisions so they are not repeated.
- Transfer Check: Verify the workflow still works for a single subsystem iteration and for larger architecture redesigns that require several passes.
- Stop Rule: If the architectural drivers are vague or absent, stop and ask before allocating responsibilities or choosing patterns.
Constraints (Logical Boundaries)
- Do not attempt to design the entire system in one pass; use iterations.
- Base design choices on the drivers, not just preference.
One More Thing
If the input architectural drivers are missing or vague, stop and ask the user to clarify them before proceeding with the design.
How (Structural Workflow)
Phase 1: Preparation
- Review Inputs: Ensure the architectural drivers are prioritized.
- Establish the Iteration Goal: Select a subset of drivers to focus on for this iteration.
Phase 2: Design and Allocation
- Choose Elements to Refine: Pick the system or sub-system to focus on.
- Choose Design Concepts: Select Reference Architectures, Deployment Patterns, or Tactics that satisfy the selected drivers.
- Instantiate and Allocate: Map the design concepts to concrete elements. Define their responsibilities and how they interface.
Phase 3: Documentation and Analysis
- Sketch Views & Record Decisions: Create preliminary diagrams and write ADRs for the choices made.
- Perform Analysis: Review the iteration. Did it meet the goal? If not, iterate again.
Resources
Validation
- Verify that every selected design concept traces back to a specific architectural driver.
- Ensure interfaces and responsibilities are clearly allocated.
- Confirm that the iteration goal was met before concluding the skill.
