[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F47AAQ82DBNSTYBZ8RMNAS":3,"skill-same:01M7F47AAQ82DBNSTYBZ8RMNAS":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7F47AAQ82DBNSTYBZ8RMNAS","deployment-topology-design",null,"Method for deciding compute placement across edge, regional, and origin tiers, sizing caching layers against real staleness tolerance, and stating the latency or regulatory constraint that justifies each distribution decision.","cwik-tech\u002Foctopus","cwik-tech","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F54542292?v=4","01M7F42E123GEHVK6RWC5MSWJ9","Tomasz Cwik","01M7F42E1PD4P54MTG8PG32VCV",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fagents\u002Farchitect-web-platform\u002Fskills\u002Fdeployment-topology-design\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: deployment-topology-design\ndescription: Method for deciding compute placement across edge, regional, and origin tiers, sizing caching layers against real staleness tolerance, and stating the latency or regulatory constraint that justifies each distribution decision.\n---\n\n# Deployment Topology Design\n\n## Purpose\n\nDecide where compute runs geographically, which tier serves each class of request, and how caching layers are placed — with every distribution decision traced to a named latency budget, geographic constraint, or regulatory requirement. Prevent distributed topology from being adopted as a default posture.\n\n## When To Use\n\nRun this only when a distribution decision is genuinely live: there is a stated latency requirement, a geographic user distribution that spans regions, a data-residency constraint, or an existing topology under review. If none of these apply, the correct output is \"topology is not yet a decision\" — say that and stop.\n\nDo not run this to justify a topology someone has already chosen. If the topology is pre-decided, the useful contribution is to name the constraint it assumes and test whether that constraint is real.\n\n## Step 1 — Establish the Latency Budget\n\nNo topology decision is possible without a budget. Get these numbers or record their absence:\n\n- **Target time-to-first-byte** for the most latency-sensitive route.\n- **Target end-to-end interaction latency** for the most common mutation.\n- **Tolerable p99** relative to p50 — how much tail is acceptable.\n\nIf no budget exists, state that explicitly and treat every subsequent recommendation as provisional. A topology chosen without a budget is a topology chosen by preference.\n\nDecompose the budget into its unavoidable components: network round trip to the nearest point of presence, compute time, data access time, and any downstream call. Distribution only helps the first component. If compute or data access dominates the budget, distribution is the wrong lever and should be named as such.\n\n## Step 2 — Map User Geography Against Data Geography\n\nRecord:\n\n- Where users actually are, by proportion, not by aspiration.\n- Where the authoritative data lives.\n- Whether data has residency constraints that pin it to a jurisdiction.\n\nThe critical case is **users far from data**. Edge compute placed near users but reading from a distant origin adds a hop rather than removing one. Name this explicitly whenever it appears — it is the most common failure in edge adoption.\n\nEdge compute is justified when the work at the edge does not need authoritative data: signature verification, redirects, header manipulation, geo-routing, static personalization, bot filtering, A\u002FB assignment. It is not justified when the work needs a read from origin, because the round trip reappears.\n\n## Step 3 — Assign Each Request Class to a Tier\n\nClassify every request class:\n\n| Tier | Serves | Requires |\n|---|---|---|\n| CDN \u002F static | Prerendered or asset responses | No per-request identity or freshness |\n| Edge compute | Token verification, routing, header logic, geo decisions | No authoritative data read |\n| Regional compute | Everything reading or writing authoritative data | Colocated with or near the data |\n| Origin | Long-running, stateful, or resource-heavy work | Nothing latency-sensitive depends on it synchronously |\n\nFor each assignment, record the forcing constraint. An assignment with no constraint behind it is a preference and should be simplified toward the fewest tiers that satisfy the budget.\n\n**Default posture: fewest tiers that meet the budget.** Every additional tier adds a deployment target, an observability surface, a failure mode, and a place where configuration can drift. The board's complexity budget applies here directly.\n\n## Step 4 — Size the Caching Layers\n\nFor each cacheable response class, record:\n\n- **Staleness tolerance** in real time units, sourced from a requirement rather than assumed.\n- **Cache key** — including every dimension that varies the response. Identity, tenant, locale, and feature-flag state are the ones most often omitted.\n- **Invalidation trigger** — what event makes this entry wrong, and how the cache learns about it.\n- **Behavior on invalidation failure** — how long stale data is served if invalidation is missed.\n\nApply the test: **if the cache were removed, what breaks?** If the answer is \"nothing, it just gets slower,\" the cache is an optimization and can be deferred. If the answer is \"the system exceeds its latency budget\" or \"origin capacity is exceeded,\" the cache is structural and belongs in the topology.\n\nAny per-user or per-tenant response is not shared-cacheable. Confirm the session model from the boundary analysis before proposing shared caching on any authenticated route.\n\n## Step 5 — Enumerate Failure Modes\n\nFor each tier in the proposed topology, state:\n\n- What the system does when that tier is unavailable.\n- Whether the failure is fail-open or fail-closed, and whether that is correct for the request class.\n- Whether any tier is a hard dependency for a request class that could otherwise degrade gracefully.\n\nEdge auth verification deserves specific attention: if the edge tier fails open, unauthenticated requests reach regional compute; if it fails closed, an edge outage is a total outage. Both are defensible; neither should be accidental.\n\n## Step 6 — Produce the Topology Statement\n\nOutput:\n\n- **Latency budget** and its decomposition, or an explicit note that no budget exists.\n- **Tier assignment table** with the forcing constraint per row.\n- **Caching layers** with staleness tolerance, key dimensions, and invalidation trigger.\n- **Failure behavior** per tier.\n- **Simplification candidate** — the one tier that could be removed with the smallest budget impact, and what that impact would be.\n\nThe simplification candidate is mandatory. It gives the board and the critic a concrete lever for reducing complexity, and it forces the topology to justify its own last tier.\n\n## Anti-Patterns To Name\n\n- **Edge without a budget.** Distributed compute adopted because it is available rather than because a latency requirement demands it.\n- **Edge in front of distant origin.** Compute placed near users that must read from far-away authoritative data — adds a hop, removes none.\n- **Cache keys missing a varying dimension.** Especially tenant, identity, and locale. This is a correctness bug, not a performance issue.\n- **Invalidation without a failure story.** No stated behavior when an invalidation event is missed.\n- **Multi-region as a default.** Adopted before single-region has been shown to miss the budget.\n- **Accidental fail-open auth.** Edge verification whose failure behavior was never chosen.\n\n## Handoff Boundary\n\nThis analysis places compute and caching. It does not choose replication strategy, consistency model, or storage engine geography — where the authoritative data lives is an input to this analysis, supplied by the persistence seat, not an output of it. If the topology requires data to move, state the requirement and hand it over.\n","# Deployment Topology Design\n\n## Purpose\n\nDecide where compute runs geographically, which tier serves each class of request, and how caching layers are placed — with every distribution decision traced to a named latency budget, geographic constraint, or regulatory requirement. Prevent distributed topology from being adopted as a default posture.\n\n## When To Use\n\nRun this only when a distribution decision is genuinely live: there is a stated latency requirement, a geographic user distribution that spans regions, a data-residency constraint, or an existing topology under review. If none of these apply, the correct output is \"topology is not yet a decision\" — say that and stop.\n\nDo not run this to justify a topology someone has already chosen. If the topology is pre-decided, the useful contribution is to name the constraint it assumes and test whether that constraint is real.\n\n## Step 1 — Establish the Latency Budget\n\nNo topology decision is possible without a budget. Get these numbers or record their absence:\n\n- **Target time-to-first-byte** for the most latency-sensitive route.\n- **Target end-to-end interaction latency** for the most common mutation.\n- **Tolerable p99** relative to p50 — how much tail is acceptable.\n\nIf no budget exists, state that explicitly and treat every subsequent recommendation as provisional. A topology chosen without a budget is a topology chosen by preference.\n\nDecompose the budget into its unavoidable components: network round trip to the nearest point of presence, compute time, data access time, and any downstream call. Distribution only helps the first component. If compute or data access dominates the budget, distribution is the wrong lever and should be named as such.\n\n## Step 2 — Map User Geography Against Data Geography\n\nRecord:\n\n- Where users actually are, by proportion, not by aspiration.\n- Where the authoritative data lives.\n- Whether data has residency constraints that pin it to a jurisdiction.\n\nThe critical case is **users far from data**. Edge compute placed near users but reading from a distant origin adds a hop rather than removing one. Name this explicitly whenever it appears — it is the most common failure in edge adoption.\n\nEdge compute is justified when the work at the edge does not need authoritative data: signature verification, redirects, header manipulation, geo-routing, static personalization, bot filtering, A\u002FB assignment. It is not justified when the work needs a read from origin, because the round trip reappears.\n\n## Step 3 — Assign Each Request Class to a Tier\n\nClassify every request class:\n\n| Tier | Serves | Requires |\n|---|---|---|\n| CDN \u002F static | Prerendered or asset responses | No per-request identity or freshness |\n| Edge compute | Token verification, routing, header logic, geo decisions | No authoritative data read |\n| Regional compute | Everything reading or writing authoritative data | Colocated with or near the data |\n| Origin | Long-running, stateful, or resource-heavy work | Nothing latency-sensitive depends on it synchronously |\n\nFor each assignment, record the forcing constraint. An assignment with no constraint behind it is a preference and should be simplified toward the fewest tiers that satisfy the budget.\n\n**Default posture: fewest tiers that meet the budget.** Every additional tier adds a deployment target, an observability surface, a failure mode, and a place where configuration can drift. The board's complexity budget applies here directly.\n\n## Step 4 — Size the Caching Layers\n\nFor each cacheable response class, record:\n\n- **Staleness tolerance** in real time units, sourced from a requirement rather than assumed.\n- **Cache key** — including every dimension that varies the response. Identity, tenant, locale, and feature-flag state are the ones most often omitted.\n- **Invalidation trigger** — what event makes this entry wrong, and how the cache learns about it.\n- **Behavior on invalidation failure** — how long stale data is served if invalidation is missed.\n\nApply the test: **if the cache were removed, what breaks?** If the answer is \"nothing, it just gets slower,\" the cache is an optimization and can be deferred. If the answer is \"the system exceeds its latency budget\" or \"origin capacity is exceeded,\" the cache is structural and belongs in the topology.\n\nAny per-user or per-tenant response is not shared-cacheable. Confirm the session model from the boundary analysis before proposing shared caching on any authenticated route.\n\n## Step 5 — Enumerate Failure Modes\n\nFor each tier in the proposed topology, state:\n\n- What the system does when that tier is unavailable.\n- Whether the failure is fail-open or fail-closed, and whether that is correct for the request class.\n- Whether any tier is a hard dependency for a request class that could otherwise degrade gracefully.\n\nEdge auth verification deserves specific attention: if the edge tier fails open, unauthenticated requests reach regional compute; if it fails closed, an edge outage is a total outage. Both are defensible; neither should be accidental.\n\n## Step 6 — Produce the Topology Statement\n\nOutput:\n\n- **Latency budget** and its decomposition, or an explicit note that no budget exists.\n- **Tier assignment table** with the forcing constraint per row.\n- **Caching layers** with staleness tolerance, key dimensions, and invalidation trigger.\n- **Failure behavior** per tier.\n- **Simplification candidate** — the one tier that could be removed with the smallest budget impact, and what that impact would be.\n\nThe simplification candidate is mandatory. It gives the board and the critic a concrete lever for reducing complexity, and it forces the topology to justify its own last tier.\n\n## Anti-Patterns To Name\n\n- **Edge without a budget.** Distributed compute adopted because it is available rather than because a latency requirement demands it.\n- **Edge in front of distant origin.** Compute placed near users that must read from far-away authoritative data — adds a hop, removes none.\n- **Cache keys missing a varying dimension.** Especially tenant, identity, and locale. This is a correctness bug, not a performance issue.\n- **Invalidation without a failure story.** No stated behavior when an invalidation event is missed.\n- **Multi-region as a default.** Adopted before single-region has been shown to miss the budget.\n- **Accidental fail-open auth.** Edge verification whose failure behavior was never chosen.\n\n## Handoff Boundary\n\nThis analysis places compute and caching. It does not choose replication strategy, consistency model, or storage engine geography — where the authoritative data lives is an input to this analysis, supplied by the persistence seat, not an output of it. If the topology requires data to move, state the requirement and hand it over.\n",{"name":5,"description":7},"main","f0f0efe1d4c64b51a51f44427ad147750d29154e","agents\u002Farchitect-web-platform\u002Fskills\u002Fdeployment-topology-design","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus","www.cuteoctopus.site","https:\u002F\u002Fgithub.com\u002Fcwik-tech","2026-10-27 06:12:19",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add cwik-tech\u002Foctopus --skill deployment-topology-design",{"tool":37,"command":38},"bunx","bunx skills add cwik-tech\u002Foctopus --skill deployment-topology-design",{"tool":40,"command":41},"pnpm","pnpm dlx skills add cwik-tech\u002Foctopus --skill deployment-topology-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fagents\u002Farchitect-web-platform\u002Fskills\u002Fdeployment-topology-design\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7F5MQVQ3CHGM77Q51M4B1AC","twenty-year-land-plan","Apply the Bren discipline of evaluating every land and development decision on a twenty-year horizon, with a comprehensive plan for how the land, the community, and the surrounding public infrastructure evolve together. Deals optimized for a five-year exit are structurally different from deals that compound across generations; insist on knowing which kind you are making. Use when evaluating land, entitlements, master-planned development, or phasing decisions, and when separating five-year exit deals from generational holds.","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fskills\u002Ftwenty-year-land-plan\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7F5MGQ8JSV27SFDQVVGFQE3","thematic-gut-check","Apply the Gray discipline of identifying the structural theme behind every real estate deal, testing where that theme sits in its capital-flow lifecycle, and insisting that deals without a named theme — or deals late in a crowded theme — clear a higher bar. A mediocre deal in a strong theme usually beats a clever deal in a weak one. Use when naming the structural thesis behind a deal, judging whether that theme is early or crowded, and setting the bar the deal must clear.","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fskills\u002Fthematic-gut-check\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7F5M8V64Y0ZD8PTPWEJQXJ9","supply-pipeline-gut-check","Apply the Zell discipline of grounding every real estate thesis in the local supply pipeline. Demand counts over adjectives — units under construction, units permitted, units proposed — and convert them into a forward absorption schedule. A deal that ignores the pipeline is a bet on a market you have not actually studied. Use when validating a market thesis, forecasting absorption and rent growth, or counting units under construction, permitted, and proposed.","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fskills\u002Fsupply-pipeline-gut-check\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7F5M3J2Q146BJC13TD3YCXF","ruin-scenario-mapping","Apply the Taleb discipline of identifying, for every real estate deal, the specific chain of events that produces ruin — permanent, unrecoverable capital loss — and verifying that no single such chain has non-trivial probability. Deals with any plausible ruin path must be restructured or abandoned. Use when sizing leverage, testing refinancing, covenant, and liquidity risk, or checking whether any single failure chain can permanently wipe out the position.","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fskills\u002Fruin-scenario-mapping\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7F5KZDS0DYD172P6HS0WXEM","revenue-cost-architecture","Design a venture's revenue streams, pricing logic, cost structure, and unit economics so the business model has a coherent theory of value capture, not just value creation. Use after the value proposition and customer segment are set and before financial projections, when choosing a pricing model, calculating contribution margin or CAC payback, or checking whether the unit economics hold at scale.","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fskills\u002Frevenue-cost-architecture\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7F5KP1CNQMYAVCDTV4EEW3J","replacement-cost-stress-test","Apply the Buffett discipline of pricing every real estate asset against the cost to rebuild it from scratch. The ratio of purchase price to replacement cost sets a ceiling on long-run downside: below replacement cost, new supply cannot profitably undercut you; at or above it, you are buying a liability disguised as an asset. Use when setting a purchase price, judging downside protection, or testing how exposed an asset is to newly built competing supply.","https:\u002F\u002Fgithub.com\u002Fcwik-tech\u002Foctopus\u002Fblob\u002Fmain\u002Fskills\u002Freplacement-cost-stress-test\u002FSKILL.md",[],[]]