Skip to content

docs(agents): config-surface discipline — owner-gated, explicit reporting, no self-initiated shapes - #1471

Merged
ranxianglei merged 1 commit into
masterfrom
2026-09-27_agents-config-surface-discipline
Sep 27, 2026
Merged

ranxianglei merged 1 commit into
masterfrom
2026-09-27_agents-config-surface-discipline

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

Owner directive (2026-09-27): every addition/change of configuration must be explicitly reported with sufficient justification. Self-initiated new config that ignores the existing system — like today's plugin.nonHttpProviders beside the providers table — is rejected on principle; don't even build it without prior owner sign-off.

Adds ### Configuration Surface Discipline (owner-gated) to §3 Development Standards:

  1. PRs touching config MUST carry a "config surface" section (what/why-not-existing-surface/alternatives-considered/compat story) — absent = incomplete.
  2. Agents never invent config shapes on their own initiative: file the proposal with a mapping onto the existing system (providers table key species, three-level compress hierarchy, env conventions, launcher↔extension channels) and wait.
  3. Only exception: explicit owner sign-off in-thread BEFORE implementation, recorded with the design rationale.

Cites the canonical case: #1437's first draft (plugin.nonHttpProviders) → reworked into providers[<name>].compactionOptIn, follow-up #1469. Pure docs change (AGENTS.md only); no code, no version bump.

…s, explicit reporting, no self-initiated config shapes
@github-actions

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-09-27_agents-config-surface-discipline (08a1e72)

Option A — Install from npm PR tag (recommended)

npm install -g billion-context@pr-1471

Each push to this PR publishes a new version under the pr-1471 npm tag.

Option B — Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr1471.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei
ranxianglei merged commit a57ab8d into master Sep 27, 2026
12 checks passed
@ranxianglei
ranxianglei deleted the 2026-09-27_agents-config-surface-discipline branch October 15, 2026 05:32
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.

1 participant