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:
2026-04-30 11:17:45 -04:00
parent 15e45e57e8
commit f858b86b64
3 changed files with 13 additions and 1 deletions

View File

@@ -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

View File

@@ -0,0 +1 @@
user@amr.154851:1777155215

1
notes/.#gemini-vision.org Symbolic link
View File

@@ -0,0 +1 @@
user@amr.154851:1777155215