Skip to content

docs(adr-0040): §5 build-scope rule — oversized goals decompose into phased modules#1757

Merged
os-zhuang merged 1 commit into
mainfrom
docs/adr-0040-scope-rule
Jun 12, 2026
Merged

docs(adr-0040): §5 build-scope rule — oversized goals decompose into phased modules#1757
os-zhuang merged 1 commit into
mainfrom
docs/adr-0040-scope-rule

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Docs-only. Adds §5 to ADR-0040 recording the scope-guard design implemented in cloud#242:

  • Soft layer: propose_blueprint SCALE rule — oversized goals (ERP, hospital system…) blueprint only the core module; remaining modules become a phased roadmap in assumptions.
  • Hard layer: apply_blueprint rejects over-cap blueprints before staging (blueprint_too_large), default 20, single per-context limit = the plan-entitlement read point.
  • Perception rule: limits that can manifest as advice stay invisible (professional phasing methodology, never "system limitation"); limits that can only manifest as refusal are stated honestly at the moment of impact with a recovery path.
  • Locked by the L5 golden_erp_scope case.

🤖 Generated with Claude Code

…erception rule

Records the scope-guard design shipped in cloud#242: soft design-time
SCALE rule in propose_blueprint, hard apply-time cap (blueprint_too_large)
with one per-context limit as the plan-entitlement read point, and the
advice-vs-refusal perception rule for how limits surface to users.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 12, 2026 3:15am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/s labels Jun 12, 2026
@os-zhuang
os-zhuang merged commit 7c409f0 into main Jun 12, 2026
12 checks passed
@os-zhuang
os-zhuang deleted the docs/adr-0040-scope-rule branch June 12, 2026 03:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant