Generate How-To Skeletons From Signatures, Then Gate README Promises With a Lane File
Описание и применение
В workflow создаётся JSON‑инвентарь публичных функций, модель генерирует только skeletons, а человек подписывает утверждения о среде через lane‑файл, гарантируя, что README содержит только проверяемые сведения.
Задача
Drafting models often insert unverified promises into README how‑to docs, leading readers to accept unsupported claims such as incorrect install commands, unsupported extras, or fabricated output examples.
Результат
The workflow produces README how‑to docs that are free of unverified promises, reducing misinformation and installation errors.
Рабочий процесс
- 1. Run a script to walk the source tree and extract public functions, their signatures, and docstring presence into a JSON inventory.
- 2. Commit the inventory file to git and hash it for reference in future README diffs.
- 3. Feed the inventory to the LLM to generate section outlines, parameter tables, and procedure skeletons, leaving TODO(human) markers for steps that require execution.
- 4. Review the draft, identify any claim classes that the inventory cannot prove (e.g., install commands, extras, sample output).
- 5. Use a lane file to forbid the model from filling those claim classes; only human‑signed claims are allowed.
- 6. Sign the required environment claims beside the inventory hash, producing a gated README that contains only verifiable information.
Доказательства
An AST walk of public functions can prove names, argument lists, defaults, annotations, and docstring presence.
The fix is not a better prompt. The fix is a lane file that forbids the model from filling claim classes the inventory cannot support.
- Дата записи: 2026-09-21T19:45:19.202Z