1.5 KiB
Application landing zone agent specification
Name: application_landing_zone_agent
Purpose: Transform application requirements into a reviewable Technical Solution Design and an editable draw.io architecture diagram.
Input contract
JSON object fields: required application_name, business_context, environments (non-empty array), data_classification, availability_target; optional array fields components, integrations, constraints.
Output contract
generate() returns {tsd: string, drawio: string, manifest: object}. The CLI writes tsd.md, architecture.drawio, and manifest.json.
Workflow
- Parse and validate the requirements.
- Apply safe baseline assumptions and identify unresolved decisions.
- Generate TSD sections for context, scope, architecture, environments, security, resilience, operations, constraints, and acceptance criteria.
- Generate an XML draw.io file with users, application boundary, components, and orthogonal relationships.
- Validate artifact structure and return the manifest.
Diagram requirements
The diagram must be importable by draw.io, use an <mxfile> root and <mxGraphModel>, include vertex cells for the users, application, and components, and include relationships. It must remain editable XML rather than an image.
Validation and errors
Missing required fields, malformed types, and empty environments raise ValueError with actionable field names. A diagram contract failure raises RuntimeError. No credentials are inferred or emitted.