decomposer: generate files for Create and commit a registry-ready single-agent repository that generates technical solution design documents and draw.io architecture diagrams from application requirements.

README.md

@@ -1,5 +1,19 @@
-# crucible-agent-create-commit-registry
+# application_landing_zone_agent
 
-> Create and commit a registry-ready single-agent repository that generates technical solution design documents and draw.io architecture diagrams from application requirements.
+A registry-ready transformation tool that converts application requirements into a technical solution design (TSD) document and an editable draw.io architecture diagram.
 
-A tool, not a standing agent service — see `input.schema.json`/`output.schema.json` for its contract. Generated by crucible-agent-decomposer for a plan gap step; language and structure are whatever the capability actually needs, not a fixed layout.
+## Usage
+
+```bash
+python -m application_landing_zone_agent requirements.json --output-dir ./artifacts
+```
+
+Requirements may be a JSON object or a plain-text file. JSON supports `name`, `summary`, `requirements`, `constraints`, `users`, `integrations`, `security`, `data`, `availability`, and `deployment` fields; unknown fields are preserved in the assumptions section.
+
+Outputs:
+
+- `technical-solution-design.md` — structured, reviewable TSD
+- `architecture.drawio` — editable draw.io XML with logical architecture, trust boundaries, and data flows
+- `manifest.json` — deterministic output metadata
+
+The tool is deterministic and has no network or cloud-provider dependency. Run tests with `pytest`.