Skip to content

feat(extensions): Add architect extension with /architect.analyze#57

Merged
kanfil merged 2 commits into
mainfrom
feature/architect-extension
Mar 4, 2026
Merged

feat(extensions): Add architect extension with /architect.analyze#57
kanfil merged 2 commits into
mainfrom
feature/architect-extension

Conversation

@kanfil

@kanfil kanfil commented Mar 4, 2026

Copy link
Copy Markdown
Member

Summary

Converts the built-in architect commands to a distributable extension following the spec-kit extension system, and adds a new /architect.analyze command.

Changes

New Extension: architect

  • /architect.init - Brownfield: reverse-engineer ADRs from codebase
  • /architect.specify - Greenfield: interactive PRD -> ADRs
  • /architect.clarify - Refine/validate ADRs through questions
  • /architect.implement - Generate AD.md from ADRs
  • /architect.analyze - NEW Validate ADR<->AD consistency

Bundling

  • Both levelup and architect extensions are now pre-installed during specify init
  • No manual installation required

Documentation

  • Added docs/architecture.md user guide
  • Updated README.md with extension installation notes
  • Updated toc.yml with new architecture page

Detection Passes (analyze command)

Pass What it Checks
A ADR quality (completeness, clarity)
B Inter-ADR consistency (conflicts, terminology)
C ADR -> AD drift (decisions not in AD)
D AD -> ADR drift (components without ADRs)
E AD internal consistency (views align)
F Staleness (placeholders, deprecated refs)
G Feature-system alignment

Testing

  • Test specify init includes both extensions
  • Test all 5 architect commands
  • Test handoffs between commands

Related Issues

Fixes #36

kanfil added 2 commits March 4, 2026 16:18
…mand

- Convert architect commands to distributable extension
- Add new /architect.analyze command for ADR<->AD consistency analysis
- Auto-bundle with levelup extension during specify init
- Include detection passes: ADR quality, inter-ADR consistency,
  ADR->AD drift, AD->ADR drift, AD internal consistency,
  staleness detection, feature-system alignment
- Follows Rozanski & Woods methodology

Fixes #36
- Add 'preinstall: true' flag to catalog.json for levelup and architect
- Release scripts now read preinstall list from catalog.json
- install_bundled_extensions() reads from .specify/catalog.json
- Fallback: if no preinstall flag, install all extensions
- Warn if catalog.json is malformed

To add new pre-installed extension: just add 'preinstall: true'
to its entry in extensions/catalog.json - no code changes needed!
@github-actions

github-actions Bot commented Mar 4, 2026

Copy link
Copy Markdown

📊 Eval Results

Overall: 21/25 tests passed (84%)

Metric Value
✅ Passed 21
❌ Failed 4
📈 Pass Rate 84%
🪙 Total Tokens 128,494
💾 Cached Tokens 0

❌ Failed Tests

  • Unknown (score: 0.79)
  • Unknown (score: 0.83)
  • Unknown (score: 0.54)
  • Unknown (score: 0.79)

Quality thresholds met!

@kanfil
kanfil merged commit d8e70e2 into main Mar 4, 2026
9 checks passed
kanfil added a commit that referenced this pull request Mar 4, 2026
- Add architect extension to hatch build force-include
- Bump version to 0.0.88
- Extension was merged in #57 but not included in builds
kanfil added a commit that referenced this pull request Mar 4, 2026
- Remove dead code from create-release-packages.sh (architect.* filename handling)
- Remove dead code from create-release-packages.ps1 (architect.* filename handling)
- Delete obsolete templates/architecture-template.md (superseded by extensions/architect/templates/AD-template.md)
- Architect commands moved to extension in PR #57, no longer in templates/commands/
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request] Convert architect commands to extension

1 participant