docs: Add self-enforcement checklist to AGENTS.md
- Before task gate (git clean, skill query, GTD read) - During task LP rules (org-only, one function per block, prose) - After task validation (tests pass, chaos tier 1, no artifacts) - References to authoritative skill org files This makes the mandate enforceable, not just documentation.
This commit is contained in:
@@ -92,6 +92,43 @@ Violating these rules corrupts the skill loader and causes boot failure (as seen
|
||||
- **Testing**: Run FiveAM test suite + chaos tests before marking task complete
|
||||
- **Completion**: Update gtd.org, commit, sync with user
|
||||
|
||||
## Self-Enforcement Checklist
|
||||
|
||||
This agent MUST verify these conditions before, during, and after each task. Violation is a bug, not a suggestion.
|
||||
|
||||
### Before Any Task (Gate)
|
||||
|
||||
- [ ] **Git clean** — Working tree must be clean before modification
|
||||
- [ ] **Skill query** — Check if relevant skill exists in `/home/user/memex/projects/opencortex/skills/`
|
||||
- [ ] **Skill read** — If found, read the skill's org file before proceeding
|
||||
- [ ] **GTD read** — Check `gtd.org` for current task context
|
||||
|
||||
### During Task (Literate Programming)
|
||||
|
||||
- [ ] **Org-only edits** — Edit only `.org` files, never 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
|
||||
- [ ] **Evaluate each block** — Verify the block compiles/evaluates correctly
|
||||
- [ ] **Paren balance** — Check balanced parentheses before tangling
|
||||
|
||||
### After Task (Validation)
|
||||
|
||||
- [ ] **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
|
||||
- [ ] **Commit** — Stage and commit changes with descriptive message
|
||||
- [ ] **GTD update** — Update `gtd.org` with completed task state
|
||||
|
||||
### For OpenCortex Work Specifically
|
||||
|
||||
Reference authoritative skill files:
|
||||
- Engineering Standards: `projects/opencortex/skills/org-skill-engineering-standards.org`
|
||||
- Literate Programming: `projects/opencortex/skills/org-skill-literate-programming.org`
|
||||
- Policy: `projects/opencortex/skills/org-skill-policy.org`
|
||||
|
||||
The summaries in this file are reminders; the skill org files are authoritative.
|
||||
|
||||
## References
|
||||
|
||||
- opencortex repo: `/home/user/memex/projects/opencortex`
|
||||
|
||||
Reference in New Issue
Block a user