decomposer: generate deliverable files for Inspect the single_agent template and target repository conventions to identify the required project structure, configuration, interfaces, and implementation patterns for the application landing zone agent.; Define the application landing zone agent's behavior, input and output contracts, document-generation workflow, and architecture-diagram requirements using the extracted template conventions.; Validate the implemented application_landing_zone_agent by running repository tests and checking the TSD document generation, draw.io diagram generation, agent packaging, configuration, and committed implementation against the defined contracts.; Commit and push the validated application_landing_zone_agent implementation to the target repository.
This commit is contained in:
@@ -1,21 +1,11 @@
|
||||
# Repository convention discovery (Step 0)
|
||||
# Repository conventions and discovery record
|
||||
|
||||
No template or target URL was supplied with the request, so this repository records the conventions used as the implementation baseline rather than claiming an external inspection. The baseline follows a conventional Python agent layout: `src/` package, `tests/` unittest suite, `config/` JSON configuration, `docs/` contract material, and a CLI entry point.
|
||||
## Discovery scope
|
||||
The requested template and target repository URLs were not supplied to the build request. This repository therefore uses the standard Python agent landing-zone convention: `src/` package layout, `pyproject.toml`, JSON configuration, a callable package API, CLI wrapper, tests, and human-readable docs.
|
||||
|
||||
## Required structure
|
||||
|
||||
- `src/application_landing_zone_agent/`: importable implementation and CLI.
|
||||
- `tests/`: unit and contract tests runnable with `python -m unittest discover -s tests`.
|
||||
- `config/default.json`: checked-in, dependency-free configuration.
|
||||
- `docs/agent-specification.md`: behavior, contracts, workflow, and validation.
|
||||
- `examples/`: human-reviewable input fixture.
|
||||
- `pyproject.toml`: package metadata and console script.
|
||||
|
||||
## Conventions extracted for this build
|
||||
|
||||
- Public behavior is exposed through a small class (`LandingZoneAgent`) and a CLI adapter.
|
||||
- Input/output boundaries are typed dataclasses and JSON/Markdown/XML files.
|
||||
- Generation is deterministic: stable IDs, ordering, and formatting make output reviewable in source control.
|
||||
- Validation happens before files are written and is also available as a public function.
|
||||
- Diagram output is native draw.io `mxfile` XML, not an image or proprietary binary.
|
||||
- Errors are actionable `ValidationError`/`GenerationError` exceptions; CLI maps them to a non-zero exit code.
|
||||
## Extracted conventions applied
|
||||
- Keep runtime code under `src/<package>` and tests under `tests`.
|
||||
- Expose a small programmatic interface and a CLI entry point.
|
||||
- Keep configuration declarative and secret-free.
|
||||
- Produce deterministic, reviewable artifacts in a caller-selected output directory.
|
||||
- Document contracts, assumptions, validation, and diagram editing expectations.
|
||||
|
||||
Reference in New Issue
Block a user