← Vault Index
Source: frameworks/kit-advisory-onboarding-v2/04-advisory-onboarding-v2-quality.md

04 — QUALITY FRAMEWORK: Advisory Onboarding Kit v2

Level 3 design. This is a quality framework, not a checklist. Fix what you can. Escalate what you can't. The goal: Kathryn only sees things that require her judgment — everything else is resolved before it reaches her.


The Standard

A good output from this kit looks like this:

A bad output looks like this:


What to Fix Yourself

These are issues you catch during production. Don't flag them. Fix them.

Proper noun misspellings. Check against reference data. ATOM not Adam. Karbon not Carbon. TaxDome not Tax Dome.

Generic content that should be specific. If the extraction provided a concrete welcome experience and the roadmap says "you'll receive a welcome package" — rewrite it with the specifics.

Inconsistencies across the three artifacts. If the roadmap says 4 meetings per year but the action plan references quarterly estimates as a separate service — one of them is wrong. Check the extraction data and fix.

Missing maturity layers. If Level 2 or Level 3 is absent from an artifact, write it. If you don't have enough practice-specific data to make it concrete, calibrate honestly: "As we build these systems together, here's what becomes possible."

Audience-boundary violations. Pricing structure in client-facing output — remove. Internal constraint notes — remove. Advisor frustration or emotional processing — remove.

Template language that survived. Anything that reads like instructions to the AI rather than content for the client — rewrite.


What to Escalate to Kathryn

These are genuine judgment calls. Note them clearly in the output.

Ambiguous extraction data. The member said two contradictory things and the conversation didn't resolve it. Example: "Everything is included" AND "bookkeeping cleanup is separate." You can't fix this without knowing which one the member meant.

Practice model mismatch. The extraction says "lean" but the data looks institutional (5+ team members, multiple tiers). The roadmap structure depends on getting this right.

Special-sauce boundary. You're not sure whether something is structural (goes in the kit) or proprietary (stays with the practice). Err toward proprietary and flag it.

Maturity layer realism. The extraction suggests the practice is ready for Level 3 but nothing in the data supports it — no team, no tools, no automation. Writing a Level 3 section would be aspirational fiction.

Cross-member pattern that needs a decision. Two members have nearly identical completion gates. Is that because the universal spine is doing its job, or because the extraction wasn't specific enough? Kathryn decides.


Cross-Member Quality Intelligence

As the kit runs for more members, the quality framework learns:

After each run, note:

Use prior runs to improve current ones:


Hard Stops

These are non-negotiable. If any is true, the output cannot ship. Period.

  1. Fabricated data. Anything that doesn't trace to the extraction or reference data.
  2. No extraction completed. The kit requires per-member offer data. No data = no output.
  3. Special-sauce leak. A practice's proprietary approach baked into the universal spine.
  4. Client-facing AI jargon. "Leverage," "synergy," "It's not X — it's Y" in the roadmap.
  5. No completion gate. The roadmap has no defined endpoint.
  6. No first win. The roadmap doesn't name a concrete, dollar-adjacent result in 30 days.

Everything else is fixable during production or escalatable to Kathryn.


The Client Perspective Test

Every section of every artifact must pass:

"If the client read this cold, with no advisor present, would it (a) make sense, (b) feel respectful of their time and intelligence, (c) tell them what to expect, what they're committing to, and what they'll get?"

If any section fails any of those three — fix it. If you can't fix it without more information — escalate with a specific question, not a vague flag.


Cross-references