菜单
Build a multi-quarter architecture roadmap with milestones, dependencies, risk markers, and Wardley-style evolution. Use when planning platform investment, sequencing migrations, or aligning squads on a target state.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | architecture-roadmap |
| description | Build a multi-quarter architecture roadmap with milestones, dependencies, risk markers, and Wardley-style evolution. Use when planning platform investment, sequencing migrations, or aligning squads on a target state. |
A roadmap turns a target architecture into a sequenced, dependency-aware investment plan. This skill combines Now/Next/Later swimlanes, a Gantt-style milestone view, Wardley evolution, and explicit risk markers - so leadership sees value flow and engineers see the critical path.
| Concern | Recommended |
|---|---|
| Horizon | 4-6 quarters; never beyond 18 months |
| Buckets | Now / Next / Later (Janna Bastow) plus a Parked column |
| Dependencies | Explicit cross-stream arrows, no hidden coupling |
| Risk | RAID markers (R/A/I/D) on each milestone |
| Evolution | Wardley Map for capability movement (Genesis -> Custom -> Product -> Commodity) |
| Team alignment | Team Topologies stream-aligned/platform/enabling tags |
| Tooling | Mermaid Gantt + ProductPlan/Aha! or markdown table |
flowchart LR
subgraph Now[Now - this quarter]
N1[Extract billing service]
N2[Adopt OTel everywhere]
end
subgraph Next[Next - +1/+2 quarters]
X1[Postgres -> Aurora]
X2[Front door on Cloudflare]
end
subgraph Later[Later - +3/+6 quarters]
L1[Multi-region active/active]
L2[Event mesh consolidation]
end
N1 --> X1
N2 --> X1
X2 --> L1
X1 --> L1
gantt
title Platform Roadmap - 2026 H1/H2
dateFormat YYYY-MM-DD
axisFormat %b
section Billing
Extract service :active, b1, 2026-04-01, 90d
Cutover :milestone, b2, 2026-07-01, 0d
section Data
Aurora migration :a1, after b2, 120d
Active/active :crit, a2, after a1, 90d
section Edge
Cloudflare front door :e1, 2026-05-01, 60d
| Capability | Today | Target | Move |
|---|---|---|---|
| Auth | Custom-built | Product (IdP) | Buy |
| Billing | Product | Custom (extracted) | Build |
| Observability | Custom | Commodity (OTel SaaS) | Adopt |
| CI/CD | Product | Commodity | Consolidate |
| ID | Type | Item | Mitigation | Owner |
|---|---|---|---|---|
| R-01 | Risk | Aurora cutover during peak | Freeze + dry runs | @data-lead |
| A-02 | Assumption | Cloudflare contract by Q3 | Procurement track | @cto-office |
| I-03 | Issue | OTel agent CPU regression | Vendor ticket open | @sre |
| D-04 | Dependency | IdP migration before billing cutover | Sequenced in Gantt | @platform |
| Pitfall | Symptom | Fix |
|---|---|---|
| Wishlist | 40 items, no sequencing | Force Now/Next/Later limits (max 5 in Now) |
| Hidden dependencies | Slip in one stream surprises another | Explicit arrows + RAID D entries |
| Date theatre | Precise dates 12 months out | Quarters beyond Now; dates only in Now |
| No evolution view | Build vs buy debates repeat | Include Wardley overlay |
| Disconnected from teams | Plan ignores capacity | Tag each item with owning team (Team Topologies) |
docs/roadmap/2026-Hx.md with Mermaid Gantt + tables.Build production integrations with Anthropic Claude (Claude 4.5 Sonnet, Claude Opus 4, Claude Haiku 4) via the Messages API — system prompts, multi-turn conversations, tool use (function calling), prompt caching, extended thinking, vision, batched requests, and streaming. Use when wiring Claude into backends, agentic workflows, or evaluating it against other foundation models. Requires ANTHROPIC_API_KEY.
Deploy Cloudflare Workers, Pages, and Workers-with-static-assets safely using Wrangler 4.x with versioned uploads, gradual deployments, preview/production environments, secret bindings, observability, and one-command rollback. Use when shipping edge workloads, API routes, or full-stack apps to Cloudflare. Requires CLOUDFLARE_API_TOKEN with scoped permissions or an authenticated Wrangler session.
Deploy static sites, framework apps (Next.js, Astro, Remix, SvelteKit, Nuxt), Edge Functions, and serverless Functions to Netlify with deploy previews, branch deploys, atomic production promotion, scoped env vars, and instant rollback. Use when releasing on Netlify via CLI, API, or Git-triggered builds. Requires NETLIFY_AUTH_TOKEN (PAT) and NETLIFY_SITE_ID.
Transcribe audio with OpenAI speech-to-text models (gpt-4o-transcribe, gpt-4o-mini-transcribe, whisper-1) using prompt-guided terminology, segment-level timestamps, optional diarization via post-processing, and reliable artifact delivery. Use when converting interviews, calls, podcasts, or meeting recordings into reviewable text. Requires OPENAI_API_KEY.
Deploy Web Services, Private Services, Background Workers, Cron Jobs, Static Sites, PostgreSQL, and Key-Value (Redis-compatible) on Render via Blueprints (`render.yaml`) or the Render API with preview environments, zero-downtime rolling deploys, health checks, env-group secret scoping, and one-click rollback. Use when releasing services, applying schema migrations, or syncing infra-as-code on Render. Requires RENDER_API_KEY (owner- or workspace-scoped).
Operate Sentry end-to-end — error monitoring, performance tracing, session replay, profiling, release health, source-map upload, ownership routing, alert tuning, issue triage, and CI integration via sentry-cli — across web, mobile, and backend stacks. Use when instrumenting an app, wiring releases into deploy pipelines, or running incident-grade triage. Requires SENTRY_AUTH_TOKEN (org-scoped, `project:releases project:write`), project DSN, and (for source maps) `org` + `project` slugs.