|
|
@@ -16,9 +16,9 @@ No intro, no closing, no repeats.
|
|
|
|
|
|
## Pattern
|
|
|
|
|
|
-<nth><Where the problem is, in one sentence>.
|
|
|
+<nth: problem number starting from 1><Where the problem is, in one sentence>.
|
|
|
|
|
|
-- Problem: <what happens now and why it's wrong>.
|
|
|
+- Problem: what it does today, then the cause of the defect. State the mechanism, not just the symptom. No judgment.
|
|
|
- Proposed fix: <what to do instead>.
|
|
|
- Verification: <how to check it works, including edge cases>.
|
|
|
|
|
|
@@ -29,6 +29,7 @@ No intro, no closing, no repeats.
|
|
|
- Verification: the cases to test, with expected result. Include at least one case that looks like it passes today but shouldn't.
|
|
|
|
|
|
## Rules
|
|
|
+- Problem must name the cause, not only the symptom.
|
|
|
- Short sentences. One item = one line.
|
|
|
- Plain language: no jargon unless needed.
|
|
|
- Verification must be observable: input → expected output.
|
