Files
acdl/README.md
T
Jon Chery 9228d90cc5 feat(P01): repo layout, .gitignore, README (T-1.1)
---ci---
phase: 1
milestone: v1.0
status: execute
persona: lead-developer
task: T-1.1
requirements:
  covered: [REQ-01]
---/ci---

Wave 1, task T-1.1. Creates the directory skeleton (scripts/, modules/l1/,
modules/l2/, .gitea/workflows/, contracts-repo/.gitea/workflows/), the
.gitignore (audit.json, state.json, __pycache__, .env), and a top-level
README summarizing the 4-act demo + Phase 01 verification command.
2026-07-21 13:00:04 +00:00

55 lines
2.2 KiB
Markdown

# ACDL — Agentic Cloud Delivery Platform
A 30-minute executive demo proving that infrastructure can be delivered
**automatically, safely, and with a complete audit trail** — without the
usual weeks of manual tickets, reviews, and copy-pasted configuration.
The demo runs entirely on **local stubs** (no AWS/GCP/Azure, no external LLM
APIs). It shows intent and safety behavior rather than provisioning real
cloud resources.
## Four acts
1. **Act 1 — The Friction:** the old manual 2-week deployment process.
2. **Act 2 — Developer Self-Service:** commit a valid `contract.yaml` for
`l2-commodity-price-feed`, watch Dev auto-run, QA + Prod approval gates,
then the evidence timeline.
3. **Act 3 — Citizen Developer:** open a GitHub/Gitea Issue with natural-
language intent; the Python keyword parser generates the same
`contract.yaml` and triggers the identical pipeline.
4. **Act 4 — The Safety Net:** commit a malicious `contract.yaml`
(`public-ingress: true`) for `l2-regulatory-reporting`; the pipeline
halts in Dev because the confidence signal drops below 0.50, and the
rejection is visible on the evidence stream.
## Repositories
All under the `continuous-intelligence` Gitea org at
`https://git.cloudinit.dev`:
- `acdl` (this repo) — platform + stubs + reusable workflows
- `acdl-contracts` — developer surface (`contract.yaml` + issue trigger)
- `acdl-evidence` — audit timeline (served via raw file URLs; Gitea has no
native Pages — see `.ciagent/ARCHITECTURE.md` Gitea API Surface table)
## Project metadata
See `.ciagent/PROJECT.md` for the full spec, `.ciagent/ROADMAP.md` for the
5-phase breakdown, `.ciagent/REQUIREMENTS.md` for traceable requirements,
and `.ciagent/PERSONAS.md` for the active persona roster.
## Phase 01 verification
After running `scripts/gitea_setup.sh` (which creates `acdl-contracts` and
`acdl-evidence` in the org and pushes the placeholder `index.html`), run:
```bash
ACDL_GITEA_TOKEN=<token> scripts/verify_phase01.sh
```
The script confirms:
- both new repos exist via the Gitea API
- the raw `index.html` URL on `acdl-evidence` returns HTTP 200
- the `qa` and `prod` branches exist on `acdl-contracts`
Exit 0 = Phase 01 success criteria met.