Skip to content

v1.3.0

Choose a tag to compare

@va-worker va-worker released this 28 May 14:55
· 41 commits to main since this release
5d0e69c

Adds the /eli5 slash command to the framework. Minor version bump because this is a user-visible new operator capability.

Added

  • /eli5 slash command — posts a plain-language comment on a target issue or PR translating dense Agentic-PRD-Lite ticket bodies for non-engineer operators (founders, workshop attendees, stakeholders). Every technical term encountered (JWT, RLS, feature flag, CI gate, webhook, etc.) is treated as a teaching opportunity with an inline definition on first use, rather than assumed-known. Marker-based idempotency: re-running on the same target replaces the prior ELI5 comment, never appends. Optional Mermaid diagram with built-in render-check. Comment-only — never edits the canonical issue/PR body. (#330)

Migration notes

  • Operators with the prior /eli5 prototype in their own forks (notably vibeacademy/cubrox, where the prototype lived in .claude/commands/eli5.md at commit 3ba35cb) can run /pull-upstream to receive the upstream version. The upstream port intentionally diverges from the cubrox prototype in audience model: cubrox assumed "tech-adjacent operator who knows what an API is," while upstream assumes the operator is NOT an engineer. The "Keep as-is" column from cubrox's translation table is deliberately removed — there is no such column upstream; every term gets a definition.

Audience-model design

The command spec includes worked examples for JWT, RLS, feature flag, CI gate, and webhook showing the expected <term> (<plain-language definition>) pattern. Word-budget guideline: soft 600-word ceiling, with a "Glossary section" escape valve when explanations need more room. The deliberate counter to /review-pr and /work-ticket, which assume an engineer audience.

No breaking changes

  • All existing slash commands behave identically to v1.2.1.
  • No file rename, no env var change, no protocol change.
  • /eli5 is purely additive.