Skip to content

docs(roadmap): Initiative 14 — deployment patterns, proven by two clean cycles - #545

Open
jwvanderstam wants to merge 1 commit into
mainfrom
docs/deployment-patterns
Open

jwvanderstam wants to merge 1 commit into
mainfrom
docs/deployment-patterns

Conversation

@jwvanderstam

Copy link
Copy Markdown
Owner

Adds Initiative 14 to the roadmap, as the maintainer decided after reading #536. This replaces #536's proposal: the roadmap entry goes in now, and no DEPLOYMENT_PATTERNS.md is added until a pattern exists to fill it.

The rule. Every pattern gets one file under docs/deployment/, in a fixed format: environment, topology, persistent state, how models arrive, security boundaries, lifecycle, and known pitfalls as symptom, cause and fix. A pattern may have its own scripts under scripts/deploy/<pattern>/. It counts as proven once deploy, verify and tear down run twice in a row without an error or a manual step. Each cycle is recorded in the pattern's file, and a failed cycle resets the count.

Ticket Pattern State
DP-0 The format and docs/deployment/README.md —
DP-1 Your own PC, Docker Compose, unrestricted network Works and is documented (DEPLOYMENT.md); has no deploy or tear-down script
DP-2 Scaleway Works; the scripts exist in scripts/scaleway/; never proven twice in a row
DP-3 Managed workstation, Windows + WSL2 + GPU behind a proxy Candidate from #536; not reproduced

Unscheduled, with a row in the Sprint Plan and an entry in ROADMAP_LOG. tests/unit/test_docs_reference_what_exists.py passes locally. docs/ is the retrieval-gate's corpus, so that gate is the one check that could move.

🤖 Generated with Claude Code

…an cycles

From #536. One format per environment under docs/deployment/, each pattern with
its own deploy, verify and tear-down scripts. A pattern is proven when those
run end to end twice in a row without an error or a manual step; a failed cycle
resets the count. Your own PC (DP-1) and Scaleway (DP-2) already work and need
bringing into the format; the managed workstation #536 reported (DP-3) stays a
candidate until reproduced.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KkWPq9YWxtZ6hbDvMft8fh
Copilot AI balanced review requested due to automatic review settings November 14, 2026 16:22

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants