Skip to content

ai-hero/wayfare

v2.1.0MIT

Plan work and have agents execute it, in a repo and across a fleet of them

wayfare-advance-item

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.

wayfare-audit-compliance

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.

wayfare-audit-deep

Run the vendored Cloudflare security audit on one repo, with a stated budget and source-only by default. Use when a person explicitly asks for a deep security audit or a pen test of a repo, and only then. Not for a security question, a PR review, or dependency and image scanning.

wayfare-audit-plugin

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

wayfare-audit-security

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.

wayfare-build-task

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.

wayfare-check-audit-claim

Check a claim from a compliance tool against what the auditor was told and against independent evidence. Report it as a claim row. Read only. Use before reporting a test result, deadline, fix or task from a tool such as Vanta, or before filing a ticket from one, even when nobody asked for a check.

wayfare-check-preflight

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.

wayfare-create-skill

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.

wayfare-drop-item

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.

wayfare-grill-idea

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.

wayfare-init-repo

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.

wayfare-model-data

Model stored data, write migrations, add indexes, cache reads, and fix slow queries in a MongoDB and Redis backend. Use before adding or changing a stored field, collection, store method, query, index, cached read, or migration. Use when an endpoint is slow or uncached, even if nobody mentions the database. Use audit to report a repo's gaps.

wayfare-one-shot

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.

wayfare-push-pr

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.

wayfare-recalibrate-config

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.

wayfare-recomponentize-ui

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.

wayfare-respond-pr

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.

wayfare-review-architecture

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.

wayfare-review-fleet

Compare FLEET.md with sibling checkouts. Report rows not cloned here, moved or broken checkouts, and port collisions. Write nothing. Use from the folder containing the repos to check the map before a fleet run.

wayfare-review-pr

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.

wayfare-review-product

Compare the product description (PRODUCT.md, or the feature ideas on the Wayfare server) with the code. Report features the description is missing, claims the code no longer backs, wrong statuses, and a missing or stale Source ref. Write nothing. Use to check what the product says it is before trusting it.

wayfare-setup-dev

Check local tools and credentials against HERO.md, or set up a whole machine from the fleet's .fleet/setup.yaml when run at the fleet root. Guide git config, CLI sign-ins and missing dependencies. Never change shared files. Use on a fresh machine or clone, or when a tool or login is missing.

wayfare-ship-pr

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.

wayfare-start-goal

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.

wayfare-sync-architecture

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.

wayfare-sync-fleet

Create or update FLEET.md, the fleet map of sibling checkouts, groups, and ports, kept in the register checkout at .fleet/. 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.

wayfare-sync-plan

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.

wayfare-sync-product

Write the whiteboard view of a product: what it is, its features with shipped, partial or planned status, and one statement each. Files ideas on the Wayfare server, writes PRODUCT.md locally. Use when a product has no description a person can read in two minutes, or after wayfare-review-product reports drift.

wayfare-work-task

Pick up a ready task from the Wayfare server, claim it, build it, open its PR, link the PR to the task, and report and comment on it. Release the claim when the build fails. Use when a project's tasks live in Wayfare and an agent should work one of them.

wayfare-write-handoff

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.

write-like-me

Write or rewrite prose so it sounds like Rahul wrote it, in plain words, AI patterns removed, for blogs, LinkedIn, book chapters, business writing, slides, docs or code comments. Use when asked to humanize, de-AI, write it like me, rewrite in my voice, draft from notes or fix titles, after an agent drafts prose, and for the pipeline's prose pass.