Jon Chery
727c87339b
---ci---
project: acdl
phase: 8
milestone: v1.1
status: plan-as-execute
persona: lead-developer
task: T-8.0
type: prerequisite-fix
---/ci---
The Phase 07 P1 ('platform/ package shadows stdlib platform module')
became a Phase 08 blocker: boto3 imports uuid -> platform.system(),
which fails when the repo's platform/ package is on sys.path[0]. Renamed
platform/ -> acdl_platform/ (the verifier's recommended v1.2 fix, pulled
forward because Phase 08 needs boto3).
- git mv platform/ acdl_platform/ (history preserved)
- verify_phase07.sh: updated paths; removed the /tmp workaround (no
longer needed; the shadow is gone)
- verify_phase06.sh: updated the new-dirs check for the rename
- README.md: layout table updated
Both verify_phase06.sh and verify_phase07.sh still pass; confidence_signal
now imports + runs correctly from the repo root. boto3 imports clean.
52 lines
2.7 KiB
Markdown
52 lines
2.7 KiB
Markdown
# ACDL — Agentic Cloud Delivery Platform
|
||
|
||
Consumers declare intent; the platform delivers safe production deployment
|
||
through an agentic stack — automatically, safely, and with a complete audit
|
||
trail. A merged change progresses through lower environments end-to-end
|
||
without a platform engineer joining a thread; a non-technical consumer ships
|
||
a production deployment by declaring intent, without authoring a workflow,
|
||
a configuration file, or a Terraform module.
|
||
|
||
- **Vision** (the why): [`docs/vision.md`](docs/vision.md)
|
||
- **Architecture** (the how): [`docs/architecture.md`](docs/architecture.md)
|
||
- **Decisions**: [`.ciagent/PROJECT.md`](.ciagent/PROJECT.md)
|
||
- **Target architecture**: [`.ciagent/ARCHITECTURE.md`](.ciagent/ARCHITECTURE.md)
|
||
- **Phase plan**: [`.ciagent/ROADMAP.md`](.ciagent/ROADMAP.md)
|
||
|
||
## Status
|
||
|
||
- **v1.1 (active):** architecture finalization + v1 spike. Finalize the
|
||
architecture to v1.0 (resolve the 11 open design decisions) and prove the
|
||
locked commitments with one end-to-end implementation spike
|
||
(`l1-s3` + `l2-static-asset` + Terraform adapter → real `terraform plan`
|
||
against AWS).
|
||
- **v1.0 demo (complete, archived):** tag `v1.1.0`. The 30-minute
|
||
stub-driven executive demo is preserved under `demo/` as the intent
|
||
reference; it is not the platform.
|
||
|
||
## Repository layout
|
||
|
||
| Path | Purpose | Populated |
|
||
|------|---------|-----------|
|
||
| `acdl_platform/` | Platform code: confidence signal, contract resolver, outbox, HITL/ledger designs (renamed from `platform/` in Phase 08 to avoid shadowing the stdlib `platform` module) | Phase 07+ |
|
||
| `schemas/` | JSON Schemas: IR, PolicyCheckResult, contract | Phase 07 |
|
||
| `adapters/` | Substrate adapters (Terraform adapter in v1; the only substrate-specific code per §12) | Phase 09 |
|
||
| `terraform/` | State backend + provider config (S3 state + DynamoDB lock) | Phase 08+ |
|
||
| `modules-ir/` | IR-typed L1/L2 modules (`l1-s3`, `l2-static-asset`) | Phase 09–10 |
|
||
| `scripts/` | v1.1 verify scripts (`verify_phaseNN.sh`) | Phase 06+ |
|
||
| `demo/` | Archived v1.0 executive demo (tag `v1.1.0`); runs locally via `demo/scripts/run_demo.sh --no-upload` | complete |
|
||
| `.ciagent/` | CIAgent metadata (plans, decisions, personas, roadmap, research) | active |
|
||
| `docs/` | Upstream vision + architecture sources | active |
|
||
|
||
## Running the archived demo
|
||
|
||
The v1.0 demo is an archived artifact. To re-run it locally:
|
||
|
||
```bash
|
||
bash demo/scripts/run_demo.sh --no-upload
|
||
```
|
||
|
||
The demo deck is at [`demo/ACDL_DEMO.md`](demo/ACDL_DEMO.md). The demo runs
|
||
entirely on local stubs — no AWS, no AI — and shows intent and safety
|
||
behavior rather than provisioning real cloud resources. It is the reference
|
||
of intent for the real platform; it is not the platform itself. |