Dev & Engineering

OpenChamber Change Discipline

Enforces "smallest complete change, narrowest sufficient validation" discipline when modifying the OpenChamber codebase, preventing local fixes from ballooning into speculative rewrites.

52/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 12k
Last updated
11d ago
License
MIT
code-reviewchange-managementrefactoringrisk-classification
+4testing-strategytypescriptmonorepovalidation

What does this skill do, and when should you use it?

openchamber-change-discipline is one of 18 skills bundled in the OpenChamber repository (a desktop/web interface for the OpenCode AI agent), located at .agents/skills/openchamber-change-discipline/SKILL.md. It is a pure instruction-based methodology document with no scripts or tool dependencies. The skill mandates: inspecting nearby implementations, callers, and tests before editing; classifying each change by risk tier (local implementation, module contract, cross-workspace contract, persisted/external behavior, platform/runtime behavior); and validating at the narrowest level that covers the real risk. It also provides structural discipline rules (behavior preservation, dependency injection, no any types), review prompts, a validation matrix, and test design principles, ending with a completion standard.

  • Classify the intended change into five risk categories (local implementation, module contract, cross-workspace contract, persisted/external behavior, platform/runtime behavior) and assign an owner and required validation to each.
  • Select minimal validation from a matrix: package-scoped type-check and lint, workspace-wide checks, bun run dead-code for export changes, compatibility and round-trip tests for persisted contracts.
  • Apply structural discipline: preserve caller-established behavior, keep entrypoints thin, prefer explicit dependency injection, avoid any and blind casts, demand evidence for retries/caches/compatibility paths.
  • Answer explicitly what rolls back, what gets cleaned up, what can be retried, and what the user observes for destructive or multi-step work.
  • Run a final simplification pass removing speculative branches and shallow wrappers.
Good fit
  • A developer maintaining an OpenChamber-style multi-package monorepo who modifies exported APIs or types and needs to know which consumers are affected and which checks to run.
  • A team wanting to constrain an AI agent (or new contributor) from expanding a local fix into a workspace-wide rewrite, or from disguising an architectural migration as a local patch.
  • Changing persisted data, routes, or CLI output where compatibility, failure handling, and downgrade behavior must be explicitly considered.
  • Making Electron or VS Code platform-behavior changes where real runtime validation must replace static checks alone.
  • Designing regression tests that assert observable contracts rather than internal implementation details, keeping refactor tests resilient.
Not a fit
  • Projects unrelated to OpenChamber: the skill is coupled to specifics like bun run dead-code, the workspace structure, and Electron/VS Code platforms, so adapting it requires rewriting those details.
  • Trivial changes: the dense, lengthy instructions may feel heavy for small edits.
  • Teams wanting automation: the skill contains no scripts or check tooling — all validation depends on the executor actually running commands.

How do you install this skill?

Before you use it
  • The skill is tightly bound to the OpenChamber toolchain (bun, knip, multi-workspace scripts) and does not transfer to other projects.
  • All referenced validation commands (bun run dead-code, per-package test/lint) are statically cited only; none were executed or reproduced.
  • The skill file has no version number or changelog, making future revisions hard to track.
  • Publisher is unverified and treated as unknown; no points were added or deducted on that basis.
  • Core workflows depend on overseas services (GitHub, opencode.ai); reachability from mainland-China networks is unverified.

The skill ships with the OpenChamber repository. Obtain it by cloning https://github.com/openchamber/openchamber and using the skill at .agents/skills/openchamber-change-discipline/SKILL.md; the README does not document a separate install command for this skill. Agent Skills-standard clients typically only need the skill folder placed in their skills directory.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/openchamber/openchamber.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.agents/skills/openchamber-change-discipline" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • I'm changing an exported API type in OpenChamber — follow the change discipline to find affected consumers and decide which checks to run.
  • This change touches persisted settings data; classify the risk and define compatibility, round-trip, and failure behavior.
  • I fixed a local bug but want to expand it into a workspace-wide refactor — review whether the scope should grow per the change discipline.
  • Check the validation plan for this Electron platform-behavior change — are static checks enough?

Trigger it whenever implementing, fixing, refactoring, or otherwise modifying OpenChamber source, dependencies, exports, build configuration, generated assets, or module ownership. Example prompt: "I'm about to refactor this package's exported API — first classify the risks per change discipline and list every affected consumer and required validation." It also works as a pre-implementation checklist by having the agent answer the review prompts (is the new abstraction actually reused, can failure strand state, etc.).

What are this skill's strengths and limitations?

Pros
  • Offers a concrete validation matrix mapping change types to minimum checks, not abstract advice.
  • The risk classification table ties directly to planning consequences, making test scoping mechanical.
  • Definitions for destructive operations, data migration, and rollback semantics are explicit and deliberately restrained, resisting over-engineering.
  • Pure documentation with no runtime dependencies — portable to any Agent Skills-compatible client.
Limitations
  • Tightly coupled to the OpenChamber project context (bun run dead-code, workspace structure, Electron/VS Code platforms); adapting to other projects requires rewriting specifics.
  • Contains no automation scripts or check tooling — all validation depends on the executor actually running commands.
  • No independent test suite or evidence that the discipline reduces defects; the source provides no adoption metrics.
  • Dense and lengthy instructions may feel heavy for trivial changes.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
OpenChamber Change Discipline this page 52 · Use with care ★ 12k 11d ago MIT
Code Clarity Refactor 57 · Use with care ★ 107k 12d ago MIT
Change Size Review Guide ✓ OpenAI · Official 48 · Use with care ★ 129k 11d ago Apache-2.0
Tool Rename Compatibility Check ✓ Microsoft · Official 63 · Recommended ★ 194k 11d ago MIT
Workers Production Review 57 · Use with care ★ 3.1k 11d ago Apache-2.0

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
52/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust16 / 25 · 3.2/5

This is a pure process/discipline document: no scripts, no permissions, no external effects or data flows, so no red-line risk exists; it explicitly demands rollback, cleanup, and explicit outcomes for destructive work. Deducted for: attribution limited to the repository MIT license — the skill file itself has no authorship or version, and publisher identity is unverified.

2Reliability10 / 20 · 2.5/5

Internally self-consistent: the risk classification table, validation matrix, and completion standard align; it requires stopping on conflicting instructions rather than silently choosing, and reporting exactly what ran. Deducted for: nothing was executed; commands like 'bun run dead-code' depend on repository script availability, unverifiable statically — capped by the static calibration ceiling.

3Adaptability10 / 15 · 3.3/5

The description gives clear trigger conditions (implementing, fixing, refactoring OpenChamber source, dependencies, exports, build config), with well-scoped boundaries and explicit warnings against escalating local changes into workspace-wide ritual. Deducted for: hard binding to this specific monorepo (bun, knip, multi-workspace), no reuse across projects, no Chinese-language support declared.

4Convention8 / 15 · 2.7/5

Well-layered progressive disclosure (principle → risk classification → structural discipline → review prompts → validation matrix → test design → completion standard) with readable tables; the repo provides MIT license and SECURITY.md. Deducted for: the skill file itself lacks versioning, changelog, examples, FAQ, and an explicit maintenance/update path at the skill level.

5Effectiveness5 / 15 · 1.7/5

As a change-discipline guide, its smallest-complete-change, risk-classification, and validation-matrix methodology offers real marginal value for agents modifying this repository, with concrete actionable instructions. Deducted for: static review cannot verify outcomes; value depends on model adherence; no representative output evidence — capped by static calibration.

6Verifiability3 / 10 · 1.5/5

The repository contains real CI workflows, test scripts, and a manual checklist (shortcut-registry), providing partial corroboration for the validation processes the skill invokes. Deducted for: no evidence directly covers this skill file's key paths, no executed reproduction, and thin multi-source corroboration.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Sep 09, 2026 Reviewed revision f8b929edf989 Review evidence[1][2][3][4][5][6][7][8][9]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

More skills from this repository

All from openchamber/openchamber

Dev & Engineering

OpenChamber Performance Engineering Skill

Eliminate structural waste before micro-optimizing: a measurement-driven methodology for interaction, render, polling, cache, and high-volume data paths.

★ 12k FS 62 Recommended 11d ago
Dev & Engineering

serve-sim — iOS Simulator Remote Control from the Terminal

Boot, install, stream, and control a Capacitor iOS app in the Apple Simulator from your terminal — no Xcode needed.

★ 12k FS 52 Use with care 11d ago
Dev & Engineering

OpenChamber Sync State Invariants

A rulebook that enforces state ownership and failure semantics when agents change session sync, event reducers, polling, and caches — preventing destructive data loss and state corruption.

★ 12k FS 49 Use with care 11d ago
Dev & Engineering

Locale UI Patterns — OpenChamber UI Localization Rules

Enforces that every user-facing OpenChamber string gets a real translation in every language dictionary immediately — no English placeholders, ever.

★ 12k FS 61 Recommended 11d ago
Design & Frontend

OpenChamber Drag-to-Reorder Skill

A battle-tested @dnd-kit playbook that fixes the hardest drag-to-reorder bugs: variable-width items, wrapping layouts, and touch/mobile gesture conflicts.

★ 12k FS 59 Recommended 11d ago
Dev & Engineering

OpenChamber Relay Transport Skill

Build WebSocket, SSE, and streaming endpoints that actually work over OpenChamber's end-to-end encrypted relay tunnel, where desktop-only testing silently hides failures.

★ 12k FS 58 Recommended 11d ago
Dev & Engineering

OpenChamber UI/API Decoupling Skill

Enforces correct layering between SDK calls, RuntimeAPIs, and browser asset access when modifying OpenChamber's shared UI data layer — preventing hardcoding and cross-runtime state leaks.

★ 12k FS 58 Recommended 11d ago
Dev & Engineering

Clack CLI Patterns

Defines consistent interactive prompt, --quiet, and -- output contracts for OpenChamber terminal commands, so policy validation always precedes presentation in every run mode.

★ 12k FS 57 Use with care 11d ago
Design & Frontend

OpenChamber Theme System Skill

Enforces semantic theme tokens, shared button/icon contracts, and keyboard-navigation rules when modifying OpenChamber UI — no hardcoded colors or reinvented components.

★ 12k FS 57 Use with care 11d ago
Dev & Engineering

OpenChamber Desktop Shell Skill

Gives AI agents the correct architecture boundaries and security rules when changing OpenChamber's Electron main/preload code, IPC, or packaging.

★ 12k FS 54 Use with care 11d ago
Design & Frontend

OpenChamber Settings UI Patterns

A skill that makes AI agents build OpenChamber Settings pages from shared primitives, with localization and search-registry rules enforced instead of hand-rolled markup.

★ 12k FS 54 Use with care 11d ago

Related skills