Lint a One-Page Charter Before an Agent Pilot Starts

说明与用途

自动化 linter 在启动代理试点前验证章程，确保所有必需字段完整且无占位符，从而降低试点失败率。

问题

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.

来源