wayfare

Reconciles source code against design targets into a prioritized roadmap of features and goals.

5|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ai-hero/hero-skills --skill wayfare-ai-hero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfare
Source: https://github.com/ai-hero/hero-skills/tree/main/skills/wayfare
Command: npx skills add https://github.com/ai-hero/hero-skills --skill wayfare-ai-hero

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keeping a codebase aligned with its design, architecture, security posture, and roadmap requires juggling many separate audits and planning steps. Wayfare converges all of them into one command surface: it reads the source repo and its design target, reconciles the two, and maintains a single .plans/ store of features, goals, polish items, security fixes, and feedback. ## Core Features & Use Cases - sync: Reads the source repo, the design snapshot, hardening audits, compliance registers, and dependency-bot PRs, then converges everything into roadmap items and proposes goals. - next / do: Authorizes and runs the next goal, or advances a single item one turn, so you always know what to work on. - improve: Runs the compliance audit alone for one repo or a whole fleet and drafts backports. - Feedback lanes: Carries divergences found while building back to the app design or design system as tracked feedback items, delivered only on your confirmation. - Use Case: Run wayfare sync in a repo with a configured claude.ai/design project to get a reconciled roadmap of SLC feature slices, then use wayfare next to authorize and execute the top goal. ## Quick Start Ask the assistant to run wayfare sync in this repository to reconcile the code against the design and propose the next goals.

Frequently Asked Questions about wayfare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reconcile my codebase against a design file?

Run wayfare sync with a design project configured in the HERO.md Wayfare block. It reads the design snapshot through the DesignSync tool, resolves design elements to source symbols like routes and tokens, and writes coverage, polish, and feedback items into the .plans/ store.

What is an SLC feature slice in roadmap planning?

SLC stands for Simple, Lovable, and Complete: a vertical slice through the whole system shaped like a user story, never a horizontal layer. Each feature cuts through schema, service, route, UI, and tests so one story works end to end.

Can wayfare work without a design project configured?

Yes. With design-project set to none, sync runs in self-review mode, reconciling the source against itself, its DESIGN.md, its own gaps, and its hardening findings. A design target sharpens the roadmap but is optional.

How does wayfare handle feedback to a design system?

Divergences found while building are captured on the feature, promoted to feedback items at sync, and delivered only on explicit user confirmation. Design-system feedback is written into the design-system repo's own .plans/ store; design feedback is filed as issues to the configured feedback-repo.

Why does wayfare never mark items ready by itself?

The ready status is reserved for the user as an explicit approval gate. Wayfare plans and proposes, but only the user flips an item to ready, after which the one-shot skill builds it. This keeps authorization separate from planning.