mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-22 02:56:52 +03:00
Split /onboard back out as its own command (21 commands total)
Pre-3.0, onboard was folded into /harden when we were trying to reduce
namespace pollution. In the single-skill model that tradeoff is gone,
so the weakest of the old merges is the first to undo.
Harden and onboard live in different mental modes. Harden is defensive
(edge cases, i18n, overflow, errors). Onboard is activation (first-run
flows, empty states as CTAs, progressive disclosure). A user thinking
"design the onboarding flow" was never going to type /impeccable harden.
Changes:
- New reference file at source/skills/impeccable/reference/onboard.md,
restored from the pre-merge version in git history rather than the
condensed 33-line summary that was in harden.md.
- Removed the "Onboarding & First-Run Experience" section from
source/skills/impeccable/reference/harden.md.
- Updated harden description/editorial/process-steps to drop onboarding
keywords; split commandProcessSteps so harden stays focused on
production resilience and onboard gets its own phases.
- Registered onboard in: SKILL.md description + command menu + router
table, command-metadata.json, IMPECCABLE_SUB_COMMANDS, pin.mjs
VALID_COMMANDS, SKILL_CATEGORIES, COMMAND_RELATIONSHIPS, data.js
commandCategories + commandProcessSteps + commandRelationships,
framework-viz commandSymbols + commandNumbers.
- Reused the existing content/site/skills/onboard.md editorial wrapper
(it was orphaned by the merge but never deleted), updating it to use
/impeccable onboard.
- Bumped all user-facing count references 20 -> 21: public/index.html,
CLAUDE.md, README.md, NOTICE.md, plugin.json, marketplace.json,
sitemap.xml, build-sub-pages.js.
- Harness dir audit.md and critique.md changes are the
{{available_commands}} placeholder expanding to include onboard.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.6
parent
2c10cfb664
commit
e58cbc432f
@@ -1,24 +1,23 @@
|
||||
---
|
||||
tagline: "Make interfaces production-ready. Edge cases, onboarding, i18n, error states, overflow."
|
||||
tagline: "Make interfaces production-ready. Edge cases, i18n, error states, overflow."
|
||||
---
|
||||
|
||||
## When to use it
|
||||
|
||||
`/impeccable harden` is for the day your interface meets reality. Real user data is messy: names that are 60 characters long, product titles in German, prices in the billions, empty lists, 500 errors, offline modes, right-to-left text. Designs that only work with perfect data are not production-ready.
|
||||
`/impeccable harden` is for the day your interface meets reality. Real user data is messy: names that are 60 characters long, product titles in German, prices in the billions, 500 errors, offline modes, right-to-left text. Designs that only work with perfect data are not production-ready.
|
||||
|
||||
Reach for it before launch, before opening to a new market, or any time a bug report starts with "our user had a really long name and".
|
||||
Reach for it before launch, before opening to a new market, or any time a bug report starts with "our user had a really long name and". For first-run flows, empty-state activation, and onboarding design, reach for `/impeccable onboard` instead.
|
||||
|
||||
## How it works
|
||||
|
||||
The skill works through five dimensions of real-world resilience:
|
||||
The skill works through four dimensions of real-world resilience:
|
||||
|
||||
1. **Text and data extremes**. Long text, short text, special characters, emoji, RTL, numbers in the billions, 1000-item lists, zero-data empty states.
|
||||
1. **Text and data extremes**. Long text, short text, special characters, emoji, RTL, numbers in the billions, 1000-item lists.
|
||||
2. **Error scenarios**. Network failures, API 4xx/5xx, validation errors, permission errors, rate limits, concurrent operations.
|
||||
3. **Internationalization**. Long translations (German is often 30% longer than English), RTL languages, date and number formats, currency symbols, character sets.
|
||||
4. **Onboarding and empty states**. First-run experiences, empty state design, progressive disclosure, feature discovery. Making the feature work for someone who has never seen it before.
|
||||
5. **Device and context**. Touch targets, offline behavior, slow connections, low-power mode.
|
||||
4. **Device and context**. Touch targets, offline behavior, slow connections, low-power mode.
|
||||
|
||||
For each dimension it identifies the failure mode, then applies the concrete fix: overflow handling, proper empty states, informative error UI, i18n-safe layouts, pluralization, sensible fallbacks.
|
||||
For each dimension it identifies the failure mode, then applies the concrete fix: overflow handling, informative error UI, i18n-safe layouts, pluralization, sensible fallbacks.
|
||||
|
||||
## Try it
|
||||
|
||||
|
||||
@@ -4,11 +4,11 @@ tagline: "Design first-run experiences, empty states, and paths to value."
|
||||
|
||||
## When to use it
|
||||
|
||||
`/onboard` is for the moments that decide whether a new user sticks around: the first screen, the empty state, the setup flow, the product tour, the "what do I do now" gap. Reach for it when activation is weak, when new users drop off before reaching value, or when your product has empty states that say "no items yet" and stop there.
|
||||
`/impeccable onboard` is for the moments that decide whether a new user sticks around: the first screen, the empty state, the setup flow, the product tour, the "what do I do now" gap. Reach for it when activation is weak, when new users drop off before reaching value, or when your product has empty states that say "no items yet" and stop there.
|
||||
|
||||
## How it works
|
||||
|
||||
The skill starts from one question: what is the aha moment, and how fast can a new user get there. Every design decision points at that moment.
|
||||
The command starts from one question: what is the aha moment, and how fast can a new user get there. Every design decision points at that moment.
|
||||
|
||||
It works across the surfaces that shape first impressions:
|
||||
|
||||
@@ -18,12 +18,12 @@ It works across the surfaces that shape first impressions:
|
||||
4. **Progressive disclosure**: advanced features stay out of the way until they are earned.
|
||||
5. **Activation events**: the moment a user first experiences the core value is instrumented and celebrated, quietly.
|
||||
|
||||
The skill resists two common failure modes: over-tutorialized onboarding where users click through a carousel before they can touch anything, and zero-onboarding where users are dropped into an empty app and expected to figure it out.
|
||||
The command resists two common failure modes: over-tutorialized onboarding where users click through a carousel before they can touch anything, and zero-onboarding where users are dropped into an empty app and expected to figure it out.
|
||||
|
||||
## Try it
|
||||
|
||||
```
|
||||
/onboard the editor
|
||||
/impeccable onboard the editor
|
||||
```
|
||||
|
||||
Typical output:
|
||||
@@ -36,5 +36,5 @@ Typical output:
|
||||
## Pitfalls
|
||||
|
||||
- **Adding a product tour as the default answer.** Most products do not need a tour. They need a better first screen. Tours are a crutch.
|
||||
- **Designing onboarding without defining the aha moment.** If you cannot say in one sentence what the user should feel in the first 60 seconds, go back to `/shape` first.
|
||||
- **Designing onboarding without defining the aha moment.** If you cannot say in one sentence what the user should feel in the first 60 seconds, go back to `/impeccable shape` first.
|
||||
- **Running onboard on a broken flow.** Fix the flow first. Onboarding cannot rescue a product where the core action is broken.
|
||||
|
||||
Reference in New Issue
Block a user