Skip to content

[Extension]: Update Agent Governance to v1.2.0 #2624

@bigsmartben

Description

@bigsmartben

This is an update to the existing agent-governance community catalog entry. The extension is already listed in extensions/catalog.community.json; this submission updates the version, download URL, description, required tool metadata, and behavior summary for v1.2.0.

Related previous submissions: #2552, #2569.

Extension ID

agent-governance

Extension Name

Agent Governance

Version

1.2.0

Description

Generate agent-platform repository governance files from Spec Kit metadata.

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.2.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

  • uv - required

Number of Commands

1

Number of Hooks

3

Tags

governance, agents, memory, context

Key Features

  • Generate or update the active agent platform governance file from Spec Kit integration metadata.
  • Initialize the internal governance cache from detected repository evidence and manifest-backed commands.
  • Preserve user-authored content outside managed SPECKIT GOVERNANCE markers.
  • Use the active managed section as the refresh source for reviewed governance changes.
  • Distill repository areas into concise action rules with depth limited to two directory levels, including hidden and cache directories.
  • Clean stale managed sections from known non-active agent context files.
  • Keep project-governance ownership external to this extension.

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:

  • macOS with Spec Kit specify 0.8.11
  • Repository test suite using uv

Commands run:

  • uv run python -m py_compile scripts/refresh_agent_governance.py tests/test_governance_domains.py
  • uv run pytest -q (22 passed)
  • git diff --check
  • specify extension add agent-governance --from https://github.com/bigsmartben/spec-kit-agent-governance/archive/refs/tags/v1.2.0.zip
  • In a temporary Spec Kit project, installed from the v1.2.0 release archive and ran uv run python .specify/extensions/agent-governance/scripts/refresh_agent_governance.py; it generated/updated AGENTS.md successfully.

Release:

Example Usage

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

/speckit.agent-governance.refresh

Proposed Catalog Entry

{
  "agent-governance": {
    "name": "Agent Governance",
    "id": "agent-governance",
    "description": "Generate agent-platform repository governance files from Spec Kit metadata.",
    "author": "bigben",
    "version": "1.2.0",
    "download_url": "https://github.com/bigsmartben/spec-kit-agent-governance/archive/refs/tags/v1.2.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",
      "tools": [
        {
          "name": "uv",
          "required": true
        }
      ]
    },
    "provides": {
      "commands": 1,
      "hooks": 3
    },
    "tags": [
      "governance",
      "agents",
      "memory",
      "context"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-03-31T00:00:00Z",
    "updated_at": "2026-05-19T00:00:00Z"
  }
}

Additional Context

This v1.2.0 update changes the extension from a memory-file-centered projection to an active managed-section SSOT flow. It also updates the required runtime tool from optional python3 to required uv, matching the command and validation workflow.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions