Skip to content

feat(v1.1.0): Services Hub pattern + 3-mode studio readiness#6

Merged
lapc506 merged 3 commits intomainfrom
feat/v1.1-services-hub
Apr 15, 2026
Merged

feat(v1.1.0): Services Hub pattern + 3-mode studio readiness#6
lapc506 merged 3 commits intomainfrom
feat/v1.1-services-hub

Conversation

@lapc506
Copy link
Copy Markdown
Collaborator

@lapc506 lapc506 commented Apr 15, 2026

Summary

Replaces auto-closed PR #4. Same scope, rebased on main after merge of #1, #2, #3.

  • New skill services-hub-setup (patrón feat(v1.1.0): Services Hub pattern + 3-mode studio readiness #6) — middle ground between Multi-LLC and formal studio
  • Refactored when-to-become-studio from binary ready/not-ready → 3-mode routing (Mode 1/2/3)
  • Updated structure-decision, shared-services-ledger, attached-fund-structure to integrate with Services Hub
  • New canonical reference lapc506-services-hub-canonical.md
  • v1.1.0 release in plugin.json + CHANGELOG

Greptile 5/5 on prior PR #4 (commit a06396e).

Test plan

  • CI green on rebased branch
  • Greptile re-confirms 5/5

🤖 Generated with Claude Code

lapc506 and others added 3 commits April 15, 2026 02:49
v1.1 release driven by dog-food of v1.0 against @lapc506 4-venture portfolio
(DOJ-3190 dog-food reveló el gap). Services Hub fills the middle ground entre
serial entrepreneur y formal venture studio con fund atado.

Parent Epic: DOJ-3193

New:
- skills/services-hub-setup/SKILL.md (DOJ-3195): implementa Services Hub Model
  con MSA template + SOW template + transfer pricing cost-plus 10% + IP
  assignment rider + billing calendar. Strong legal disclaimer.
- references/lapc506-services-hub-canonical.md (DOJ-3199): canonical example
  aplicado al caso @lapc506 (Altrupets, Vertivolatam, Habitanexus, Aduanext).
  Concrete numbers ($6k setup, $4.4k annual).

Updated:
- skills/structure-decision/SKILL.md (DOJ-3194): added pattern #6 Services Hub,
  shifted Multi-LLC+Holding a #7. Regla 2 decision tree routes 3+ ventures con
  shared services + independent VC raises a Services Hub. Added case 4 (@lapc506).
- skills/when-to-become-studio/SKILL.md v1.1.0 (DOJ-3196): refactored de binary
  (ready/not ready) a 3 operating modes: serial entrepreneur puro / Services Hub
  operator / formal studio con fund.
- skills/shared-services-ledger/SKILL.md v1.1.0 (DOJ-3197): added operating mode
  selection Services Hub vs Full Studio con distinct billing/reporting/transfer
  pricing per mode.
- skills/attached-fund-structure/SKILL.md (DOJ-3198): upfront "¿Este skill es
  para vos?" section routing usuarios apropiadamente (la mayoría NO necesita
  fund atado).

Version bump: 1.0.0 → 1.1.0 + CHANGELOG updated.

Pending v1.2:
- DOJ-3200: cross-plugin update business-model-toolkit Fase 13 (separate PR en
  BMT repo)
- Bilingual output YAML config implementation
- MCP integration (Linear/Carta/Mercury)

Created by Claude Code on behalf of @lapc506

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… routing

Greptile review on PR #4 identified 2 P1 bugs + 1 minor (score 4/5). Address all.

**P1 #1**: services-hub-setup referenced "patrón #7" but structure-decision assigns
Services Hub como patrón #6 (Multi-LLC+Holding is #7). Fixed 3 occurrences:
- Line 12 description frontmatter
- Line 73-74 prerequisite section
- Line 337 integration section

**P1 #2**: when-to-become-studio WS-2 execution block still used v1.0 binary
thresholds (7-9 = ready, 5-6 = casi listo) instead of v1.1 3-mode routing.
Rewrote WS-2 con explicit routing:
- 0-4 ✓ → Mode 1 (Serial entrepreneur puro)
- 5-7 ✓ → Mode 2 (Services Hub operator)
- 8-9 ✓ + plan fund REAL → Mode 3 (Formal studio con fund)
- 8-9 ✓ SIN plan fund real → Mode 2 (Services Hub, no Holding overhead)

Also removed stale "5-6 ✓: Casi listo" bullet en Reglas adicionales que
contradecía el 3-mode routing (Mode 2 covers 5-7, not "casi listo").

**Minor**: structure-decision output template decía "uno de los 6 patrones" —
updated a 7.

All fixes are text-only, no structural changes. Cross-skill consistency restored.

Addresses Greptile feedback on PR #4. Parent Epic: DOJ-3193.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… routing

P1: when-to-become-studio output template stale.
- Verdict: replaced binary "[Listo / Casi listo / NO todavía]" with explicit
  3-mode recommendation including rationale (score, fund plan reality, routing
  applied)
- Section headers: "[If ready]" → "[Si Modo 2 o Modo 3]" with mode-specific
  roadmaps; "[If not ready]" → "[Si Modo 1] Gaps to close hacia Modo 2"

P2: Transición section conflated Mode 2 and Mode 3 setup.
- Split into two distinct subsections: "Transición hacia Modo 2 — Services Hub
  operator" and "Transición hacia Modo 3 — Formal venture studio con fund"
- Mode 2 path: Services LLC + Multi-LLC, NO holding, NO fund
- Mode 3 path: Holding + Management Co + GP + LP stack
- Each path lists the specific skills to invoke (services-hub-setup vs
  attached-fund-structure)

P2: attached-fund-structure version bump 1.0.0 → 1.1.0
- Material new content in v1.1 (routing disclaimer "¿Este skill es para vos?")
  but frontmatter version was stale

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lapc506 lapc506 merged commit 14ce7da into main Apr 15, 2026
@lapc506 lapc506 deleted the feat/v1.1-services-hub branch April 15, 2026 08:49
@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Apr 15, 2026

Greptile Summary

This PR introduces the Services Hub pattern (patrón #6) as a middle ground between serial-entrepreneur Multi-LLCs and a formal studio with an attached fund, and refactors when-to-become-studio from binary ready/not-ready into a 3-mode routing system. All 5 updated/new skills are coherently cross-referenced and the new lapc506 canonical reference provides concrete numbers grounding the pattern.

Confidence Score: 5/5

Safe to merge — all findings are P2 style/consistency improvements with no blocking logic errors.

All remaining findings are P2: a missing table row (covered by the rules section below it), a transfer pricing range that understates the default, a stale version field, a missing integration link, and a missing keyword. None affect functional skill routing correctness. The core 3-mode routing logic, cross-skill references, legal disclaimers, and canonical case are internally consistent and well-documented.

skills/when-to-become-studio/SKILL.md (decision table gap + TP range), skills/structure-decision/SKILL.md (version field), .claude-plugin/plugin.json (missing keyword)

Important Files Changed

Filename Overview
skills/when-to-become-studio/SKILL.md Major refactor to 3-mode routing; well-structured but the primary Decisión table omits the explicit 8-9 ✓ WITHOUT fund → Mode 2 row, and the transfer pricing range cited (5-10%) understates the 10%-default used in services-hub-setup.
skills/services-hub-setup/SKILL.md New skill; 7-step flow is well-structured, strong legal/tax disclaimers present, good cross-references to related skills and OECD guidelines.
skills/structure-decision/SKILL.md Correctly adds patrón #6 and renumbers #7; Regla 2 decision table updated accurately; YAML frontmatter version remains 1.0.0 despite significant content changes, unlike the other skills updated in this PR.
skills/shared-services-ledger/SKILL.md Operating mode table correctly added at the top; differencias operacionales are clear; Integración con otras skills section at the bottom does not list services-hub-setup despite it being the complementary skill for Services Hub mode.
skills/attached-fund-structure/SKILL.md Well-placed guard clause added upfront; correctly routes non-qualifying users to services-hub-setup or when-to-become-studio; version bumped to 1.1.0.
references/lapc506-services-hub-canonical.md Concrete canonical case with real numbers; architecture diagram, setup cost breakdown, and evolution triggers all present; appropriate privacy note on omitted personal data.
.claude-plugin/plugin.json Version correctly bumped to 1.1.0; services-hub is not present in keywords despite being the headline feature of this release, unlike other patterns which are all listed.
CHANGELOG.md Comprehensive changelog entry with Linear issue links, clear added/fixed/pending sections, and accurate description of all changed skills.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A([Start: when-to-become-studio]) --> B[Evaluate 9 readiness signals]
    B --> C{Score?}
    C -->|0–4 ✓| D[**Modo 1**\nSerial entrepreneur puro]
    C -->|5–7 ✓| E[**Modo 2**\nServices Hub operator]
    C -->|8–9 ✓| F{Real fund plan?\nLP conversations initiated?}
    F -->|Yes| G[**Modo 3**\nFormal studio con fund]
    F -->|No| E
    D --> D1[structure-decision\npatrones 1–5]
    D --> D2[Re-assess in 6–12 months]
    E --> E1[structure-decision\npatrón #6]
    E --> E2[services-hub-setup\nMSAs + transfer pricing]
    E --> E3[shared-services-ledger\nServices Hub mode]
    G --> G1[structure-decision\npatrón #7]
    G --> G2[attached-fund-structure\nMgmt Co + GP + LP]
    G --> G3[shared-services-ledger\nFull Studio mode]
    G --> G4[studio-thesis / studio-focus\n/ secret-sauce]
Loading

Comments Outside Diff (3)

  1. skills/structure-decision/SKILL.md, line 1-15 (link)

    P2 Version not bumped despite significant content changes

    structure-decision remains at version: 1.0.0 while the other three skills updated in this PR (when-to-become-studio, shared-services-ledger, attached-fund-structure) were all bumped to 1.1.0. This skill received equally substantive changes: new patrón feat(v1.1.0): Services Hub pattern + 3-mode studio readiness #6, renumbered patrón feat(v1.2.0): gastronomic analogy + Mermaid diagrams + bilingual/MCP guides #7, updated Regla 2 decision table, and a new canonical case 4.

  2. skills/shared-services-ledger/SKILL.md, line 362-368 (link)

    P2 services-hub-setup missing from integration section

    The operating mode table at the top of the skill explicitly lists services-hub-setup as the complementary skill for Services Hub mode, but the "Integración con otras skills" section at the bottom omits it. Users following the integrations list as a checklist won't be directed there.

  3. .claude-plugin/plugin.json, line 12-29 (link)

    P2 services-hub keyword missing from plugin manifest

    Every other named corporate-structure pattern has a dedicated keyword (cayman-sandwich, delaware-tostada, skip-cr-pattern), but the headline feature of this release — the Services Hub Model — has no corresponding keyword. This reduces discoverability for users searching the plugin registry by pattern name.

Reviews (1): Last reviewed commit: "fix(Greptile 4/5→5/5): align output temp..." | Re-trigger Greptile

Comment on lines +102 to +109
**Decisión** (updated v1.1 — 3 modes):

| Score | Recomendación | Siguiente skill |
|---|---|---|
| 0-4 ✓ | **Modo 1 — Serial entrepreneur puro** | Multi-LLCs via `structure-decision` (patrones 1-5). No formalizar más allá. |
| 5-7 ✓ | **Modo 2 — Services Hub operator** (NUEVO) | `services-hub-setup` skill + `structure-decision` patrón #6 |
| 8-9 ✓ + plan fund atado | **Modo 3 — Formal venture studio con fund** | `attached-fund-structure` skill + `structure-decision` patrón #7 |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Decisión table missing explicit 8-9 ✓ without fund → Mode 2 row

The table only covers three scenarios, but there are four: a user scoring 8-9 with no real fund plan will find no matching row and may incorrectly default to Mode 3 (the only row shown for their score range). The correct routing (→ Mode 2) is documented in "Reglas adicionales" below, but the summary table should be self-contained.

Suggested change
**Decisión** (updated v1.1 — 3 modes):
| Score | Recomendación | Siguiente skill |
|---|---|---|
| 0-4 ✓ | **Modo 1 — Serial entrepreneur puro** | Multi-LLCs via `structure-decision` (patrones 1-5). No formalizar más allá. |
| 5-7 ✓ | **Modo 2 — Services Hub operator** (NUEVO) | `services-hub-setup` skill + `structure-decision` patrón #6 |
| 8-9 ✓ + plan fund atado | **Modo 3 — Formal venture studio con fund** | `attached-fund-structure` skill + `structure-decision` patrón #7 |
| Score | Recomendación | Siguiente skill |
|---|---|---|
| 0-4 ✓ | **Modo 1 — Serial entrepreneur puro** | Multi-LLCs via `structure-decision` (patrones 1-5). No formalizar más allá. |
| 5-7 ✓ | **Modo 2 — Services Hub operator** (NUEVO) | `services-hub-setup` skill + `structure-decision` patrón #6 |
| 8-9 ✓ + plan fund atado REAL (LP conversations iniciadas) | **Modo 3 — Formal venture studio con fund** | `attached-fund-structure` skill + `structure-decision` patrón #7 |
| 8-9 ✓ SIN plan fund atado real | **Modo 2 — Services Hub operator** | `services-hub-setup` skill + `structure-decision` patrón #6. Re-evaluar a Modo 3 cuando haya LP conversations iniciadas. |

Comment on lines +140 to +142
- Ver skill `services-hub-setup` para:
- MSA template bilateral (Services LLC ↔ cada Venture LLC)
- SOW templates por service type
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Transfer pricing range inconsistency with services-hub-setup

This section states cost-plus (5-10% markup típico), but services-hub-setup establishes 10% as the standard default with 5% reserved for low-value services and 15% for highly specialized work. A user reading only this roadmap step would underestimate the recommended markup, potentially producing documentation that conflicts with what services-hub-setup generates.

Suggested change
- Ver skill `services-hub-setup` para:
- MSA template bilateral (Services LLC ↔ cada Venture LLC)
- SOW templates por service type
- Transfer pricing cost-plus 10% markup (OECD-defensible; ver `services-hub-setup` para rangos por tipo de servicio)

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