Skip to content

feat(agent-governor): add Codex workflow policy docs#4

Merged
ProfRandom92 merged 2 commits into
mainfrom
agent-governor-policy-v1
Jun 7, 2026
Merged

feat(agent-governor): add Codex workflow policy docs#4
ProfRandom92 merged 2 commits into
mainfrom
agent-governor-policy-v1

Conversation

@ProfRandom92
Copy link
Copy Markdown
Owner

Summary

Adds a lightweight CompText Agent Governor policy/documentation layer for Codex-style role, plugin, skill, Site, and annotation workflows.

This PR does not add runtime behavior. It documents how AI-agent repository work should remain bounded by deterministic context packs, policy gates, canonical evidence artifacts, and human review.

What Changed

  • Defines CompText Agent Governor positioning.
  • Adds Codex workflow policy for role-based agent work.
  • Adds documented agent PR policy.
  • Adds reusable agent-task issue template.
  • Adds Codex role workflow skill guidance.

Boundaries

  • No runtime provider calls.
  • No deploy behavior.
  • No autonomous approval.
  • No compliance, legal, forensic, official-SPARK, or production-readiness claim.
  • Sites/interactive views are presentation only.
  • Evidence packets remain the source of truth.
  • Annotations are review inputs, not silent artifact mutation.
  • Human review remains the approval boundary.

Validation

Document-only validation:

  • Scope check completed.
  • Claim-boundary scan completed.
  • Root README.md unchanged.
  • No generated report churn included.

Reviewer Checklist

  • Confirm this PR is documentation/policy only.
  • Confirm it preserves provider-output-as-untrusted.
  • Confirm Sites are described as presentation only.
  • Confirm annotations are described as review inputs.
  • Confirm no production/compliance/legal/forensic/official-SPARK/autonomous-approval claims are made.
  • Confirm it builds on merged SPARK Evidence Packet v1 from PR feat(sparkctl): add SPARK Evidence Packet v1 #3.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces the CompText Agent Governor Policy v1, establishing a lightweight policy layer for Codex-style role, plugin, connector, and skill workflows. It adds comprehensive documentation, a skill definition, a YAML policy configuration, and an issue template to guide agents and reviewers. Feedback on the changes suggests aligning the pipeline sequence terminology with existing documentation, explicitly listing all allowed gate states in the skill definition, and expanding the forbidden actions list in the issue template to ensure consistency with the PR policy.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/agent-governor.md Outdated
Comment thread .agents/skills/codex-role-workflows/SKILL.md Outdated
Comment thread docs/templates/agent-task-issue-template.md
@ProfRandom92 ProfRandom92 merged commit 65adf0e into main Jun 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant