Phronesis: Install, Source and Security | FunnelSlayer
FunnelSlayer
Book a call

Phronesis

Published by broomva in skills

Review recommended5 installs

What this skill does

AI-native advisory practice for the Broomva ecosystem. Encodes top-firm consulting methodology (Three Horizons, MIT CISR digital maturity, JTBD, Value Proposition Canvas, RICE/ICE/WSJF, NPV + Real Options, QuantumBlack ML lifecycle, Wardley Mapping) as runnable typed primitives. Produces 7 Discovery-grade deliverables in two modes — consultant CLI or autonomous Life Runtime endpoint. Use when: (1) running an AI/digital consulting engagement, (2) building a maturity assessment, (3) generating pri

Add Phronesis to your agent

Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.

Install with a prompt

Paste this into a compatible coding agent:

add this skill "phronesis" from https://github.com/broomva/skills

Install with the CLI

Run this command in a controlled environment after reviewing the repository:

npx skills add https://github.com/broomva/skills --skill phronesis

Skill instructions

phronesis — AI-native Advisory Practice

Status: Phase 1 complete (v0.1.2-pre) — substrate + 15 active frameworks + 5 stages + 7 deliverables + L1–L5 linter + M7 extraction pipeline. Phase 2 engagement-driven (M4 stage CLI + M5 autonomous-mode stub-to-real path). Track progress: docs/methodology.md (canonical reference), docs/adr/0001-0008, and the design spec at ~/broomva/docs/superpowers/specs/2026-05-06-phronesis-design.md.

What it does

Runs AI/digital consulting engagements through 5 stages:

  1. Intake — stakeholder map, interview guide, strategic thesis (kills "hagamos algo de IA" — Bision empirical 100% failure)
  2. Maturity Scan — MIT CISR + Gartner AI dimensions, gap analysis, capability heatmap
  3. Use-Case Ideation — JTBD + VPC, with IdeationSource diversity check
  4. Prioritization — RICE/ICE/WSJF, ROI Model with sensitivity, Impact-Effort Matrix
  5. Roadmap Synthesis — Three Horizons, QuantumBlack ML lifecycle pilots, baselines captured

Each stage has a non-negotiable human-review gate.

When to invoke this skill

  • User asks for AI/digital consulting work — maturity assessment, roadmap, use-case prioritization
  • User mentions Spanish-language equivalents: "consultoría", "evaluación de madurez", "hoja de ruta"
  • User describes a Fast Discovery, discovery sprint, or strategic-thesis-finding engagement
  • User wants to extract reusable IP from a completed engagement (cross-engagement learning)

When NOT to invoke this skill

  • User wants generic "do AI for me" without scope — phronesis explicitly refuses to start without a strategic thesis
  • User wants implementation work, not advisory — phronesis produces plans and recommendations, not running systems
  • User wants change-management or organizational design — that's D-scope (deferred to a later phase)
  • User wants only personal-decision support — use strategy-skills instead

Commands (CLI mode — most land in M4)

phronesis init <tenant> --industry <industry> --region <iso> --sponsor "Name (Role)" --scope "..."
phronesis intake --interview "..." --transcript path/to/file.md
phronesis intake --thesis "..."         # captures StrategicThesis (L1)
phronesis review intake --approve | --revise
phronesis scan --frameworks mit-cisr-digital,gartner-ai
phronesis ideate --frameworks jobs-to-be-done,value-prop-canvas
phronesis prioritize --frameworks rice --roi unit-economics,real-options
phronesis roadmap --frameworks three-horizons --pilot-design quantumblack-ml
phronesis render --all
phronesis lint                          # P3, P7, P8, L1-L5 enforcement (blocking)
phronesis status
phronesis bookkeep <slug>               # extract anonymized learnings to research/entities/

Five C-level failure modes structurally prevented

Bision-observedFrequencyLinter ruleType primitive
Sin tesis estratégica100%L1 STRATEGIC_THESIS_REQUIREDStrategicThesis
Casos mal priorizados87%L2 DIVERSE_IDEATION_SOURCESIdeationSource
Datos no preparados74%L3 DATA_READINESS_GATEDataReadinessAssessment
Desconexión negocio-tech61%L4 ADOPTION_METRIC_REQUIREDAdoptionMetric
Sin medición de ROI48%L5 BASELINE_REQUIREDBaselineSection

Documentation

  • Methodology: docs/methodology.md — canonical methodology reference (10 sections: stages, deliverables, frameworks, gates, linter, anonymization, modes, discovery loop, IP extraction)
  • ADRs: docs/adr/0001- through 0008-
  • Design spec: ~/broomva/docs/superpowers/specs/2026-05-06-phronesis-design.md
  • Linear: Phronesis project
  • Quickstart: (M4 — pending stage CLI commands) docs/quickstart.md

Files included

  • .githooks/pre-commit
  • .gitignore
  • CHANGELOG.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • core/__init__.py
  • core/anonymize.py
  • core/engagement.py
  • core/events.py
  • core/extraction/__init__.py
  • core/extraction/anonymizer.py
  • core/extraction/candidates.py
  • core/extraction/pipeline.py
  • core/frameworks.py
  • core/linter.py
  • core/orchestrator.py
  • core/render.py
  • core/revision.py
  • core/selector.py
  • core/types.py
  • docs/adr/0001-python-substrate-life-engine-phased.md
  • docs/adr/0002-frameworks-organized-by-purpose.md
  • docs/adr/0003-event-sourced-engagement-journal.md
  • docs/adr/0004-five-review-gates-non-negotiable.md
  • docs/adr/0005-anonymization-strict-by-default.md
  • docs/adr/0006-decimal-for-money.md
  • docs/adr/0007-canary-test-as-release-gate.md
  • docs/adr/0008-bision-failure-mode-linter-rules.md
  • docs/methodology.md
  • docs/README.md
  • frameworks/_schema.yaml
  • frameworks/ai-lifecycle/andrew-ng-pipeline.yaml
  • frameworks/ai-lifecycle/google-pair.yaml
  • frameworks/ai-lifecycle/ms-responsible-ai.yaml
  • frameworks/ai-lifecycle/quantumblack-ml.yaml
  • frameworks/change/adkar.yaml
  • frameworks/change/kotter-8-steps.yaml
  • frameworks/change/mckinsey-influence.yaml
  • frameworks/ideation/business-model-canvas.yaml
  • frameworks/ideation/jobs-to-be-done.yaml
  • frameworks/ideation/lean-canvas.yaml
  • frameworks/ideation/value-prop-canvas.yaml
  • frameworks/maturity/chaoss.yaml
  • frameworks/maturity/forrester-data.yaml
  • frameworks/maturity/gartner-ai.yaml
  • frameworks/maturity/mckinsey-7s.yaml
  • frameworks/maturity/mit-cisr-digital.yaml
  • frameworks/prioritization/cost-of-delay.yaml
  • frameworks/prioritization/ice.yaml
  • frameworks/prioritization/rice.yaml
  • frameworks/prioritization/wsjf.yaml
  • frameworks/roi/npv-dcf.yaml
  • frameworks/roi/owner-earnings.yaml
  • frameworks/roi/real-options.yaml
  • frameworks/roi/unit-economics.yaml
  • frameworks/strategy/five-forces.yaml
  • frameworks/strategy/three-horizons.yaml
  • frameworks/strategy/wardley-mapping.yaml
  • frameworks/strategy/where-to-play-how-to-win.yaml
  • LICENSE
  • Makefile
  • pyproject.toml
  • README.md
  • references/anonymization-policy.md
  • references/extraction-workflow.md
  • runners/__init__.py
  • runners/cli/__init__.py
  • runners/cli/__main__.py
  • runners/cli/commands/__init__.py
  • runners/cli/commands/bookkeep.py
  • runners/cli/io.py
  • scripts/lint_frameworks.py
  • SECURITY.md
  • SKILL.md
  • stages/__init__.py
  • stages/01_intake/prompts/strategic_thesis_elicitation.md
  • stages/base.py
  • stages/ideate.py
  • stages/intake.py
  • stages/prioritize.py
  • stages/roadmap.py
  • stages/scan.py
  • templates/capability-heatmap.md.j2
  • templates/impact-effort-matrix.md.j2
  • templates/innovation-roadmap.md.j2
  • templates/maturity-report.md.j2
  • templates/pilot-plan.md.j2
  • templates/roi-model.md.j2
  • templates/use-case-dossier.md.j2
  • tests/__init__.py
  • tests/conftest.py
  • tests/fixtures/__init__.py
  • tests/fixtures/acme_bank.py
  • tests/fixtures/nova_construction.py
  • tests/fixtures/tropico_renovables.py
  • tests/integration/__init__.py
  • tests/integration/test_acme_bank_e2e.py
  • tests/integration/test_anonymization_canary.py
  • tests/integration/test_bision_prevention.py
  • tests/integration/test_cli_smoke.py

More skills