Skip to content

PE hyperstack: add bro - generalist capability persona - #127

Merged
KailasMahavarkar merged 1 commit into
mainfrom
f-PE-hyperstack-bro-persona
Jul 18, 2026
Merged

PE hyperstack: add bro - generalist capability persona#127
KailasMahavarkar merged 1 commit into
mainfrom
f-PE-hyperstack-bro-persona

Conversation

@KailasMahavarkar

Copy link
Copy Markdown
Collaborator

Adds bro, the 4th persona and first generalist: a very capable, pragmatic 28-30 human lens spanning ui-ux, design, coding, marketing, and sales. Bro decomposes any new challenge into sub-problems, attacks each with the full skill/MCP/web surface, and combines the learnings into the overall solve. Capability mode; produces and hands back to hyper.

Design decisions

Decision Rationale
"plugin": "*" binding generalist owns no single corpus - binds the whole plugin surface; documented in personas/README.md
CHECKS.md included bro carries a falsifiable quality bar (only pm had one before); capability persona with gate-grade self-checks
Registry bullet kept single-line compiler extractSimpleBullets drops continuation lines (pm's multi-line bullet is truncated in bootstrap) - single line survives compilation whole
No MCP plugin plugin count stays 16; all existing count assertions untouched

Behavior contract (from spec)

Trait Where
Decompose -> approach each -> combine Bro Law + operating loop (SKILL, LIFECYCLE)
Session tool-call inventory, cached Bro Law + session bootstrap
Evidence-backed; blunt "heuristic, not measured" evidence discipline
No comment poisoning; trim or omit code discipline + CHECKS
Quality pride: scale, optimize mission + quality pass + CHECKS
Controlled subtask dispatch; >2min -> monitor, kill after subtasks and time
UI gear change: interaction flow -> behaviour-analysis -> ui-ux -> designer UI gear change section
Web search for cross-validation evidence discipline
Fail fast: stop -> retrospective -> re-analyze -> re-allocate Bro Law + fail fast
UTF-8 diagrams, padded tables output style
Smart-decision pushing (user gets sharper) voice + evidence discipline
Japanese-learning sidekick, skipped on high-priority (review/bugs/db-prod/releases/migrations) sidekick sections

Contents

File Intent
personas/bro/persona.json capability manifest, plugin: "*", engages_when triggers
personas/bro/PROFILE.md identity, voice, method, authority, sidekick
personas/bro/LIFECYCLE.md engage criteria, session bootstrap, operating loop, gear change, handback
personas/bro/CHECKS.md 10 falsifiable quality checks
skills/bro/SKILL.md the behavior engine (Bro Law + disciplines)
skills/hyperstack/SKILL.md persona registry bullet (single-line)
personas/README.md table row
tests/persona-registry-behaviour.test.ts bro load assertions
skills/INDEX.md, generated/.../hyperstack.bootstrap.md regenerated

Verification

  • bun test: 86 pass, 0 fail (was 85; +1 bro registry test)
  • bun run compile:context: succeeds, all 34 markers intact, bro bullet present whole in bootstrap line 86
  • bun run skills:index: bro row generated
  • em-dash sweep on new files: clean

Bro: very capable, pragmatic 28-30 generalist (ui-ux, design, coding,
marketing, sales). Decomposes challenges into sub-problems, solves each
with the full skill/MCP/web surface, combines learnings. Evidence-backed,
blunt about heuristics, comment-trimming, quality-proud (scale, optimize),
controlled subtask dispatch with 2-minute monitor rule, fail-fast
retrospectives, UTF-8 visual output, UI gear-change chain
(behaviour-analysis -> ui-ux -> designer), optional Japanese-learning
sidekick skipped during high-priority work.

Binds the whole plugin surface (plugin: "*") instead of one corpus -
first generalist persona. Ships persona vertical (manifest, PROFILE,
LIFECYCLE, CHECKS), the bro skill, registry test, README row, persona
registry bullet + recompiled bootstrap and INDEX.
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