Skip to content

docs(skills): prompting validators — point, don't paste - #10

Merged
rschumann merged 1 commit into
mainfrom
docs/point-dont-paste
Oct 3, 2026
Merged

rschumann merged 1 commit into
mainfrom
docs/point-dont-paste

Conversation

@rschumann

Copy link
Copy Markdown
Contributor

Summary

Adds "Prompting validators: point, don't paste" to the using-lope and lope skills, with a one-line pointer in ask, compare, deliberate, execute, negotiate, pipe, review and vote.

Learned on a 14-round plan review (2026-10-03) that only converged after these changes. agy was READY from round 7 on; Codex's findings went 7→5→4→2→3→4→1→0→0.

  • Point, don't paste: a short prompt with absolute paths, not ~90 KB of pasted files.
  • No shell commands for headless validators: agy denies them, and a denied command ends with empty output (parse_error).
  • Diagnose empty answers by running the CLI directly and reading stderr.
  • Codex directly when its stderr would pass lope's 512 KB cap, wrapped in timeout 1800 (1000 s killed a run with no report).
  • Converging reviews: a fixed PASS/FAIL checklist file, a "decided on purpose" list, and a stop rule (every validator clean in the same round, twice in a row).

Docs only; no code change.

🤖 Generated with Claude Code

Lessons from a 14-round plan review that converged only after these changes:
- send a short prompt with absolute file paths instead of pasting files;
- tell headless validators (agy) to run no shell commands: a denied
  command ends the run with empty output;
- diagnose an empty answer by running the CLI directly and reading stderr;
- run Codex directly when its stderr would pass lope's 512 KB cap, and
  give it `timeout 1800` (it writes only at the end);
- make reviews converge with a fixed PASS/FAIL checklist, a "decided on
  purpose" list and a stop rule.

The full section is in using-lope and lope; the other skills point to it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@rschumann
rschumann merged commit 8485221 into main Oct 3, 2026
4 checks passed
@rschumann
rschumann deleted the docs/point-dont-paste branch October 11, 2026 08:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant