wb-flow

Appearance

/wbVision — Command Hub ​

/wbVision produces high-level strategic analysis of a product's direction, competitive position, and roadmap recommendations. It synthesizes from README, commits, issues, and architecture into a structured document. Unlike /wbPlan which produces tactical task lists, /wbVision operates at the product strategy level — answering what should we build and why, not how do we build it.

🎯 Strategic Position ​

/wbVision operates above the tactical layer of the command suite. While /wbPlan tells you how to build something and /wbAudit tells you how healthy the code is, /wbVision answers the question that should come before either: what should exist in the first place, and why. Create it at project start, refresh it quarterly, and use --diff to check whether development trajectory aligns with the stated direction.

  • At project start — create the initial vision document.
  • Quarterly — refresh and validate the strategic direction.
  • Before a major roadmap decision — check alignment.

🛠️ Operating Modes ​

ModeTriggerOutput
Create/wbVision <project>Strategic document synthesized from README, commits, issues, architecture

| Trajectory | /wbVision --diff | Alignment check: is development matching the stated direction? |

✅ What a useful vision document contains ​

A useful vision document includes at minimum:

  1. Product direction — what are we building and for whom.
  2. Competitive positioning — where this fits in the market landscape.
  3. Roadmap recommendations with rationale — priorities, not just a list.
  4. Source traceability — synthesis grounded in README, commits, issues, and architecture.

🚫 What it cannot do ​

Not thisUse instead
Plan tactical tasks/wbPlan
Audit code quality/wbAudit

It also does not execute any changes — it is analysis only.

📚 Reading Order ​

  1. ELI5 — the one-paragraph mental model.
  2. Practical — step-by-step walkthrough on a real project.
  3. Expert — architecture, edge cases, and when NOT to use.
  4. Examples — annotated transcripts (Part 1, Part 2).
  5. Exhaustive simulation · Live demo.
  • wbVision.md — the command reference this hub orients you around.
  • /wbPlan — turn strategic direction into tactical tasks.
  • /wbAudit — score the code that implements the vision.

Quick Reference ​

bash
/wbVision my-project/              # create a vision from project sources

/wbVision --diff                   # check if current work aligns with vision
/wbVision <project> --snap=<label> # pin output to .wb/snaps/

← Home · Commands · Install | wb-flow on npm · flow.wbc-ui.com · wi-bg.com