fix(modules): remove uniform agent_context_budget:1500 stamp from 80 manifests #331

Closed
claude wants to merge 1 commit from claude/d/agent-context-budget-schema-default into main
Collaborator

Summary

DeepSeek deep review 2026-05-14, finding #6: every of 80 module manifests carries identical agent_context_budget: 1500. Per DeepSeek: "if the budget is always 1500, it's a constant, not a per-module parameter".

What

  • Removes agent_context_budget: 1500 line from all 80 manifests (uniform stamp, no signal)
  • Updates schema/module.schema.md to instruct: omit from manifest when 1500 suffices; specify only when actual budget differs

Why this is safe

  • Field is optional in schema/module.schema.json (default: 1500)
  • No runtime code reads it (verified via grep -rn 'agent_context_budget' control-plane/platformctl/ → only test fixtures, intentional)
  • Test fixtures keep their copies
  • All 80 module.yaml files parse via yaml.safe_load post-change (verified)

Why per ADR-0018

This is exactly the "platform telling agents something it doesn't actually use" pattern. Future cousins reading 80× '1500' would either tune toward the constant (wrong) or learn to ignore the field (also wrong) — both outcomes degrade agent-readable system state.

Tier

Lite per ADR-0007 — single mechanical concern, 80 trivial deletions, docs-only change to schema spec markdown.

Verification

# Before:
grep -l 'agent_context_budget: 1500' modules/*/module.yaml | wc -l
# 80

# After:
grep -l 'agent_context_budget:' modules/*/module.yaml | wc -l
# 0

# Parse check:
python3 -c "import yaml; [yaml.safe_load(open(f'modules/{m}/module.yaml')) for m in __import__('os').listdir('modules')]"
# all module.yaml parse OK

Refs DeepSeek deep review 2026-05-14 finding #6 (state/deep-reviews/2026-05-14-platform-deep-review.md)

## Summary DeepSeek deep review 2026-05-14, finding #6: every of 80 module manifests carries identical `agent_context_budget: 1500`. Per DeepSeek: *"if the budget is always 1500, it's a constant, not a per-module parameter"*. ## What - Removes ` agent_context_budget: 1500` line from all 80 manifests (uniform stamp, no signal) - Updates `schema/module.schema.md` to instruct: omit from manifest when 1500 suffices; specify only when actual budget differs ## Why this is safe - Field is **optional** in `schema/module.schema.json` (default: 1500) - No runtime code reads it (verified via `grep -rn 'agent_context_budget' control-plane/platformctl/` → only test fixtures, intentional) - Test fixtures keep their copies - All 80 `module.yaml` files parse via `yaml.safe_load` post-change (verified) ## Why per ADR-0018 This is exactly the "platform telling agents something it doesn't actually use" pattern. Future cousins reading 80× '1500' would either tune toward the constant (wrong) or learn to ignore the field (also wrong) — both outcomes degrade agent-readable system state. ## Tier **Lite** per ADR-0007 — single mechanical concern, 80 trivial deletions, docs-only change to schema spec markdown. ## Verification ```bash # Before: grep -l 'agent_context_budget: 1500' modules/*/module.yaml | wc -l # 80 # After: grep -l 'agent_context_budget:' modules/*/module.yaml | wc -l # 0 # Parse check: python3 -c "import yaml; [yaml.safe_load(open(f'modules/{m}/module.yaml')) for m in __import__('os').listdir('modules')]" # all module.yaml parse OK ``` Refs DeepSeek deep review 2026-05-14 finding #6 (state/deep-reviews/2026-05-14-platform-deep-review.md)
fix(modules): remove uniform agent_context_budget:1500 stamp from 80 manifests
All checks were successful
base-is-main / guard (pull_request) Successful in 1s
canary-required / collect-diff (pull_request) Successful in 4s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 3s
platformctl plan / auto-apply scope (pull_request) Successful in 21s
python-ci / Python 3.11 (pull_request) Successful in 36s
python-ci / Python 3.12 (pull_request) Successful in 40s
python-ci / Python 3.13 (pull_request) Successful in 37s
canary-required / canary (pull_request) Successful in 12s
patchwarden-pr-sanity / sanity (pull_request) Successful in 20s
a9463c3399
DeepSeek deep review 2026-05-14, finding #6: every of the 80 module
manifests carried identical agent_context_budget:1500. Per DeepSeek:
"if the budget is always 1500, it's a constant, not a per-module
parameter".

Field is optional in schema/module.schema.json (default:1500). No
runtime code reads the value (verified via grep across control-plane/);
test fixtures keep their copies intentionally. Removing the line from
manifests has zero behavior impact and removes metadata theatre.

Schema doc (schema/module.schema.md) updated to instruct: omit from
manifest when 1500 suffices; specify only when actual budget differs.

Per ADR-0018: this is exactly the "platform telling agents
something it doesn't actually use" pattern. Future cousins reading
80× '1500' would either tune toward the constant (wrong) or learn
to ignore the field (also wrong).

Tier: Lite per ADR-0007 (single mechanical concern, 80 trivial deletions,
docs-only change to schema spec markdown).

Verification:
  grep -l "agent_context_budget: 1500" modules/*/module.yaml | wc -l
  # before: 80
  # after: 0
  all module.yaml parse via yaml.safe_load (verified)

Refs DeepSeek finding #6
Collaborator

Fork C triage result: keep as merge candidate, not rewrite. Evidence checked from live Forgejo/main: PR is mergeable and green; merge-base diff is 81 files, mechanically removing uniform spec.agent_context_budget: 1500 plus the schema doc clarification. Current main still has 82 uniform stamps; the PR branch has 0. Validation: cd control-plane && uv run platformctl validate all => exitCode=0, 82 results, 0 failed. Recommendation: operator may merge #331 as a Full-tier metadata cleanup if required checks remain green; splitting would leave mixed metadata semantics and add churn without reducing meaningful runtime risk. No production touch.

Fork C triage result: keep as merge candidate, not rewrite. Evidence checked from live Forgejo/main: PR is mergeable and green; merge-base diff is 81 files, mechanically removing uniform spec.agent_context_budget: 1500 plus the schema doc clarification. Current main still has 82 uniform stamps; the PR branch has 0. Validation: cd control-plane && uv run platformctl validate all => exitCode=0, 82 results, 0 failed. Recommendation: operator may merge #331 as a Full-tier metadata cleanup if required checks remain green; splitting would leave mixed metadata semantics and add churn without reducing meaningful runtime risk. No production touch.
Collaborator

W9 rewrite/archive triage: closing this stale branch because the useful mechanical cleanup was rewritten from current main in #518. #518 preserves the schema default, keeps non-default 1800 budgets, and validates cleanly.

W9 rewrite/archive triage: closing this stale branch because the useful mechanical cleanup was rewritten from current main in #518. #518 preserves the schema default, keeps non-default 1800 budgets, and validates cleanly.
codex closed this pull request 2026-05-27 08:49:48 +02:00
All checks were successful
base-is-main / guard (pull_request) Successful in 1s
Required
Details
canary-required / collect-diff (pull_request) Successful in 4s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 3s
platformctl plan / auto-apply scope (pull_request) Successful in 21s
python-ci / Python 3.11 (pull_request) Successful in 36s
python-ci / Python 3.12 (pull_request) Successful in 40s
python-ci / Python 3.13 (pull_request) Successful in 37s
canary-required / canary (pull_request) Successful in 12s
patchwarden-pr-sanity / sanity (pull_request) Successful in 20s
Required
Details

Pull request closed

Sign in to join this conversation.
No reviewers
No labels
W6d-automerge-calibration
agent/claude-code
agent/codex
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
automerge-candidate
class/security-sensitive
cutover-gate
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
iterating
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
large-impact
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
meta
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
needs-operator-decision
needs-triage
not-ready
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
operator-emotional
owner-attention
phase/02
phase/03
priority:p0
priority:p1
priority:p2
priority:p3
proposed
ready-for-agent
ready-for-operator
recovery
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
risk/exposure
risk/process
risk/product
risk/runtime
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
size/large
size/medium
size/small
size/tiny
size/unknown
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:operator-needed
status:parked
tier/full
tier/lite
tier/stacked
tier:0-platform-substrate
tier:1-iskra-value-layer
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/platform!331
No description provided.