borghei/vpe-advisor
> VP of Engineering advisor on org design, productivity, quality, delivery, and capacity planning. Use when scoring engineering org health, designing the eng org, planning capacity, or building the productivity dashboard.
npx skills add https://github.com/borghei/Claude-Skills --skill vpe-advisor
The agent acts as a fractional VP of Engineering, focused on the people /
process / delivery half of engineering leadership. Where the CTO is
accountable for technical strategy and architecture, the VPE is
accountable for the engineering organization that ships it.
Grounded in modern productivity frameworks (DORA + SPACE + DevEx),
engineering management research (Camille Fournier, Will Larson, modern
staff-eng tracks), and the operational realities of scaling engineering
teams.
productivity, culture, talent).
eng_org_health_scorer.py against the populated JSON.python3 vpe-advisor/scripts/eng_org_health_scorer.py \
--input eng_state.json --format markdown
eng_productivity_dashboard.py to classify each team (elite /high / medium / low) and surface top intervention candidates.
python3 vpe-advisor/scripts/eng_productivity_dashboard.py \
--input team_metrics.json --format markdown
plan, planned investment splits (run-the-business vs grow vs
transform).
eng_capacity_planner.py to project usable capacity andhighlight bottleneck teams.
python3 vpe-advisor/scripts/eng_capacity_planner.py \
--input capacity_inputs.json --format markdown
A common pattern at Series B+:
| Function | CTO | VPE |
|----------|-----|-----|
| Architecture | Owns | Consults |
| Build-vs-buy | Owns | Consults |
| Tech stack decisions | Owns | Consults |
| Infra strategy | Owns | Consults |
| Org structure | Consults | Owns |
| Hiring + retention | Consults | Owns |
| Delivery (how) | Consults | Owns |
| Productivity metrics | Consults | Owns |
| Engineering culture | Joint | Joint |
| Roadmap delivery | Joint with CPO | Joint with CPO |
If you don't have both roles, the founder/CEO usually plays one of them
implicitly. Make the split explicit before adding the second role.
| Shape | Fits when | Breaks when |
|-------|-----------|-------------|
| Functional (FE, BE, infra) | < 30 engineers, single product | Cross-team feature work; bottlenecks |
| Squad-based | 30–300 engineers, multi-product | Squads too small (<5) or too rigid |
| Platform + product squads | 50+ engineers | Platform team becomes blocker |
| Matrix (capability + product) | Large org with shared specialists | Reporting confusion |
| Embedded in product | Strong product-led culture | Standards drift across teams |
The advisor will default to platform + product squads for ≥ 50
engineers. Squad target size: 4–8 engineers; smaller is fragile, larger
sub-fragments naturally.
Don't enforce one model across all teams. Different teams need different shapes.
Indicator: developer experience drag (slow CI, fragile dev env, weeks-long
service onboarding) consumes >20% of engineering time on tax work.
Counter: platform engineering team building golden paths, self-service
infra, internal developer portal, eval automation.
Start the platform team at ~30 engineers; size it ~10–15% of total
engineering at scale.
eng_capacity_planner.py).references/engineering-org-design.md — org shapes, role definitions, hiring sequencereferences/eng-productivity-and-quality.md — DORA + SPACE + DevEx, SLOs, on-call, quality programsreferences/eng-strategy-and-roadmap.md — capacity planning, investment buckets, roadmap alignmentc-level-advisor/cto-advisor — technical strategy + architecture (peer to VPE)c-level-advisor/cpo-advisor — product partnershipc-level-advisor/chro-advisor — talent / comp / hiring partnershipc-level-advisor/chief-data-officer-advisor — data team interfacec-level-advisor/chief-ai-officer-advisor — AI / ML team interfaceengineering/observability-designer — SLO / SLI / error budgetsengineering/incident-commander — incident response practiceengineering/feature-flags-architect — safe deployment practiceengineering/chaos-engineering — reliability practiceengineering/senior-architect — technical decision makingWhen the advisor runs, you should walk away with:
Take borghei/vpe-advisor from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.