Skip to content

v2.0.0 — Command Surface Redesign

Choose a tag to compare

View all tags
@bjamba bjamba released this 15 Apr 01:49
· 51 commits to main since this release
v2.0.0
f7b0155
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

MAJOR VERSION — breaking changes to all command entry points.

v2.0.0 reorganizes the hacky-hours command surface from a flat list of 19 commands into five intuitive parent groups. Every v1.x entry point has changed. See the migration table in the ADR for the full before/after.

New command structure

/hacky-hours step 1 | step ideate      Step 1 — Ideation
/hacky-hours step 2 | step design      Step 2 — Design
/hacky-hours step 3 | step roadmap     Step 3 — Roadmap
/hacky-hours step 4 | step build       Step 4 — Build
/hacky-hours step 5 | step iterate     Step 5 — Post-release iteration

/hacky-hours review 1 | review audit     Did we follow best practices?
/hacky-hours review 2 | review optimize  Did we build it well?
/hacky-hours review 3 | review pivot     Should we build something else?

/hacky-hours learn 1 | learn tour      Big picture walkthrough
/hacky-hours learn 2 | learn onboard   Hands-on starter task
/hacky-hours learn 3 | learn quiz      Knowledge check

/hacky-hours update 1 | update version  Publish a new release
/hacky-hours update 2 | update project  Sync BACKLOG ↔ GitHub Issues

/hacky-hours tools upgrade       Update/adopt/migrate framework artifacts
/hacky-hours tools mode 1|builder / 2|engineer
/hacky-hours tools walkthrough   How all commands work together (new)

Upgrading from v1.x

  1. Re-run the install script to get v2.0.0
  2. Run /hacky-hours tools upgrade in your project to update CLAUDE.md references

What's new

  • Five parent groups replace 19 flat commands — new users face 5 words, not 19
  • Numbered + named aliases everywhere — step 1, step ideate, and ideate all work
  • "Step" language replaces "Level" throughout — steps are a cycle, not a ladder
  • step 5 promotes iteration as a first-class step, not optional maintenance
  • step 0 is the new dry-run — explore before you begin
  • tools walkthrough — new narrative overview of how all commands work together
  • Global Values section — the framework's ethics declared once, governing all commands
  • tools upgrade absorbs adopt and migrate — context-aware, one entry point
  • link removed — use monorepo + --root for multi-service projects
  • Prompt reduced ~30% — 2,108 → 1,468 lines

See the full CHANGELOG and ADR for complete details.

Assets 2
Loading