Skip to content
This repository was archived by the owner on Apr 12, 2026. It is now read-only.
This repository was archived by the owner on Apr 12, 2026. It is now read-only.

[kernel] Integrate Preflight protocol into AgentGuard governance hooks #1493

@jpleva91

Description

@jpleva91

Integrate Preflight Protocol

Context

Preflight (AgentGuardHQ/preflight) is a universal design-before-you-build protocol for AI agents. AgentGuard should be able to detect and enforce Preflight compliance via its existing governance hook system.

Proposal

Add Preflight awareness to AgentGuard's pre/post tool use hooks:

  • Detect when an agent attempts to write code (Edit/Write/Bash) without completing Preflight phases
  • Track Preflight phase completion in telemetry
  • Optionally block code-writing tool calls until Orient/Clarify/Approach/Confirm phases are logged
  • Report Preflight skip rates in governance dashboards

Why Now

Preflight v1 ships as prompt discipline only. AgentGuard integration adds mechanical enforcement — the agent can't just ignore the prompt. This is the bridge between v1 (protocol) and v2 (MCP enforcement per #1492).

Squad

Owner: kernel
Priority signal: 🟡 important (after Preflight v1 ships)

Open Questions

  • How to detect phase completion without MCP? (Parse agent output? Require structured markers?)
  • Should enforcement be opt-in via agentguard.yaml policy?

Filed from /brainstorm session — Preflight design spec

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent:claimedAgent dispatched — do not re-dispatchenhancementNew feature or requestpriority:mediumMedium prioritysprintCurrent sprint priority

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions