ai-hero/wayfare

Advance one item through its permitted gates. Handle a ready task, a Dependabot PR, or one goal turn. Do not plan. Use to advance a specific item by id.

Audit this repo against the compliance baseline, or audit the fleet at merged state. Report register defects, regenerate CONSISTENCY.md, and draft template backports. Use to check compliance without a full roadmap sync.

Audit skill quality, consistency, duplication, HERO.md field coverage, and readability in the wayfare plugin. Use before releasing plugin changes.

Run by wayfare-sync-plan. Audit dependency CVEs, container CVEs with Scout and Trivy, and code hardening. Write executable security plans under .plans. Never edit source.

Build one small task through planning, implementation, review, and shipping, or resume the current goal. Use for a low-risk change that fits one PR. Route larger or irreversible work through wayfare-sync-plan.

Check tooling, HERO.md freshness, .env keys, and ports before the pipeline changes state. Use before wayfare-push-pr, wayfare-ship-pr, or wayfare-build-task, or when a pipeline fails during setup.

Create an Agent Skill or a supported client-specific agent, rule, or hook. Define its triggers and success criteria. Use when extending an agent client or adding a reusable workflow.

Drop an open item with a recorded reason. For an unmerged branch, stash and switch only with a named, confirmed stash. Change no git state for an item without a branch. Use when abandoning work.

Brainstorm and plan through one question at a time. Write work items with dependencies. Use for vague tasks, features, refactors, or migrations beyond one small change, before an unstated assumption, or before a decision that is expensive to reverse. Skip typos, copy edits, and dependency bumps.

Rewrite text with the maintained rules from Wikipedia's "Signs of AI writing". Preserve meaning and remove AI writing patterns. Use when editing prose or applying the pipeline's prose filter to text.

Investigate a repo, write HERO.md, and create .plans/PLAN.md. Migrate an older store when found. Scaffold first in an empty directory. Use on a repo with no HERO.md or no .plans/PLAN.md.

Draft one small task from a clear description. Show it and ask before marking it ready and building it through a merged PR. Route multiple items, anti-features, and irreversible changes to wayfare-grill-idea. Use for a fix you already understand.

Test the work, commit it, push it, and open a draft PR with a CI report. Use when work is ready to check or share. Use test or commit mode to stop before publishing.

Report and tune HERO.md config for wayfare, including Connections, Wayfare, and the architecture and security stages. Ask only about unset or incorrect fields. Use after a config failure or a change to the repo's structure.

Refactor UI into atomic layers, replace off-token styling, and source primitives from a configured registry or stock shadcn. Use when asked to recomponentize, refactor UI, adopt a design system, or clean up component structure.

Address actionable PR review comments. Check the fixes and resolve the corresponding conversations. Use when a reviewer or review bot leaves feedback on your pull request.

Compare DESIGN.md with the code. Report stale claims, missing layers, obsolete sections, and a missing or stale Source ref. Write nothing. Use to check the architecture record before trusting it.

Compare FLEET.md with sibling checkouts. Report unmapped repos, missing checkouts, and port collisions. Write nothing. Use from the folder containing the repos to check the map before a fleet run.

Review a PR with independent quality and security passes. Apply fixes only in self-review mode. Use before marking your PR ready or when reviewing another author's PR without editing it.

Check local tools and credentials against HERO.md. Guide a developer through git config, CLI authentication, and missing dependencies. Never change shared files. Use on a fresh machine or clone, or when a tool or login is missing.

Trigger the configured approval workflow and read its verdict. Merge an approved PR and check state after the merge. Use after review when a pull request is ready to ship.

Ask the user to authorize the next goal, then run its first turn. Keep the grant in the session. Never store it. Use when the roadmap is planned and the user is ready to build the next goal.

Create DESIGN.md when absent or apply drift findings from an architecture review. Write only changes the user confirms. Keep Decisions append-only. Use after wayfare-review-architecture reports findings or to create the record.

Create or update FLEET.md, the local map of sibling checkouts, groups, and ports. Propose rows and write only what the user confirms. Use from the folder containing the repos when adding a checkout or claiming a port. Use wayfare-review-fleet to report drift without writing.

Refresh .plans against architecture, design, hardening, stale prose, compliance, dependency PRs, unmerged work, and goals. Propose items and goals. Write only what the user confirms. Use to refresh the roadmap.

Write one work item with session context, decisions, remaining work, and acceptance criteria for an agent with no session context. Use when stopping during a task, transferring work, or filing session findings as a ticket.