Skip to content

refine: author domain_knowledge/entrepreneurship/fixtures/*.yaml (Layer 6) - #92

Merged
mokashang merged 1 commit into
mainfrom
refine/20260518-203102-entrepreneurship-fixtures
May 21, 2026
Merged

refine: author domain_knowledge/entrepreneurship/fixtures/*.yaml (Layer 6)#92
mokashang merged 1 commit into
mainfrom
refine/20260518-203102-entrepreneurship-fixtures

Conversation

@mokashang

Copy link
Copy Markdown
Owner

What changed

11 per-fixture YAML files at domain_knowledge/entrepreneurship/fixtures/*.yaml covering all 11 decisions (D1–D11) and all 14 framings (F1–F14) across 11 distinct asker personas. Each fixture is ~57–76 lines, ~734 lines total — matches the housing/fixtures total (~600 lines, PR #67).

Why

Layer 6 of the 4-layer knowledge model for V2 §4 entrepreneurship domain (6 of 10). Anchors the Layer 1 decision ontology + Layer 2 framings library + Layer 3 blindspots cluster + Layer 4 sources + Layer 5 communities in concrete asker situations — named dollar amounts, statutes (IRC §83(b) / §199A / §1202 / §351, CA Labor Code §2870 / §16600, NY 2023 ABC-style law, FTC 2024 non-compete rule), and persona-specific risk surfaces.

Roadmap item

v2/entrepreneurship/fixtures-md, Layer 6 V2 §4 domain 6 of 10. Closes 5/8 → 6/8.

Mechanism E posture

Selective partial-gating per entrepreneurship high_stakes:false from _meta_ontology.md §6. Mirrors domain_knowledge/housing/fixtures/ (PR #67) precedent — NOT the uniform high-stakes consult-* routing of domain_knowledge/personal-finance/fixtures/ (PR #90) or domain_knowledge/immigration/fixtures/ (PR #58).

Six tail-risk decisions carry consult-* routing in their expected_blindspot_categories:

  • cofounder-equity-split-vesting-cliff.yaml (D1) → startup attorney founder-side (Cooley / Gunderson / WSGR / Orrick / Fenwick or Clerky / Atlas)
  • llc-vs-s-corp-ca-180k-consultant.yaml (D4) → S-corp-experienced CPA with multi-state nexus
  • safe-stack-priced-seed-qsbs.yaml (D5) → startup attorney founder-side on conversion mechanics
  • w2-vs-1099-first-engineer-ca-ab5.yaml (D7) → employment-law attorney (CA / MA / NJ / IL ABC-test states)
  • solo-401k-vs-sep-ira-backdoor-roth.yaml (D8) → retirement-experienced CPA on S-corp + solo-401(k) plan-document selection
  • cofounder-departure-dispute-ca-non-compete.yaml (D11) + international-founder-delaware-c-corp-1202.yaml (D11/D5/D1) → startup AND employment-law attorneys both sides (D11); tax + startup attorney on cross-border §1202 / §351 / immigration coordination

The other 5 fixtures (D2 / D3 / D6 / D9 / D10) carry "not a substitute for case-specific licensed counsel" language without uniform routing:

  • bootstrap-vs-seed-saas-40k-mrr.yaml (D2 + D5 facet)
  • quit-day-job-faang-rsu-cliff-leap.yaml (D3)
  • sole-prop-vs-llc-side-hustle-nights.yaml (D6)
  • pricing-model-pivot-services-to-product.yaml (D9 + D10 + D2)

Coverage:

  • Decisions: D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11 (all 11)
  • Framings: F1–F14 (all 14)
  • Personas (11 distinct): two-cofounder-pre-equity, indie-saas-product-led, ex-faang-quitting, solo-consulting-multi-state, yc-applicant-cap-table, ex-faang-nights-weekends, first-w2-employee-considerer, solo-self-employed-retirement-maxer, services-to-product-pivot, dispute-mid-cap-table, international-founder

Cross-domain edges flagged inline where genuine: entrepreneurship ↔ personal-finance (D7 retirement / Roth-conversion-window / QSBS / Form 8606 pro-rata), entrepreneurship ↔ tech-career (D3 RSU forfeit / golden-handcuffs / PIIA carve-out), entrepreneurship ↔ legal-disputes (D7 ABC-test / D11 non-compete / DTSA), entrepreneurship ↔ health-insurance (D3 COBRA-vs-ACA / D7 QSEHRA / ICHRA / SHOP), entrepreneurship ↔ housing (D3 HELOC pre-leap), entrepreneurship ↔ immigration (international founder H-1B / O-1A / I-485 / substantial-presence-test).

Companion files

Predicted signal delta

Pure-additive knowledge file. Branch eval skipped (env-degraded).
Predicted strategic value when V2 §4 entrepreneurship eval-pass runs:

  • specificity: +0.03 on entrepreneurship fixtures (per-decision personas + named dollar / state / statute anchors)
  • non_obviousness: +0.02 on dispute / cap-table fixtures (QSBS-clock-on-SAFE, MFN-stacking-auto-upgrade, PIIA-anticipated-business)
  • grounding_pct: 0
  • diversity: +0.01 (11 distinct personas vs typical 4–6 prior)

Eval status

env-degraded-skip per VOYAGE_API_KEY-unset. Precedent: PRs #44, #48, #49, #54, #58, #63, #64, #66, #67, #68, #69, #70, #71, #72, #73, #74, #75, #76, #77, #78, #79, #80, #81, #82, #83, #84, #85, #86, #87, #88, #89, #90, #91 all flagged eval_status="env-degraded-skip".

  • baseline_quality_score: 0.8164 (V1.x → V2 entry baseline)
  • branch_quality_score: null (eval skipped)

Files touched

  • domain_knowledge/entrepreneurship/fixtures/bootstrap-vs-seed-saas-40k-mrr.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/cofounder-departure-dispute-ca-non-compete.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/cofounder-equity-split-vesting-cliff.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/international-founder-delaware-c-corp-1202.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/llc-vs-s-corp-ca-180k-consultant.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/pricing-model-pivot-services-to-product.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/quit-day-job-faang-rsu-cliff-leap.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/safe-stack-priced-seed-qsbs.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/sole-prop-vs-llc-side-hustle-nights.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/solo-401k-vs-sep-ira-backdoor-roth.yaml (new)
  • domain_knowledge/entrepreneurship/fixtures/w2-vs-1099-first-engineer-ca-ab5.yaml (new)

Risk assessment

Pure-additive: zero existing files modified, only new YAML files under domain_knowledge/entrepreneurship/fixtures/. No runtime consumption yet (V2 eval-runner integration is a separate roadmap item). Schema mirrors domain_knowledge/housing/fixtures/ exactly so future fixture-loading code paths work identically. Statutes / IRC sections / state-codes are cited as pointers per framings.md §intro convention — the analysis happens in the runtime, not in the fixture text. Selective consult-* routing only on six tail-risk fixtures preserves the entrepreneurship high_stakes:false posture and avoids over-referral degradation.

🤖 Generated by refine-blindspot skill (parallel attempt)

…er 6)

11 per-fixture YAML files covering all 11 decisions (D1-D11) and all
14 framings (F1-F14) across 11 distinct asker personas. Mirrors
domain_knowledge/housing/fixtures/ schema and selective-Mechanism-E
partial-gating posture per entrepreneurship high_stakes:false from
_meta_ontology.md §6.

Selective consult-* routing on six tail-risk decisions only:
- D1 cofounder-equity-split-vesting-cliff → startup attorney
- D4 llc-vs-s-corp-ca-180k-consultant → S-corp CPA
- D5 safe-stack-priced-seed-qsbs → startup attorney
- D7 w2-vs-1099-first-engineer-ca-ab5 → employment-law attorney
- D8 solo-401k-vs-sep-ira-backdoor-roth → retirement CPA
- D11 cofounder-departure-dispute-ca-non-compete → startup + employment
  attorneys; international-founder-delaware-c-corp-1202 → tax + startup

Other 5 fixtures (D2/D3/D6/D9/D10) carry 'not a substitute for
case-specific licensed counsel' language without uniform routing,
matching housing/fixtures (PR #67) partial-gating precedent — NOT the
uniform high-stakes consult-* routing of personal-finance/fixtures
(PR #90) or immigration/fixtures (PR #58).

Advances v2/entrepreneurship/fixtures-md (V2 §4 domain 6 of 10) from
5/8 → 6/8.

Companion files (already merged):
- decisions.md (PR #59)
- framings.md (PR #71)
- blindspots.md (PR #79)
- sources.yaml (PR #82)
- communities/ (PR #91)
@mokashang

Copy link
Copy Markdown
Owner Author

🤖 Iteration 1: APPROVE — Pure-additive Layer 6 fixtures under domain_knowledge/entrepreneurship/fixtures/ — 11 new YAML files matching housing/fixtures schema, no protected paths touched, consult-* routing applied selectively on tail-risk decisions consistent with entrepreneurship high_stakes:false posture.

mokashang added a commit that referenced this pull request May 18, 2026
…up flip 7 + advance 1; ROADMAP denominator off-by-one corrected 13 → 12)

POST-PIVOT BASELINE run — first refine iteration since the
scope-narrow pivot (commit f250013, PR #94). V2-narrow Status
moves from 0/13 (off-by-one + uncounted pivot work) to 8/12 = 67%.

This run advanced 2 V2-narrow items via subagent PRs:

  - v2-narrow/cn-sde-jobhunt/fixtures-md COMPLETED via PR #96
    (3 → 10 per-fixture YAMLs; D1-D12, 4 communities, 6+ personas)
  - v2-narrow/infra/eval-fixtures-replaced ADVANCED via PR #95
    (fixtures/eval_situations.yaml 13 → 16 situations; coverage
    for day-1-CPT, postdoc EB-1A, H-4-EAD-primary-switch)

ROADMAP catch-up — 7 items completed at pivot but never flipped:

  - sources.yaml (15 source-views, 4 communities)
  - communities/ (4 profiles, 5-7 KB each)
  - domain_pack.md (119 lines, Triage / Editor / Critic)
  - Triage prompts updated (single-vertical narrow)
  - Source registry replaced (data/source_registry.yaml)
  - Tag taxonomy replaced (data/tag_taxonomy_seed.yaml)
  - Eval fixtures replaced (now 16 situations after PR #95)

V2-narrow remaining (4 items, all are voice-work or gated):

  - decisions.md / framings.md / blindspots.md paragraph content
    (user-authored only per SKILL.md §5; refine MAY only add
    structural skeletons)
  - eval-pass: ≥0.75 quality_score over ≥8 fixtures × 3 consecutive
    main runs (gated on VOYAGE_API_KEY restoration)

Recovery: 2 anomalies, both logged
  - PRs #92 + #93 (V2-orig stale pre-pivot orphans, both target
    archived folders) — gh pr close blocked by auto-mode
    classifier; left open for user to close manually
  - ROADMAP V2-narrow denominator drift (stated 0/13, actual 12
    checkboxes) — corrected to 8/12 in this commit

aggregate quality_score unchanged (env-degraded-skip both branches
— VOYAGE_API_KEY not set in worktree environment)

🤖 Generated by refine-blindspot skill (scope-narrowed)
@mokashang

Copy link
Copy Markdown
Owner Author

@claude review this, if good, merge

@claude

claude Bot commented May 21, 2026

Copy link
Copy Markdown

Claude finished @mokashang's task in 3m 23s —— View job


PR #92 Review: refine: author domain_knowledge/entrepreneurship/fixtures/*.yaml (Layer 6)

  • Gather context and understand request
  • Read REVIEWER_PROMPT.md for review criteria
  • Read changed YAML fixture files (11 files)
  • Compare schema against housing/fixtures/ precedent
  • Check hard-rejection criteria
  • Post review findings

Hard-Rejection Checklist

Criterion Status
.claude/settings.json / hooks touched ✅ Not touched
Skill files modified ✅ Not touched
pyproject.toml new deps ✅ Not touched
db/migrations/** ✅ Not touched
tests/** deletion ✅ Not touched
domain_knowledge/_archive/ touched ✅ Not touched
New vertical domain folder created entrepreneurship/ already existed (PRs #59/#71/#79/#82/#91)
Voice-work files modified ✅ Not touched (only cn-sde-jobhunt/ voice files are protected)
Prompt injection patterns ✅ None found
Hardcoded credentials/PII ✅ None found

Schema Consistency

All 11 fixtures match the housing/fixtures/ schema exactly: id, text, expected_domains, expected_entities, expected_personas, expected_risk_surfaces, expected_decisions, expected_framings, expected_blindspot_categories. ✅

Coverage Completeness

  • Decisions D1–D11: All 11 covered across the fixture set ✅
  • Framings F1–F14: All 14 present across the fixture set ✅
  • Personas: 11 distinct personas as claimed ✅

Consult Routing (Mechanism E)

Six tail-risk fixtures correctly carry high-stakes-consult-* entries:

  • cofounder-equity-split-vesting-cliff.yaml → startup attorney founder-side ✅
  • llc-vs-s-corp-ca-180k-consultant.yaml → S-corp CPA multi-state ✅
  • safe-stack-priced-seed-qsbs.yaml → startup attorney on conversion ✅
  • w2-vs-1099-first-engineer-ca-ab5.yaml → employment-law attorney ABC-test states ✅
  • solo-401k-vs-sep-ira-backdoor-roth.yaml → retirement-experienced CPA ✅
  • cofounder-departure-dispute-ca-non-compete.yaml + international-founder-delaware-c-corp-1202.yaml → dual-attorney routing ✅

Five lower-risk fixtures carry not-a-substitute-for-case-specific-licensed-counsel appropriately ✅

Factual Content Spot-Check

  • Statute citations verified: IRC §83(b), §199A, §1202, §351, CA Labor Code §2870, CA Bus & Prof Code §16600, CA AB-5, FTC 2024 rule, NY 2023 ABC-style law ✅
  • QSBS clock mechanics (SAFE ≠ stock issuance): correctly consistent across safe-stack-priced-seed-qsbs.yaml and international-founder-delaware-c-corp-1202.yaml
  • CA §16600 non-compete void + non-solicit more enforceable: correctly stated in cofounder-departure-dispute-ca-non-compete.yaml
  • Backdoor Roth pro-rata math in solo-401k-vs-sep-ira-backdoor-roth.yaml: $7k × $7k/($7k + $57k) = $766 nontaxable — arithmetic correct ✅
  • QSBS state non-conformity (CA/NY/NJ): correctly flagged in both QSBS-touching fixtures ✅

Minor Observation (Non-blocking)

llc-vs-s-corp-ca-180k-consultant.yaml:12–14: The fixture states the asker is "currently paying ~$22k SE tax" on $182k net SE income. The correct figure is approximately ~$25.7k (15.3% on $168,077 = 0.9235 × $182k). This is likely the asker's own approximation — the fixture is presenting an imperfect question, not an authoritative answer, and the key blind spots (SSTB/QBI interaction, multi-state nexus) are unaffected. Not a blocking issue.

Verdict

APPROVE. Pure-additive Layer 6 content, schema-consistent with housing/fixtures/ precedent, all 11 decisions and all 14 framings covered, correct consult routing on tail-risk decisions, no protected paths touched, no injection patterns, no credentials. Matches the V2 ROADMAP checklist item v2/entrepreneurship/fixtures-md (advancing 5/8 → 6/8).


Note on merge: I'm unable to merge pull requests directly — this requires a human reviewer with merge permissions in GitHub. You can merge this PR via the GitHub UI or gh pr merge 92 --merge. Based on my review, the PR is clean and ready to merge.

@mokashang
mokashang merged commit d77ff38 into main May 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant