Skip to content

Business Analysis

/business-analyse is the first phase of the V-Model. It exists to stop the single most common failure mode of AI-assisted software projects: jumping straight to code before the problem is understood. A modern AI coding agent will happily build the wrong thing, fast, if nobody slowed it down to ask who the user is and what they actually struggle with.

This skill is the slowdown. It runs an innovation interview with you, spots the gaps in your understanding of the user and the problem, and tells you which research method will close each gap fastest. The actual field work stays with you. No agent can replace a real conversation with a real user.

What the skill actually does

The session walks through three internal phases:

  1. Exploration to understand the problem space. Users, needs, insights, touchpoints, trends, competitors.
  2. Ideation to design a response. Idea description, value proposition, Wow feature, high-level concept, critical hypotheses.
  3. Validation to test whether the idea is worth building. VP score, assessment radar, pricing, channels, revenue streams.

Every persona, insight, need, and touchpoint is proposed as a draft and confirmed by you before it becomes part of the artifact. The agent does not invent users in the background. It proposes, cites the source, and waits for your confirmation.

Scope adaptation

The skill asks at the start which tier applies. The rest of the session scales to match.

ScopeExplorationIdeationValidationTypical duration
Simple TestMinimal: user and problemDescribe the solutionSkipHours to 1 or 2 days
Proof of ConceptShortened: user, needs, HMWFullHypotheses and feasibility1 to 4 weeks
MVPFull 10-section Exploration boardFullFull market assessment2 to 6 months

A Simple Test does not need a stakeholder map. An MVP does not get away without one. Match depth to scope.

How the agent proposes methods in the dialog

The core behaviour of this skill is method matchmaking. During the interview, the agent notices where your answers go thin, where you sound certain without evidence, or where entire sections of the Exploration board are empty. When that happens, it stops asking questions and suggests a method instead.

Example moment inside a real session:

Agent: Who exactly is affected by this problem?

You: Probably our B2B customers. Maybe also their end users.

Agent: That's a guess, not evidence. Before we draft a persona, we need a few real conversations. The fastest way at this stage is explorative interviews: seven to ten short conversations, 20 to 30 minutes each, to map the problem space. If you already suspect the real pain is with power users or non-users, extreme users is a better fit. Which one do you want me to prep a question list for?

The agent then helps you build the question list or the stakeholder map or the interview guide, you run the method in the field, and you come back with notes. The session continues from where you paused.

The full set of methods the agent can suggest is documented as method cards on three reference pages:

Each card has the same structure: what the method produces, when the agent brings it up, how to run it, team and time, things that go wrong in practice, and what to bring back to the session.

Where the methods fit into the session

The BA session walks through Exploration, Ideation, and Validation. Each phase has a natural set of methods the agent reaches for when your answers go thin. The mapping below is the practical answer to "what should I actually do next if I am stuck on this step".

Exploration, understanding users and the problem.

Ideation, designing a response.

Validation, testing whether it is worth building.

The interview discipline

A few rules that the skill follows consistently across every session.

Co-creation, not autonomous generation

The agent proposes drafts and you confirm. A typical exchange:

"Here is a persona sketch based on what you just told me: [draft]. Does this fit your real users, or does it need adjustment?"

If you wanted autonomous generation, you would get a plausible BA that reads well and fails silently. Co-creation is the point.

Ask before you ask

Before asking you about users, markets, or competitors, the agent checks whether you already have that data. Existing interviews, customer support logs, CRM exports, prior research. If you have it, the agent ingests it. If not, the agent proposes a method and you go into the field.

Probing when answers get thin

When your answers become generic, the agent reaches for a handful of probing techniques.

  • 5-Why. Ask "why is that a problem" until you hit something surprising.
  • Concretisation. "Give me a concrete example." "When did this last happen?"
  • Future projection. "Imagine the problem was solved tomorrow. What changes?"
  • Perspective shift. "What would your customer or your boss say?"
  • Emotional level. "How did that feel?"
  • Analogy trigger. "Do you know something similar from another domain?"

These are the same probes the field methods use. They work in both directions: you use them on the users during field work, the agent uses them on you during the session.

The bridge out of Exploration: Point of View and HMW

Once Exploration fills up, the agent synthesises a Point of View statement. The canonical form:

[User, descriptive] needs/wants/has to [verb describing the need] because/but [insight that reframes the problem].

Example:

Harriet, a mother of three rushing through the airport, needs a way to entertain her children because she feels uncomfortable when they disturb other passengers.

A good POV is specific about the user, verb-driven in the need, and insightful in the because. You spend more time on this one sentence than you expect, and it earns the time back in Ideation.

The POV then becomes a How Might We question that opens a solution space. The agent drafts three or four HMW variants from the same POV, each steering ideation in a different direction. You pick one and Ideation starts from there.

The bridge out of Ideation: Value Proposition and Critical Hypotheses

Ideation closes with a Value Proposition and a set of Critical Hypotheses. Every hypothesis is written in the test-card form:

We believe that [assumption]. To verify that, we will [method]. We will measure [indicator]. We are right if [threshold].

These hypotheses become the validation agenda. The agent prioritises them by risk, not by ease. The hypothesis that would kill the idea if wrong gets tested first.

Quality gates

Before the skill hands off to Requirements Engineering, it checks quality gates adapted to scope.

ScopeGate threshold
Simple TestAt least 3 of 4 criteria (problem, user, functionality, DoD)
PoCAt least 6 of 8 criteria (HMW, hypothesis, persona, risks and more)
MVPAt least 10 of 13 criteria (full Exploration board, two or more personas, and so on)

If a gate fails, the skill returns to the relevant section instead of handing off a half-finished BA. See Verification Gates for the full mechanic.

Handoff

/business-analyse ends with the mandatory three-part Handoff Ritual.

  1. Artifact report. Which sections filled, which deferred, which hypotheses still open.
  2. Handoff context entry in _devprocess/context/30_handoffs.md.
  3. Transition question. "Shall I start /requirements-engineering now?"

Phase 8: Post-Release Review (BA as living document)

The BA is not done when the first release ships. Once a feature is in front of real users, the Critical Hypotheses formulated in Ideation become testable against actual usage.

Phase 8 walks each Critical Hypothesis and classifies it against real-world evidence:

  • Confirmed by usage: the hypothesis held up. The metric in the test card was met or exceeded.
  • Contradicted by usage: the hypothesis was wrong. The data tells a different story. A backlog entry is created so the team can react (pivot the feature, change the value proposition, drop it).
  • Inconclusive: not enough data yet, or the metric is ambiguous. Stays open, gets re-reviewed at the next release.

The hypothesis status is also written to _devprocess/context/40_metrics.md so the signal layer accumulates a trace of what the team predicted versus what actually happened.

Phase 8 is queued automatically. /v-model-workflow Phase 7 (Release Closure) appends a release-to-ba entry to 30_handoffs.md. The next time /business-analyse runs, it picks up that handoff and runs Phase 8 before any new exploration work.

This closes the BA-to-release loop. The BA file ages with the product instead of becoming a stale document from the first sprint.

Validation Mode for brownfield projects

When /business-analyse detects a BA draft created by /reverse-engineering, it enters Validation Mode. Instead of starting a new interview from scratch, it walks through each section of the existing draft, confirms the evidence-backed claims with you, and fills the [NEEDS USER INPUT] placeholders through the normal interview cycle. Each section gets promoted from Draft to Validated as you confirm it.

This is how the backward walk through the V joins the forward walk. Same file, same path, same downstream phases.

Read the skill file

Want to see the exact instructions the agent follows? skills/business-analyse/SKILL.md on GitHub. The method catalog the agent draws from lives at skills/business-analyse/references/innovation-methods.md.

Further reading