Skip to content

[Extension]: Add Architecture Guard #4219

Description

@DyanGalih

Extension ID

architecture-guard

Extension Name

Architecture Guard

Version

2.3.6

Description

Framework-agnostic architecture governance for Spec Kit workflows, detecting drift, enforcing architectural rules, and generating actionable refactor tasks.

Author

DyanGalih

Repository URL

https://github.com/DyanGalih/architecture-guard

Download URL

https://github.com/DyanGalih/architecture-guard/archive/refs/tags/v2.3.6.zip

License

MIT

Homepage

https://github.com/DyanGalih/architecture-guard

Documentation URL

https://github.com/DyanGalih/architecture-guard/blob/main/SPECKIT-INTEGRATION.md

Changelog URL

https://github.com/DyanGalih/architecture-guard/blob/main/docs/release-notes.md

Required Spec Kit Version

>=0.1.0

Required Tools

  • Node.js (>=18) - required for standalone CLI usage
  • npm/npx - required for installation and CLI execution
  • Spec Kit - required for native Spec Kit extension commands

Number of Commands

18

Number of Hooks

3

Tags

architecture, governance, review, refactor, workflow

Key Features

  • Governed discovery, specification, planning, task, implementation, and archive workflows
  • Architecture and Constitution violation detection
  • Architecture-aware implementation reviews
  • Automatic generation of non-blocking refactor tasks
  • DRY and repository hygiene checks
  • Flash-Mem architectural context integration
  • Ponytail pragmatism guidance for AI-assisted development
  • Support for Spec Kit, OpenSpec, and generic Markdown workflows
  • Explicit approval gates for artifact, memory, Git, and cleanup operations

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 Node.js 18+
  • Spec Kit-compatible projects

Test project: Architecture Guard repository

Test scenarios:

  1. Installed the extension from the v2.3.6 release archive.
  2. Verified the extension.yml manifest.
  3. Executed the governed workflow commands.
  4. Verified architecture review and refactor-task output.
  5. Ran the automated test suite.

Result: 21 automated tests passing.

Example Usage

# Install the extension
specify extension add architecture-guard \
  --from https://github.com/DyanGalih/architecture-guard/archive/refs/tags/v2.3.6.zip

# Governed delivery workflow
/speckit.architecture-guard.ag-governed-delivery

# Review implementation
/speckit.architecture-guard.ag-review-implementation

# Verify the completed feature
/speckit.architecture-guard.ag-verify

Proposed Catalog Entry

{
  "architecture-guard": {
    "name": "Architecture Guard",
    "id": "architecture-guard",
    "description": "Framework-agnostic architecture governance for Spec Kit workflows, detecting drift, enforcing architectural rules, and generating actionable refactor tasks.",
    "author": "DyanGalih",
    "version": "2.3.6",
    "download_url": "https://github.com/DyanGalih/architecture-guard/archive/refs/tags/v2.3.6.zip",
    "repository": "https://github.com/DyanGalih/architecture-guard",
    "homepage": "https://github.com/DyanGalih/architecture-guard",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.1.0"
    },
    "provides": {
      "commands": 18
    },
    "tags": [
      "architecture",
      "governance",
      "review",
      "refactor",
      "workflow"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-08-16T00:09:59Z",
    "updated_at": "2026-08-20T00:00:00Z"
  }
}

Additional Context

Architecture Guard also supports standalone orchestration with OpenSpec and generic Markdown workflows while maintaining a native Spec Kit extension delivery channel.

Release: https://github.com/DyanGalih/architecture-guard/releases/tag/v2.3.6

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions