Testing/CI/tooling consistency (#9,#20,#21,#22,#23,#28) (#59)
Co-authored-by: claude <claude@jpaul.io> Co-committed-by: claude <claude@jpaul.io>
This commit was merged in pull request #59.
This commit is contained in:
@@ -22,8 +22,12 @@ When making a concrete change to an unfamiliar repo.
|
||||
1. **State the change in one sentence** and the acceptance criterion ("done when X").
|
||||
2. **Find the blast radius first:** search for every caller/usage of what you're about to touch.
|
||||
List them. If you can't enumerate them, you're not ready to change it.
|
||||
3. **Run the existing tests before touching anything** — establish a green baseline. If they were
|
||||
already red, note it; don't let a pre-existing failure get blamed on you.
|
||||
3. **Install the project's dependencies, then run the existing tests before touching anything** —
|
||||
establish a green baseline. Tell two failures apart: if the suite errors with missing imports,
|
||||
"no module named …", or "no tests ran," that's an **unconfigured environment**, not a baseline —
|
||||
finish the documented install (and pick a different repo if it still won't go green on a clean
|
||||
clone). A genuine **pre-existing failure** (install succeeded, but a real test fails) is the other
|
||||
case — note it so it doesn't get blamed on you, and don't build on top of it.
|
||||
4. **Make the minimal edit.** Keep it to the files identified in step 2.
|
||||
5. **Add or extend a test** that fails without your change and passes with it.
|
||||
6. **Run the full suite.** All green, including the baseline tests.
|
||||
|
||||
Reference in New Issue
Block a user