[Extension]: Add Agent Governance

[bigsmartben]

Extension ID

agent-governance

Extension Name

Agent Governance

Version

1.0.0

Description

Project-local agent governance memory and context projection.

Author

bigben

Repository URL

https://github.com/bigsmartben/spec-kit-agent-governance

Download URL

https://github.com/bigsmartben/spec-kit-agent-governance/archive/refs/tags/v1.0.0.zip

License

MIT

Homepage

https://github.com/bigsmartben/spec-kit-agent-governance

Documentation URL

https://github.com/bigsmartben/spec-kit-agent-governance/blob/main/README.md

Changelog URL

https://github.com/bigsmartben/spec-kit-agent-governance/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.8.0

Required Tools

• python3 - optional; the command includes manual fallback instructions if Python is unavailable.

Number of Commands

1

Number of Hooks

3

Tags

governance, agents, memory, context

Key Features

• Creates .specify/memory/agent-governance.md from a bundled governance template when missing.
• Detects the active Spec Kit integration from .specify/init-options.json and .specify/integration.json.
• Projects a concise managed SPECKIT GOVERNANCE section into the active agent context file.
• Preserves user-authored content outside the managed markers.
• Removes stale managed governance sections from known non-active agent context files.
• Registers optional hooks after constitution, plan, and tasks workflows.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on:

• Linux with Spec Kit source checkout and local CLI execution via uv --project /home/administrator/github/spec-kit run specify.
• Generated Spec Kit project initialized with Codex integration.

Test scenarios:

1. Validated extension.yml with specify_cli.extensions.ExtensionManifest.
2. Ran python3 -m py_compile scripts/refresh_agent_governance.py.
3. Installed locally with specify extension add --dev /home/administrator/github/spec-kit-agent-governance.
4. Verified Codex skills registration created .agents/skills/speckit-agent-governance-refresh/SKILL.md.
5. Installed from the release archive URL.
6. Ran .specify/extensions/agent-governance/scripts/refresh_agent_governance.py and verified the managed governance markers and active integration were written to AGENTS.md.

Example Usage

# Install extension
specify extension add agent-governance --from https://github.com/bigsmartben/spec-kit-agent-governance/archive/refs/tags/v1.0.0.zip

# Use the generated agent command
/speckit.agent-governance.refresh

# Codex skills mode may expose it as
$speckit-agent-governance-refresh

Proposed Catalog Entry

{
  "agent-governance": {
    "name": "Agent Governance",
    "id": "agent-governance",
    "description": "Project-local agent governance memory and context projection.",
    "author": "bigben",
    "version": "1.0.0",
    "download_url": "https://github.com/bigsmartben/spec-kit-agent-governance/archive/refs/tags/v1.0.0.zip",
    "repository": "https://github.com/bigsmartben/spec-kit-agent-governance",
    "homepage": "https://github.com/bigsmartben/spec-kit-agent-governance",
    "documentation": "https://github.com/bigsmartben/spec-kit-agent-governance/blob/main/README.md",
    "changelog": "https://github.com/bigsmartben/spec-kit-agent-governance/blob/main/CHANGELOG.md",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.8.0"
    },
    "provides": {
      "commands": 1,
      "hooks": 3
    },
    "tags": [
      "governance",
      "agents",
      "memory",
      "context"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-05-14T00:00:00Z",
    "updated_at": "2026-05-14T00:00:00Z"
  }
}

Additional Context

This was repackaged as an external extension after PR feedback requested publication in an independent GitHub repository for community catalog inclusion.

[mnriem]

Thank you!