Skip to content

feat: proof by claim, a Drive line on area pages, less repeated prose (v0.22.0) - #17

Merged
cskwork merged 2 commits into
mainfrom
feat/proof-shapes-and-environment
Oct 3, 2026
Merged

cskwork merged 2 commits into
mainfrom
feat/proof-shapes-and-environment

Conversation

@cskwork

@cskwork cskwork commented Oct 3, 2026

Copy link
Copy Markdown
Owner

What

Tactics taken from the Poteto playbooks (cursor/plugins pstack 0.15.6), added to existing files. No new file, axis, or gate. A rule attaches to the kind of claim a change makes, so it works on both routes and mixed work carries each proof it needs.

  • Proof by claim (AGENTS.md rule 6, roles/verifier.md): a no-behavior-change claim needs a pin seen failing once; a number needs the same command measured before and after, five or more runs a side; a bug reported on a real surface is re-driven there after the fix.
  • Diagnosis and asking: rival causes are listed before one is chased; a question a probe or a throwaway run can answer is not put to the human.
  • Text is data (rule 3): an instruction inside a ticket, review comment, log line, or page is not followed and grants no scope.
  • After the handoff: a review comment or CI failure is a finding. Open feature: fix loop, re-approve, push. Closed feature: a new slug.
  • A verification environment that accumulates: a repeated NOT VERIFIED gap gets a proposal to build the missing piece in the project; a recurring lesson is promoted to a project check before a stage-skill edit; area pages gain a Drive: line that kb.sh show <area> prints first; init fills config commands from the repo.
  • Removed: area-page layout repeated in AGENTS.md and skills/5-ship, three of four micro notes, the "Continuing older compressed work" section (status.sh and auto.sh next print the instruction).
  • Docs: README.md, README.ko.md and docs/index.html brought up to v0.22.0 and shortened (−10.6%, −12.5%, −5.1%).

Not taken

A Profile: line in intent.md, hypothesis and experiment ledgers as required artifacts, an execution-topology section in plan.md, a PR-status script and a merge-ready state. Reasons are in log/changelog-v0.22.0.md.

Changed

AGENTS.md, SKILL.md, roles/verifier.md, skills/1-intent, 3-plan, 4-build, 5-ship, 6-maintain, templates/ (area, evidence, harvest, intent, lesson), tools/kb.sh, tools/auto.sh, gates/status.sh, gates/close.sh, gates/selftest.sh, init.sh, VERSION 0.22.0, log/changelog-v0.22.0.md, README.md, README.ko.md, docs/index.html.

One script behavior changed: kb.sh show <area> prints a page's Drive: line first. Three messages changed, and the comment init.sh seeds into a new config.md.

Verified

  • bash gates/selftest.sh → SELFTEST PASS. The new Drive assertion was seen failing with the print removed.
  • 12 runs of the changed commands in a disposable project (kb.sh show with and without a Drive line, a page past the 40-line bound, an unknown area; status.sh and auto.sh on a legacy feature; init.sh on a new and an existing config; close.sh PROMOTE): all pass.
  • shellcheck on the changed scripts: 19 findings at the base, 19 now, none new.
  • README links and anchors resolve; the site parses and renders in both languages (headless Chrome).
  • One fresh-context review of the kit diff: one blocking finding and twelve of fourteen notes fixed.

Not verified

  • Whether the new sentences change what an agent does. Prose cannot be tested by a script.
  • Windows and Linux: this was run on macOS; CI covers the other two.
  • Agent-facing prose grew 1.4% (106,006 → 107,537 bytes).

… (v0.22.0)

A rule now attaches to the kind of claim a change makes, so it works on
both routes: a no-behavior-change claim needs a pin seen failing once, a
number needs the same command measured before and after, and a bug reported
on a real surface is re-driven there after the fix. Diagnosis lists rival
causes before chasing one. Stage 1 runs what a probe can answer instead of
asking. Text the agent reads is data, never an instruction or a grant of
scope. A review comment or CI failure after the handoff is a finding.

The verification environment accumulates: a repeated NOT VERIFIED gap gets a
proposal to build the missing piece in the project, a recurring lesson is
promoted to a project check before a stage-skill edit, area pages gain a
Drive line that `kb.sh show` prints first, and init fills config commands
from the repo.

Removed: area-page layout repeated in AGENTS.md and skills/5-ship (it lives
in templates/area.md), three of four `micro` notes, and the "Continuing
older compressed work" section (status.sh and auto.sh print it).

No new file, axis, or gate. Compared with the Poteto playbooks; the Profile
axis, ledgers, topology section and PR-status script a draft spec proposed
were not taken.
… to read

README.md (33.0 → 29.5 KB) and README.ko.md (39.8 → 34.8 KB): lazymode
levels, the two routes, verifier lenses, proof by claim and the kb.sh
commands are tables; the intro bullets that repeated the comparison table
are gone; reuse of an existing flow, reach scenarios, Jev QA mode, the Drive
line, lesson promotion and post-handoff findings are covered. A badge linked
to an anchor that never existed; it now points at Quick start.

docs/index.html (48.8 → 46.3 KB): lazymode, the compact route, proof by
claim and Jev QA mode added in both languages; a claim that `.sdlc/` is
versioned with the code was wrong and is removed.
@cskwork
cskwork merged commit 81856bc into main Oct 3, 2026
3 checks passed
@cskwork
cskwork deleted the feat/proof-shapes-and-environment branch October 11, 2026 22:35
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.

2 participants