CAS-239: Exemplar Web Repo & How-To Strategy
Exemplar Repos (Board-confirmed)
| Repo | Platform | URL |
|---|---|---|
| cascadeguard-exemplar-web-cloudflare | Cloudflare (GitHub CI) | GitHub |
| cascadeguard-exemplar-web-argocd | ArgoCD (GitHub CI) | GitHub |
| cascadeguard-exemplar-web-argocd | ArgoCD (GitLab CI) | GitLab |
Note: Evaluate Cloudflare serverless containers for CF exemplar.
How-To Scope
Public how-to is the primary document — includes everything suitable for public consumption. Internal doc references it and adds internal details (agent workflows, Paperclip, internal CI secrets).
Deliverables
D1 — Internal how-to additions
/workspace/.ai/projects/cascadeguard/how-tos.md — references D2, adds internal agent/Paperclip details.
D2 — Public contributing how-to guide (primary)
cascadeguard-docs/docs/contributing/how-tos.md — template, style, conventions, progressive complexity.
D3 — SDLC update
Add how-to docs as DoD item in cascadeguard/SDLC.md.
D4 — Exemplar repos (3)
Each: cascadeguard images enrol, CI/CD workflow, README-as-how-to. Covers GitHub+CF, GitHub+ArgoCD, GitLab+ArgoCD.
D5 — Register in exemplar images catalog
D6 — CLI gap analysis (issues filed during D4)
Execution
| Step | Deliverable | Owner |
|---|---|---|
| 1 | D2 Public how-to | IC |
| 2 | D1 Internal additions | CTO |
| 3 | D3 SDLC update | IC |
| 4-6 | D4 Exemplar repos (3) | IC |
| 7 | D5/D6 Registration + gaps | IC |
| 8 | Revise docs PR #6 | IC |
Status
Plan updated with board feedback. Awaiting final confirmation to create subtasks.