We made our agent plans portable. Then we had to make them verifiable.

Description and use

Agent plans were portable but lacked structural consistency. A deterministic validator and GitHub workflow now enforce checks in CI, catching mismatches before merge.

Problem

Plans for AI agents were portable but not structurally consistent across repositories, leading to unnoticed mismatches.

Outcome

Validator caught structural issues in six repositories, preventing potential agent misexecution.

Workflow

• Define shared planning methodology
• Create reusable GitHub workflow for validation
• Add validator to CI to check active plans
• Include local template checks for boilerplate
• Run validator on every plan change
• Flag structural violations before merge

Evidence

The validator checks that those elements are present and consistently structured.

Source

Across six repositories, the validator caught problems in plans that agents were already using.

Source