docs(AGENTS): add utils-lisp mandate for Lisp structural operations
- NEW: REPL-first workflow requirement - NEW: Must use utils-lisp functions for any .lisp work - NEW: Never use edit tool on .lisp files directly - NEW: Post-task verification: REPL verified + utils-lisp used
This commit is contained in:
@@ -105,7 +105,15 @@ This agent MUST verify these conditions before, during, and after each task. Vio
|
||||
|
||||
### During Task (Literate Programming)
|
||||
|
||||
- [ ] **Org-only edits** — Edit only `.org` files, never generated `.lisp` directly
|
||||
- [ ] **REPL-first workflow** — Explore in REPL before writing code
|
||||
- [ ] **Utils-lisp for structural ops** — Use these functions for any .lisp work:
|
||||
- `utils-lisp-structural-extract` — Extract function definitions
|
||||
- `utils-lisp-structural-inject` — Inject forms into definitions
|
||||
- `utils-lisp-structural-wrap` — Wrap code in let/progn
|
||||
- `utils-lisp-validate` — Validate code before commit
|
||||
- `repl-eval` — Test code in REPL
|
||||
- `repl-inspect` — Inspect variables/functions
|
||||
- [ ] **Never use edit tool on .lisp** — Only edit .org files; never touch generated .lisp directly
|
||||
- [ ] **One function per block** — Each `#+begin_src` block contains exactly one definition
|
||||
- [ ] **Prose before code** — Every block preceded by explanatory text
|
||||
- [ ] **Prose includes**: What the function does, arguments, return value, rationale
|
||||
@@ -114,6 +122,8 @@ This agent MUST verify these conditions before, during, and after each task. Vio
|
||||
|
||||
### After Task (Validation)
|
||||
|
||||
- [ ] **REPL verified** — Code tested in REPL before commit (not just text edit)
|
||||
- [ ] **Utils-lisp used** — Confirmed structural operations went through utils-lisp
|
||||
- [ ] **Tests pass** — Run full test suite; 100% pass required
|
||||
- [ ] **Chaos tier 1** — Deterministic regression tests pass
|
||||
- [ ] **No artifacts** — No orphaned `.bak`, `.log`, `.tmp`, or untracked test files
|
||||
|
||||
Reference in New Issue
Block a user