docs: Add test-first methodology and org-thinking mandates

- Rule 10: Test-first - design tests before coding, run chaos testing
- Rule 11: Org as thinking medium - document investigations in prose
- Rule 12: Engineering decision audit trail - document root cause, tradeoffs

These mandates ensure rigorous verification and capture institutional knowledge.
This commit is contained in:
2026-04-23 06:47:24 -04:00
parent 5b6f4c18d1
commit 2b1f0f1b35

View File

@@ -39,6 +39,27 @@ Source code MUST be strictly free of hardcoded configuration values (e.g., ports
** 9. Literate-Only Modification (The Tangle Mandate)
You are strictly forbidden from modifying generated source code files (e.g., `.lisp`, `.py`, `.el`) directly. All changes MUST be made within the corresponding Literate Org file and then tangled to the source. Direct modification of source code is only permitted with explicit user authorization.
** 10. Test-First Methodology (Design Before Code)
Before implementing any fix or feature, you MUST:
1. Design the test/success criteria first - define what "works" means
2. Run chaos/edge-case testing - try to break the design
3. Only then implement the solution
This prevents debugging-by-trial-and-error and ensures rigorous verification.
** 11. Org as Thinking Medium (Investigation in Prose)
When debugging or analyzing issues:
1. Document your investigation in the relevant org file BEFORE implementing a fix
2. Record: root cause hypothesis, evidence found, tradeoffs considered
3. This makes the reasoning auditable and captures institutional knowledge
The org file IS the design document - code is just the implementation.
** 12. Engineering Decision Audit Trail
Every significant fix or architectural decision MUST be documented in the relevant org file with:
- Root cause analysis
- Options considered and tradeoffs
- Why this solution was chosen
This creates a searchable, literate history of engineering decisions.
* Phase B: Blueprint (PROTOCOL)
:PROPERTIES:
:STATUS: SIGNED