Lint a One-Page Charter Before an Agent Pilot Starts

Описание и применение

Автоматический линтер проверяет шаблон чарта перед запуском пилота, гарантируя наличие всех обязательных полей и отсутствие заполнителей, что снижает количество неудачных пилотов.

Задача

Agent pilots often fail due to unclear ownership, incomplete handoffs, and missing exit criteria, leading to repeated failures and wasted effort.

Результат

Automated linting prevents pilots from starting with incomplete charters, reducing failures and ensuring clear ownership and exit paths.

Рабочий процесс

• 1. Draft the one‑page charter on the wiki. 2. Run charter_lint.py against the charter file in CI. 3. If lint passes, create the pilot branch. 4. Use Git notes to stamp each handoff (scout→scribe→signer). 5. Monitor logs and alerts as defined in the scope. 6. If stop_rule triggers, execute the revert command. 7. Review at the scheduled date and merge if approved.

Доказательства

The linter is the cheap part. It catches placeholders, missing roles, and a revert path that was never written.

Источник

Wire it into the same job that opens the pilot branch. A branch without a passing charter should not exist.

Источник