2682719f24
docs(P47): presentation slide updates + HIPAA removal from all docs
...
acdl-ci / Lint (push) Successful in 7s
acdl-ci / Test (push) Successful in 26s
acdl-ci / Platform check-only (offline) (push) Successful in 8s
Presentation changes (both Marp decks + source markdown):
1. Title slide: deck title as H1 (slightly bigger), 'Agentic Cloud Delivery
Platform' as H3 subtitle — cleaner title hierarchy
2. DX deck: removed Local Reproducibility slide (not beneficial for DX)
3. DX deck: Safe Promotion Path slide redesigned with side-by-side layout
for Approaches A and B (HTML table, two columns)
4. DX deck: 'an agent' → 'an AI agent' (slide 2 + Citizen Developer slide)
5. DX deck: What a Developer Does — diagram floated to the right side
6. Header simplified to just the deck name (subtitle now on title slide)
HIPAA removal (25 files):
- Completely removed all HIPAA references from all markdown documentation,
presentation source files, module READMEs, and rendered HTML
- Removed HIPAA from compliance milestone lists (GDPR, SOX, SOC2, DORA remain)
- Removed HIPAA section references (§164.xxx) from compliance annotations
- Cleaned up empty parentheses and broken commas left by removal
- Re-rendered both HTML decks from updated Marp source
---ci---
phase: 47
milestone: v1.9
status: complete
requirements:
covered: []
partial: []
---/ci---
2026-07-23 14:08:40 +00:00
cb02c69e0c
docs(P35): module engineering standards + catalog fix + template update (REQ-95, REQ-96)
...
---ci---
project: acdl
phase: 35
milestone: v1.8
status: execute
---/ci---
- modules/STANDARDS.md: comprehensive L1+L2 authoring + code review
standards (9 sections: L1 standards, L2 standards, encryption by default,
deletion protection by default, registry, README standards, adapter
extension pattern, code review checklist).
- modules/README.md: catalog index fixed — rds, kms-key, uptime added
to the Primitives table.
- modules/README-TEMPLATE.md: NFRs section added between Outputs and Usage.
- tests/test_module_standards.py: automated enforcement test (12 tests)
validating required files, NFRs, registration, README sections.
Tests: +12 (332 -> 344). All pass.
2026-07-22 22:20:50 +00:00
553caf8f1d
docs(P21): rewrite README + normalize modules terminology (REQ-52,55,56,57,58,59,60)
...
---ci---
project: acdl
phase: 21
milestone: v1.6
status: execute
---/ci---
README.md rewrite:
- Remove all .ciagent/ references (links + repository-layout row).
- Remove .gitea/workflows/ row from repository layout.
- Restate repository roles: consumer repo = app code + 1+ contracts +
CI definitions (thin .github/workflows/*.yml uses:-ing the central
workflow); platform repo owns modules/adapters/core/schemas/pipelines/
scripts/workflows.
- Replace Status section with Features list (consumer + platform-engineer
referenceable) + Roadmap (planned only, no version changelog, no
internal CIAgent status). Includes the composition-redesign roadmap
entry (dynamic module creation from a contract).
- Fix the mermaid flowchart: all node text visible (short multi-line
labels via <br/>), add a security-checks stage before policy checks,
do not name specific tools (security checks/policy checks/infrastructure
plan via adapter), add infrastructure-apply stage (dev only, after
evidence event).
- Remove the environments table (dev/qa/prod/dr) completely; point to
docs/environments/ for platform-managed environments.
- Credentials section: remove go-gitea/gitea#36988 blocked mention +
waivers D-039/D-047 language. State OIDC+ABAC default; alternative is a
static AWS key (GitHub Secrets for platform-runner runs, .env.secrets
locally) with daily rotation (platform-managed) or out-of-band rotation
(consumer-managed for local .env.secrets).
- forge -> platform runners / platform-managed throughout.
- Links point to docs/ Pages paths, not .ciagent/.
modules/ terminology:
- modules/README.md: L1 primitives -> primitives, L2 compositions ->
modules, composition -> pattern (prose); add roadmap note for the
composition redesign.
- README-TEMPLATE.md: L1 primitive -> primitive.
- All 7 L1 READMEs: L1 primitive -> primitive.
- L2 static-asset + microservice READMEs: L2 composition -> module
pattern, composition -> pattern, L1 -> primitive; bump stale @v1 ->
@v1.4 in usage examples; fix CONSUMER_GUIDE.md -> consumer-guide.md
link.
Verification: grep sweeps for .ciagent/.gitea/forge/go-gitea/waiver/
D-039/D-047/acdl_platform in docs/ README.md modules/ contracts/ all
return 0 hits. Tests: 166 pass. run_ci.sh green.
2026-07-22 18:26:00 +00:00
895a2f3806
docs(P20): specify phase 20 — consumer happy path + reusable deploy workflow (v1.5)
...
---ci---
project: acdl
phase: 20
milestone: v1.5
status: specify
---/ci---
Add v1.5 milestone to ROADMAP.md + REQUIREMENTS.md. Phase 20 covers
REQ-46 (README consumer model + mermaid + L3B/spike scrub), REQ-47
(generic CONSUMER_GUIDE.md + versioned uses: + consumer-scoped prereqs
+ run-time platform fetch), REQ-48 (zero-trust OIDC/ABAC credentials +
static-key override + daily rotation), REQ-49 (reusable byte-identical
deploy.yml Gitea+GitHub implementing pipelines/deploy.yaml), REQ-50
(contracts/static-asset.yaml @v1.4), REQ-51 (deploy-workflow conformance
tests). Update config.json milestone to v1.5.
2026-07-22 17:09:23 +00:00
Jon Chery