Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .github/workflows/community-smoke.yml
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,8 @@ jobs:
speckit-arch-process-generate \
speckit-arch-development-generate \
speckit-arch-physical-generate \
speckit-arch-full-generate \
speckit-arch-full-reverse \
speckit-arch-scenario-reverse \
speckit-arch-logical-reverse \
speckit-arch-process-reverse \
Expand Down Expand Up @@ -171,6 +173,8 @@ jobs:
case "$extension_id" in
arch)
test -f .claude/skills/speckit-arch-scenario-generate/SKILL.md
test -f .claude/skills/speckit-arch-full-generate/SKILL.md
test -f .claude/skills/speckit-arch-full-reverse/SKILL.md
test -f .claude/skills/speckit-arch-scenario-reverse/SKILL.md
grep -q "scenario view" .claude/skills/speckit-arch-scenario-generate/SKILL.md
;;
Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@

### Changed

- Update Architecture Workflow extension to v1.2.2 with full-workflow commands and readiness validators.
- Update bundled Repository Governance extension to v2.0.2, including the `/speckit.repository-governance.refresh` command, `.specify/memory/repository-governance.md` internal cache, and default bundled installation behavior.
- Update bundled Workflow Preset documentation for v1.3.2 Final Code Review task generation and structured code review receipts.

Expand Down
2 changes: 1 addition & 1 deletion docs/community/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ The following community-contributed extensions are available in [`catalog.commun
| API Evolve | Managed API contract evolution — breaking-change detection, semver enforcement, deprecation orchestration, and lifecycle gates across REST, GraphQL, and gRPC | `process` | Read+Write | [spec-kit-api-evolve](https://github.com/Quratulain-bilal/spec-kit-api-evolve) |
| Architect Impact Previewer | Predicts architectural impact, complexity, and risks of proposed changes before implementation. | `visibility` | Read-only | [spec-kit-architect-preview](https://github.com/UmmeHabiba1312/spec-kit-architect-preview) |
| Architecture Guard | Framework-agnostic architecture review extension for validating implementation against governance and architecture constitutions, detecting architectural drift, and generating non-blocking refactor tasks | `process` | Read+Write | [spec-kit-architecture-guard](https://github.com/DyanGalih/spec-kit-architecture-guard) |
| Architecture Workflow | Generate or reverse project-level 4+1 architecture views as separate commands | `docs` | Read+Write | [spec-kit-arch](https://github.com/bigsmartben/spec-kit-arch) |
| Architecture Workflow | Generate or reverse project-level 4+1 architecture views with per-view and full-workflow commands | `docs` | Read+Write | [spec-kit-arch](https://github.com/bigsmartben/spec-kit-arch) |
| Archive Extension | Archive merged features into main project memory. | `docs` | Read+Write | [spec-kit-archive](https://github.com/stn1slv/spec-kit-archive) |
| Azure DevOps Integration | Sync user stories and tasks to Azure DevOps work items using OAuth authentication | `integration` | Read+Write | [spec-kit-azure-devops](https://github.com/pragya247/spec-kit-azure-devops) |
| Blueprint | Stay code-literate in AI-driven development: review a complete code blueprint for every task from spec artifacts before /speckit.implement runs | `docs` | Read+Write | [spec-kit-blueprint](https://github.com/chordpli/spec-kit-blueprint) |
Expand Down
1 change: 0 additions & 1 deletion extensions/arch/.extensionignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,3 @@ __pycache__/
*.py[cod]
tests/
CATALOG-SUBMISSION.md
presets/
3 changes: 1 addition & 2 deletions extensions/arch/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,10 @@ This repository is a Spec Kit community extension source project for `arch`.
- `schemas/` contains architecture artifact schemas.
- `scripts/` contains setup helpers.
- `tests/repository-first-contract.sh` is the main contract test.
- `presets/arch-governance/` is a nested source preset owned by this repository.

## Source Workflow

- Develop extension and nested preset source changes in this repository.
- Develop extension source changes in this repository.
- Release versioned source artifacts from this repository.
- Keep `README.md`, `CHANGELOG.md`, `CATALOG-SUBMISSION.md`, manifests, and tests aligned.
- Run `bash tests/repository-first-contract.sh` after behavior, command, template, schema, or setup-script changes.
Expand Down
17 changes: 10 additions & 7 deletions extensions/arch/CATALOG-SUBMISSION.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,29 +2,32 @@

Extension ID: arch
Name: Architecture Workflow
Version: 1.2.1
Description: Generate or reverse project-level 4+1 architecture views as separate commands
Version: 1.2.2
Description: Generate or reverse project-level 4+1 architecture views with per-view and full-workflow 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
Download URL: https://github.com/bigsmartben/spec-kit-arch/archive/refs/tags/v1.2.2.zip
Documentation URL: https://github.com/bigsmartben/spec-kit-arch#readme
License: MIT
Required Spec Kit version: >=0.8.10.dev0
Commands count: 10
Commands count: 12
Hooks count: 0
Tags: architecture, 4plus1, workflow, design

Key features:
- Provides `.arch` namespaced commands for each 4+1 view: scenario, logical, process, development, and physical.
- Provides `/speckit.arch.full-generate` for one-command forward generation of all 4+1 views and synthesis.
- Provides `/speckit.arch.full-reverse` for one-command reverse generation of repo facts, all 4+1 views, and synthesis.
- 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.
- Uses optional repository-first evidence in the reverse workflow, with dependency matrix interpretation owned by the development view rather than consumed evenly by every 4+1 view.
- Requires the Development View commands to produce a `Dependency Matrix` section in the development-view artifact.
- 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.
- Ships a schema-backed artifact contract plus bash and PowerShell readiness validators that emit `ready_gate` and stable blocker codes.
- Restricts writes to documented `.specify/memory/architecture*.md` files, including repo facts for reverse generation.

Testing performed:
- Local development install with `specify extension add --dev /home/administrator/github/spec-kit-arch`.
- Bash setup helper verified with `.specify/extensions/arch/scripts/bash/setup-arch.sh --json`.
- Release ZIP install to verify after publishing `v1.2.1`: `specify extension add arch --from https://github.com/bigsmartben/spec-kit-arch/archive/refs/tags/v1.2.1.zip`.
- Release ZIP install to verify after publishing `v1.2.2`: `specify extension add arch --from https://github.com/bigsmartben/spec-kit-arch/archive/refs/tags/v1.2.2.zip`.
15 changes: 10 additions & 5 deletions extensions/arch/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,21 @@

## Unreleased

## v1.2.2 - 2026-06-25

- Use CLI-compatible command names such as `/speckit.arch.scenario-generate` and `/speckit.arch.scenario-reverse`.
- Add `/speckit.arch.full-generate` for one-command forward generation of all 4+1 views and synthesis.
- Add `/speckit.arch.full-reverse` for one-command reverse generation of repo facts, all 4+1 views, and synthesis.
- Clarify command bootstrap boundaries, synthesis readiness checks, reverse repo-facts merge behavior, and source traceability expectations.
- Replace the two broad architecture commands with ten `.arch`-namespaced commands: forward and reverse generation for scenario, logical, process, development, and physical views.
- Keep synthesis refresh optional for per-view commands so each command owns one primary 4+1 artifact.
- Add reverse commands for repo-facts-first generation of architecture artifacts from ordinary historical repositories.
- Teach reverse commands to consume optional `.specify/memory/repository-first/` dependency matrices and module invocation specs as evidence for development-view governance.
- Add a schema-backed architecture artifact contract and require commands to validate JSON-compatible working models before Markdown rendering.
- Separate command and template responsibilities: commands now own extraction, classification, validation, merge policy, and write boundaries; templates only define Markdown layout.
- Add the `arch-governance` preset to wrap only the core `/speckit.plan` workflow with architecture SSOT grounding.
- Keep architecture generation commands independent from core workflow commands by removing downstream planning language from architecture artifacts.
- Teach reverse commands to consume optional `.specify/memory/repository-first/` evidence, with dependency matrix interpretation owned by development-view governance rather than treated as an independent view or equal input to every 4+1 view.
- Require the Development View commands to produce a `Dependency Matrix` section as part of the development-view artifact.
- Add a schema-backed architecture artifact contract for JSON-compatible working models before Markdown rendering.
- Add bash and PowerShell readiness validators that emit `ready_gate` and stable architecture blocker codes for synthesis refresh decisions.
- Separate command, schema, validator, and template responsibilities: commands now own extraction, classification, merge policy, and write routing; schemas own working-model structure; validators own rendered-artifact readiness and blocker codes; templates only define Markdown layout.
- Keep this repository scoped to extension-owned architecture commands, templates, schemas, scripts, and contract tests.

## v1.0.0

Expand Down
Loading