operating-kit / rules

---
description:
globs: **/*.{ts,tsx,js,jsx,py,go,rb,rs,java,kt,php,c,h,cpp,cs,swift,scala,sql}
alwaysApply: false
---

# Code-change discipline (auto-attached when editing code)

Before any non-trivial edit, follow @docs/claude/vigilance-protocol.md:
- Re-read the **whole function** before each edit (state from a prior edit invalidates assumptions).
- Treat any reported bug as a **hypothesis**: read the code and write a verdict before fixing.
- **3 edits to one file = STOP**: consolidate into one fix and state the invariant it preserves.
- Trace every write to every reader before changing a field's semantics.

Scan @docs/claude/field-notes.md before you deploy, migrate, gate a feature, or trust a build
artifact. Those are the failures that pass every local test and surface in production.

> Tune the `globs` above to this project's actual source directories/extensions.

More agent context in Sharrmavishal/operating-kit

4 other files this repository gives its agents.