Continuous Agentic Development (CAD) is a novel pre-step to CI/CD coined and defined 2026-06-16 (brain: wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md). The homelab repo is the canonical reference for platform architecture. CAD needs a permanent home here so every project, every harness, and every future collaborator can find the authoritative description.
Scope
Create docs/CAD.md — the canonical CAD reference document — covering:
Definition — what CAD is, what problem it solves, how it relates to CI/CD
The pipeline diagram — from claude.ai strategic session through to Flux CD deployment
Component map — every component, its role, its repo, its status
The agent-ready contract — what an issue must contain to be dispatched
The regulated-industry case — why full traceability matters, what the audit package looks like
Novelty statement — how CAD differs from GitHub Agentic Workflows / GitLab Duo / cicaddy
Build order — what to complete in what sequence
Also update README.md to reference docs/CAD.md as the entry point for the platform architecture.
Acceptance criteria
docs/CAD.md exists and matches the brain definition (wing: homelab, hall: decisions)
Pipeline diagram is ASCII or Mermaid, readable without tooling
Component table is current and accurate (cross-referenced against actual repo status)
brain tunnel: wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md ↔ this doc (cross-reference)
Risk
LOW — documentation only.
## Context — CAD architectural documentation
Continuous Agentic Development (CAD) is a novel pre-step to CI/CD coined and defined 2026-06-16 (brain: `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md`). The homelab repo is the canonical reference for platform architecture. CAD needs a permanent home here so every project, every harness, and every future collaborator can find the authoritative description.
## Scope
Create `docs/CAD.md` — the canonical CAD reference document — covering:
1. **Definition** — what CAD is, what problem it solves, how it relates to CI/CD
2. **The pipeline diagram** — from claude.ai strategic session through to Flux CD deployment
3. **Component map** — every component, its role, its repo, its status
4. **The agent-ready contract** — what an issue must contain to be dispatched
5. **The regulated-industry case** — why full traceability matters, what the audit package looks like
6. **Novelty statement** — how CAD differs from GitHub Agentic Workflows / GitLab Duo / cicaddy
7. **Build order** — what to complete in what sequence
Also update `README.md` to reference `docs/CAD.md` as the entry point for the platform architecture.
## Acceptance criteria
- [ ] `docs/CAD.md` exists and matches the brain definition (wing: homelab, hall: decisions)
- [ ] Pipeline diagram is ASCII or Mermaid, readable without tooling
- [ ] Component table is current and accurate (cross-referenced against actual repo status)
- [ ] Agent-ready contract section matches agentsquad#29 validation rules
- [ ] README.md links to `docs/CAD.md`
- [ ] brain tunnel: `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` ↔ this doc (cross-reference)
## Risk
**LOW** — documentation only.
A cross-repo review comparing jonte888/FlowBrain (external client PoC) against 15+ CAD-stack repos (2026-07-23) produced a stage-by-stage component map and per-repo governance/gate/traceability findings that overlap heavily with what this doc's "Component map" and "Novelty statement" sections need. Summary + per-repo findings captured in brain under wing homelab (wiki/homelab/decisions/ground-truth-verdict-over-self-report.md, wiki/homelab/hypotheses/multi-agent-claim-collision-gap.md, wiki/homelab/hypotheses/semantic-gate-authority-fork.md, wiki/homelab/facts/glossary-ci-gate-pattern.md) — useful input whenever this doc gets written, not a substitute for it.
A cross-repo review comparing jonte888/FlowBrain (external client PoC) against 15+ CAD-stack repos (2026-07-23) produced a stage-by-stage component map and per-repo governance/gate/traceability findings that overlap heavily with what this doc's "Component map" and "Novelty statement" sections need. Summary + per-repo findings captured in brain under wing `homelab` (`wiki/homelab/decisions/ground-truth-verdict-over-self-report.md`, `wiki/homelab/hypotheses/multi-agent-claim-collision-gap.md`, `wiki/homelab/hypotheses/semantic-gate-authority-fork.md`, `wiki/homelab/facts/glossary-ci-gate-pattern.md`) — useful input whenever this doc gets written, not a substitute for it.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Context — CAD architectural documentation
Continuous Agentic Development (CAD) is a novel pre-step to CI/CD coined and defined 2026-06-16 (brain:
wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md). The homelab repo is the canonical reference for platform architecture. CAD needs a permanent home here so every project, every harness, and every future collaborator can find the authoritative description.Scope
Create
docs/CAD.md— the canonical CAD reference document — covering:Also update
README.mdto referencedocs/CAD.mdas the entry point for the platform architecture.Acceptance criteria
docs/CAD.mdexists and matches the brain definition (wing: homelab, hall: decisions)docs/CAD.mdwiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md↔ this doc (cross-reference)Risk
LOW — documentation only.
A cross-repo review comparing jonte888/FlowBrain (external client PoC) against 15+ CAD-stack repos (2026-07-23) produced a stage-by-stage component map and per-repo governance/gate/traceability findings that overlap heavily with what this doc's "Component map" and "Novelty statement" sections need. Summary + per-repo findings captured in brain under wing
homelab(wiki/homelab/decisions/ground-truth-verdict-over-self-report.md,wiki/homelab/hypotheses/multi-agent-claim-collision-gap.md,wiki/homelab/hypotheses/semantic-gate-authority-fork.md,wiki/homelab/facts/glossary-ci-gate-pattern.md) — useful input whenever this doc gets written, not a substitute for it.