Skip to content

refactor: rename levelup.spec to levelup.specify and consolidate extension docs#71

Merged
kanfil merged 2 commits intomainfrom
rename/levelup-spec-to-specify
Mar 9, 2026
Merged

refactor: rename levelup.spec to levelup.specify and consolidate extension docs#71
kanfil merged 2 commits intomainfrom
rename/levelup-spec-to-specify

Conversation

@kanfil
Copy link
Copy Markdown
Member

@kanfil kanfil commented Mar 9, 2026

Summary

Two improvements in this PR:

1. Rename levelup.speclevelup.specify

Renames the command for consistency with architect.specify and full-verb naming convention across all extensions.

Changes:

  • Renamed extensions/levelup/commands/spec.mdspecify.md
  • Updated extension.yml with new command name
  • Updated all 53 internal references across codebase
  • Updated documentation (README, docs, tests, catalog)
  • Bumped version to 0.0.117

2. Move extension documentation to extension READMEs

Consolidates extension documentation into their respective READMEs, reducing duplication in main README.

Changes:

  • Moved architecture documentation from main README to extensions/architect/README.md
  • Added Two-Level Architecture System, configuration options (--views, --adr-heuristic) to architect README
  • Replaced main README architecture section with brief summary + link to extension README
  • Added link to levelup README in main README
  • Reorganized slash commands table with extension sections and links

Benefits:

  • Each extension is now self-documented
  • Main README is more concise
  • Easier to maintain extension-specific docs
  • Clear separation between core and extension commands

Test Results

Automated Tests ✅

All tests passing:

Trace Command Tests (12/12 passed):

  • ✅ Trace generation and validation scripts exist
  • ✅ Command template structure validated
  • ✅ LevelUp integration confirmed
  • ✅ Summary section validation in all templates

Extension Tests (45/45 passed):

  • ✅ Extension manifest validation
  • ✅ Extension registry and manager tests
  • ✅ Command registrar tests (all agents including kiro-cli)
  • ✅ Extension catalog tests
  • ✅ Integration tests

Manual Verification ✅

Command rename verification:

  • ✅ No remaining levelup.spec references in codebase (except CHANGELOG)
  • ✅ All internal references updated to levelup.specify
  • ✅ Extension.yml correctly configured with new command name
  • ✅ Test file updated to reference specify.md

Documentation verification:

  • ✅ Main README architecture section replaced with summary
  • ✅ Architect README contains all documentation from main README
  • ✅ LevelUp README link added to main README
  • ✅ Slash commands table reorganized with extension sections
  • ✅ All extension README links resolve correctly

Files changed: 18 files

  • 12 documentation files updated
  • 1 command file renamed
  • 5 configuration files updated
  • Version bumped to 0.0.117

Test Plan Checklist

  • Verify /levelup.specify command works (no backward compatibility)
  • Verify extension READMEs have complete documentation
  • Verify main README links resolve correctly
  • Verify slash commands table is accurate
  • All automated tests passing
  • No remaining old references in codebase

Breaking Change Notice

⚠️ Breaking Change: /levelup.spec is no longer available. Users must use /levelup.specify.

No backward compatibility alias provided as per project decision.

kanfil added 2 commits March 9, 2026 14:14
- Rename command file spec.md -> specify.md
- Update extension.yml with new command name and aliases
- Update all internal references in command files
- Update extension README and CHANGELOG
- Update main documentation (README.md, docs/)
- Update tests and catalog.json
- Consistent with architect.specify naming pattern
- Move architecture documentation from main README to extensions/architect/README.md
- Add Two-Level Architecture System section to architect README
- Add configuration options (--views, --adr-heuristic) to architect README
- Replace main README architect section with brief summary + link
- Add link to levelup README in main README
- Reorganize slash commands table with extension sections
- Each extension now has self-contained documentation
- Main README links to extension READMEs for details
@kanfil kanfil merged commit 24369c8 into main Mar 9, 2026
8 checks passed
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.

1 participant