GitHub

What each role can do

ACEF for your role

Everyone talks to the same acef agent in plain language. You never pick routes, phases, or skills — you just describe what you want. This page shows what each role can do and which flows concern them.

🔭One framework, different lenses

The engine is the same for everyone: it understands your project, routes the request, and runs only the steps that matter. What changes per role is the lens — which flows are yours.

Developer
builds and fixes — features, bugs, tests in code.
PM / architect
frames, plans, and gates — scope, risk, go/kill.
Test / QA
turns behavior into checks — flows, cases, automation.
🧱
Internal BMAD personas are separate: user-facing roles are lenses, but full BMAD execution uses worker identities. Test Author, Developer, Code Reviewer, Verify-Patch Reviewer, Test Reviewer, and Process Judge must be separate where the story lifecycle requires it. The conductor/dispatcher coordinates; it does not author or approve the work.

👩‍💻Developer

What you can do — describe the work in plain words; ACEF grounds it in your repo and reviews the result.

Add a small feature A

ACEF copies the pattern your repo already uses for that kind of screen/endpoint, wires your change, and reviews it.

Build a large feature B

It turns the work into requirements, design, and tasks, then builds each task — pausing for approval on risky parts.

Fix a bug C

Give the symptom; it reproduces, finds the root cause, and makes the smallest fix that matches your code’s style.

Add unit / integration tests F

It writes tests in your project’s real framework, around behavior — not implementation detail.

You see
the task · the real code to copy · files likely touched · the definition of done.
You don’t deal with
specs, planning, or risk dashboards — that’s handled around you.
Developer
The avatar disappears after editing a profile.
ACEF
Bug fix. I’ll reproduce on a fresh profile, find the root cause, and fix it the way this repo handles image state — then add a regression test. Only after a refresh, or immediately?

🧭Project manager / architect

What you can do — shape and control the work without touching code.

Frame a brief Brief

Turn a raw idea into a clear brief: the problem, who it’s for, success criteria, scope, and explicit non-goals.

Plan a feature Planning

Break it into a story map and traceable tasks — every task links back to a requirement, so scope is auditable.

Get a risk read Risk

See the risk class of any work and exactly which steps are guarded (auth, payment, migrations, multi-repo).

Gate the work Go / Kill

Approve, hold, or kill at the gate. Guarded work cannot merge without your sign-off.

Track status Status

See what’s queued, building, in review, blocked, or done across the work in flight.

You see
scope & non-goals · the plan · risk · the go/kill gate · status.
You don’t deal with
code or implementation detail — unless you ask for it.
PM
How big is team billing, and what’s the risk?
ACEF
Large feature, high risk — it touches payment, adds a new contract, and spans the API and dashboard. It needs a brief, a plan, and your approval before the payment step merges. Want the brief drafted?

🧪Test engineer / QA

What you can do — turn behavior into checks, in your project’s real test setup.

Extract test cases D

Turn product flows into acceptance criteria and structured test cases — ready to review or automate.

Write unit / integration tests F

Tests written in your project’s actual framework and command set, around real behavior.

Build test automation E

Automate the priority user flows end-to-end, on the stack your repo already uses.

Bootstrap the first test E / F

Zero tests in the repo? It sets up one approved example pattern that every later test follows.

Scale coverage by risk All

Happy path for low-risk flows; negative, edge, permission, session, and failure cases for guarded ones.

A flow becomes structured cases like this:

CasePreconditionStepsExpectedType
Login · happyvalid accountenter creds → submitlands on dashboardpositive
Login · wrong passwordvalid accountwrong password → submitinline error, no sessionnegative
Login · lockedlocked accountsubmitlockout messageedge
Login · sessionlogged inrefreshstays authenticatedsession
You see
flows · acceptance criteria · test cases · validation evidence.
You don’t deal with
implementation internals — you work at the behavior level.

📊At a glance

RoleWhat you can doFlows
Developeradd small/large features · fix bugs · write unit/integration testsA · B · C · F
PM / architectframe a brief · plan · risk read · gate (go/kill) · track statusbrief · planning · gates
Test / QAextract test cases · write unit tests · build automation · bootstrap first test · scale coverageD · E · F
BMAD story workersATDD · development · code review · verify-patch · test review · process judgmentfull BMAD v2

All three talk to the same front-door agent — the lens is what changes. In full BMAD, the story ledger still records separate worker personas so one actor cannot build and approve the same work.