Skip to content

Keel v3.1.0

Choose a tag to compare

View all tags
@joseconti joseconti released this 16 Jul 20:40
v3.1.0
316a4d7

The verification loop closes over the end-user guide, and code comments become a reviewed contract.

Added

  • guide-qa — the eighth verifier subagent (references/assistant-config.md). Conditional like its siblings: generated at Phase 6 on first need, once the end-user guide decision is yes (the decision does not exist earlier). Fresh context, read-only: it receives ONLY guide/ plus the capability and settings lists, and verifies mechanical coverage (every capability and every setting has its guide section, troubleshooting covers the debug-log switch), that every internal link and image resolves (the offline rule), that every task's steps are followable exactly as written, per-locale orthography, and the guide's own accessibility basics. The session that wrote the guide no longer self-certifies it: Phase 6 runs guide-qa at the guide check, and the Phase 7 gate re-runs it on the exact release candidate when the guide ships in the package — inline with the standing fallback when the environment has no subagents.
  • Comments are a reviewed contract. The code-style rule gains its comments line and code-reviewer gains check (7): every public surface in the diff carries its docblock per the platform's convention (purpose, params, return), non-obvious decisions carry a why comment, and comment language follows the recorded policy (English by default). Phase 5's slice loop writes them at creation — "Comment the code as you write it", never backfilled later — exactly like docs and accessibility.

Changed

  • Phase 6 definition of done: the docs/api/INDEX.md one-to-one check is delegated to docs-verifier when the environment provides subagents (inline otherwise), and the guide's mechanical coverage check names guide-qa as its runner.
  • MANIFEST Table 3 carries the v3.1.0 reconciliation delta: on projects with the assistant config package accepted, regenerate code-reviewer and the code-style rule in every capable container; where the User guide: card line is yes and guide/ exists, generate guide-qa at the next Phase 6 or maintenance touch.
Assets 2
Loading