Skip to content

Add scope-discipline directives to the always-on working-style standard - #1

Merged
assert-not-singularity merged 3 commits into
mainfrom
claude/overcomplication-backward-compat-sm1406
Aug 29, 2026
Merged

Add scope-discipline directives to the always-on working-style standard#1
assert-not-singularity merged 3 commits into
mainfrom
claude/overcomplication-backward-compat-sm1406

Conversation

@assert-not-singularity

Copy link
Copy Markdown
Owner

Why

Agents frequently overcomplicate solutions — preserving backward compatibility nothing depends on, generalizing beyond the ask, re-deriving values the input already states, or extending every layer a pattern touches. The always-on working-style.md standard covered honesty and propose-before-acting but had nothing on scope minimalism, while scalable-architecture.md nudges the other way (ports/adapters, boundary validation). This adds the missing always-in-context counterweight.

What changed

All in plugin/templates/standards/working-style.md (the always-on standard, so it applies to every task in every repo that installs preflight):

  • Prefer the simplest solution. Don't add backward-compatibility shims, dead code paths, or versioning that nothing depends on. Keep compatibility only where a real consumer relies on it (a versioned/published API, an SLA, a production pipeline, a persisted data format) — and when genuinely unsure, ask instead of defensively keeping both paths.
  • Solve the specific ask, not its generalization. No generalized version until a second concrete caller exists — with an explicit carve-out so it doesn't contradict scalable-architecture's single-implementation interfaces for test fakes / swappable I/O boundaries.
  • Don't re-derive what the input already states. Read the authoritative value rather than building a parallel second source of truth.
  • Name the defect in one sentence, then make that sentence false. Let that sentence bound the fix.
  • Justify each touched file against the requirement, not architectural symmetry. Mirror pattern shape, not breadth.

Also:

  • Updated the README summary of working-style.
  • Bumped the plugin version 0.1.0 → 0.2.0 so /preflight:update surfaces the change to already-scaffolded projects.

Notes

  • Kept as a flat bullet list (no new sub-heading) to match the file's existing structure and leanness mandate.
  • Deliberately did not touch scalable-architecture.md — the new always-on bullets already supply the counterweight it was missing, and the generalization bullet explicitly defers seam decisions back to that rule where a project follows it.

🤖 Generated with Claude Code


Generated by Claude Code

claude added 3 commits August 29, 2026 09:29
…ndard

Encode a standing principle against over-engineering for backward
compatibility that nothing depends on. The default is the simplest design;
compatibility is preserved only where a real consumer relies on it (a
versioned/published API, an SLA, a production pipeline, or a persisted data
format), and genuine uncertainty is resolved by asking rather than keeping
both code paths.

Update the README summary of working-style to match, and bump the plugin
version so /preflight:update surfaces the change to already-scaffolded
projects.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TsB9nGcmkk7WtAqfQ5Mq61
The always-on standard had one bullet on preferring simplicity but nothing
on scope minimalism during implementation, while scalable-architecture nudges
toward adding structure. Add four directives so the counterweight is in
context on every task: solve the specific ask (not its generalization until a
second caller exists), don't re-derive what the input already states, bound
the fix by a one-sentence statement of the defect, and justify each touched
file against the requirement rather than architectural symmetry.

Refocus the existing "prefer the simplest solution" bullet on backward
compatibility so it doesn't overlap the new generalization directive, and
update the README summary.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TsB9nGcmkk7WtAqfQ5Mq61
The "solve the specific ask" bullet's absolute rule-of-two forbade the
single-implementation interface that scalable-architecture intentionally
permits for test fakes and swappable I/O boundaries. Soften MUST NOT to a
heuristic and carve out I/O seams as a present need governed by that rule,
keeping the anti-over-build teeth for feature generality.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TsB9nGcmkk7WtAqfQ5Mq61

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

Changes are limited to documentation/standards text plus a straightforward manifest version bump with no apparent behavioral risk.

Pull request overview

This PR updates the always-on working-style standard to add explicit “scope discipline” directives that steer agents toward minimal, non-overgeneralized implementations, and surfaces that update via documentation and a plugin version bump.

Changes:

  • Added new working-style bullets covering simplest-solution bias, avoiding premature generalization, not re-deriving stated inputs, bounding fixes with a one-sentence defect, and justifying touched files by requirement.
  • Updated the README’s summary line for working-style to reflect the new scope-discipline emphasis.
  • Bumped the plugin manifest version from 0.1.0 to 0.2.0 so updates are discoverable via /preflight:update.
File summaries
File Description
README.md Updates the working-style row summary to mention scope discipline / simplest-solution guidance.
plugin/templates/standards/working-style.md Adds new always-on bullets that constrain scope, avoid unnecessary compatibility/generalization, and bound fixes.
plugin/.claude-plugin/plugin.json Increments plugin version to surface the updated always-on standard to existing installs.
Review details
  • Files reviewed: 3/3 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@assert-not-singularity
assert-not-singularity merged commit bc1bfc1 into main Aug 29, 2026
1 check passed
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.

3 participants