[Extension]: Add Architecture Guard #4219

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