[Extension]: Update arch to v1.2.1

[bigsmartben]

Extension ID

arch

Extension Name

Architecture Workflow

Version

1.2.1

Description

Generate or reverse project-level 4+1 architecture views as separate commands.

Author

bigsmartben

Repository URL

https://github.com/bigsmartben/spec-kit-arch

Download URL

https://github.com/bigsmartben/spec-kit-arch/archive/refs/tags/v1.2.1.zip

License

MIT

Homepage

https://github.com/bigsmartben/spec-kit-arch

Documentation URL

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

Changelog URL

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

Required Spec Kit Version

=0.8.10.dev0

Required Tools

None.

Number of Commands

10

Number of Hooks

0

Tags

architecture, 4plus1, workflow, design

Key Features

• Provides .arch namespaced commands for each 4+1 view: scenario, logical, process, development, and physical.
• Provides separate forward-generation and reverse-generation commands for every view.
• Records reverse workflow evidence in .specify/memory/architecture-repo-facts.md.
• Consumes optional repository-first dependency matrices and module invocation specs as reverse workflow evidence.
• Allows teams to update one architecture view at a time while preserving the cross-view synthesis boundary.
• Defines synthesis readiness, repo-facts merge behavior, and source traceability expectations for repeatable command runs.
• Ships a schema-backed artifact contract for structured validation before Markdown rendering.
• Restricts writes to documented .specify/memory/architecture*.md files, including repo facts for reverse generation.

Testing Checklist

• Extension installs successfully via download URL.
• Command registration is validated by Spec Kit CLI; all 10 command files are packaged and listed after install.
• Documentation is complete and accurate.
• No security vulnerabilities identified in extension packaging or command registration changes.
• Tested on a temporary Spec Kit 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.

Testing Details

This is an update to the existing arch community catalog entry.

Tested on Windows with Spec Kit CLI 0.11.3.dev0 using a temporary Spec Kit project.

Validation performed:

1. Created GitHub releases for v1.2.0 and v1.2.1.
2. Marked v1.2.0 as deprecated/pre-release because its four-part command IDs failed Spec Kit CLI validation.
3. Verified v1.2.1 release ZIP install:

specify extension add arch --from https://github.com/bigsmartben/spec-kit-arch/archive/refs/tags/v1.2.1.zip --force

4. Confirmed the CLI lists all 10 commands after installation, including speckit.arch.scenario-generate and speckit.arch.scenario-reverse.
5. Verified the release package includes schemas/architecture-artifacts.schema.json.
6. Ran the installed PowerShell setup helper and confirmed it emits ARCH_SCHEMA_FILE.
7. Ran the Git Bash contract test successfully:

C:\Program Files\Git\bin\bash.exe tests/repository-first-contract.sh

Example Usage

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

# Forward-generate a scenario architecture view
/speckit.arch.scenario-generate

# Reverse-generate a physical architecture view from repository facts
/speckit.arch.physical-reverse

Proposed Catalog Entry

{
  "arch": {
    "name": "Architecture Workflow",
    "id": "arch",
    "description": "Generate or reverse project-level 4+1 architecture views as separate commands",
    "author": "bigsmartben",
    "version": "1.2.1",
    "download_url": "https://github.com/bigsmartben/spec-kit-arch/archive/refs/tags/v1.2.1.zip",
    "repository": "https://github.com/bigsmartben/spec-kit-arch",
    "homepage": "https://github.com/bigsmartben/spec-kit-arch",
    "documentation": "https://github.com/bigsmartben/spec-kit-arch/blob/main/README.md",
    "changelog": "https://github.com/bigsmartben/spec-kit-arch/blob/main/CHANGELOG.md",
    "license": "MIT",
    "category": "docs",
    "effect": "read-write",
    "requires": {
      "speckit_version": ">=0.8.10.dev0"
    },
    "provides": {
      "commands": 10,
      "hooks": 0
    },
    "tags": ["architecture", "4plus1", "workflow", "design"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-05-14T00:00:00Z",
    "updated_at": "2026-06-23T00:00:00Z"
  }
}

Additional Context

Please update the existing arch entry from v1.1.0 to v1.2.1. Do not use v1.2.0; it is deprecated because the release ZIP install failed command-name validation. The usable release is v1.2.1.

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[github-actions]

Pull request created: #3118

Generated by Add Community Extension from Issue Submission · 286.4 AIC · ⌖ 41.9 AIC · ⊞ 34.5K

[mnriem]

Thank you!