Skip to content

docs: remove phase-4 agent persona references#2020

Open
alexeyv wants to merge 15 commits intodelete-phase4-agentsfrom
docs-phase4-agent-removal
Open

docs: remove phase-4 agent persona references#2020
alexeyv wants to merge 15 commits intodelete-phase4-agentsfrom
docs-phase4-agent-removal

Conversation

@alexeyv
Copy link
Copy Markdown
Collaborator

@alexeyv alexeyv commented Mar 16, 2026

Summary

  • Removes all references to deleted phase-4 agent personas (dev/Amelia, pm/John, qa/Quinn, sm/Bob, quick-flow-solo-dev/Barry, bmad-master) from 11 English doc files
  • Replaces deleted agent skill invocations with equivalent workflow skills (bmad-dev-story, bmad-quick-spec, bmad-quick-dev, bmad-qa-generate-e2e-tests, etc.)
  • Depersonalizes QA references ("Quinn" → "Built-in QA" / "QA workflow") and Quick Flow references ("Barry" → "the agent")

Follow-up to #2014 — targets delete-phase4-agents branch.

Test plan

  • grep verification: zero matches for deleted agent names/skill IDs in English docs
  • Surviving agents (Mary, Winston, Sally, Paige) remain intact
  • npm run docs:build passes with no broken links
  • Full pre-commit gate passes (lint, format, schemas, tests)
  • Visual review of rendered docs pages

🤖 Generated with Claude Code

bmadcode and others added 11 commits March 15, 2026 17:31
…rce of truth

Replace duplicated workflow-era rules in .augment/code_review_guidelines.yaml
with a single reference to tools/skill-validator.md. Append the skill spec
cheatsheet to the validator with a link to the Agent Skills specification.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Previously the quality workflow only triggered on pull_request events,
so direct pushes to main (including merged PRs) skipped all CI checks.
Add a push trigger for the main branch so broken builds are caught.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Keep cheatsheet focused on the Agent Skills open standard only.

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

chore(tools): align Augment config with skill-validator
Follow-up to the agent persona deletion in the parent branch.
Update 11 English doc files to remove references to deleted agents
(dev/Amelia, pm/John, qa/Quinn, sm/Bob, quick-flow-solo-dev/Barry,
bmad-master) and replace with workflow skill equivalents.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@augmentcode
Copy link
Copy Markdown

augmentcode bot commented Mar 16, 2026

🤖 Augment PR Summary

Summary: This PR updates the English documentation to remove references to deleted “phase-4” agent personas (Dev/PM/QA/SM/Quick-Flow Solo Dev/BMAD Master) and standardize on workflow-skill names.

Changes:

  • Depersonalizes Quick Flow docs (e.g., “Barry” → “the agent”) while keeping the same quick-spec / quick-dev explanations.
  • Replaces removed agent invocations with equivalent workflow skills (e.g., quick-flow-solo-dev → bmad-quick-spec + bmad-quick-dev).
  • Updates “Quick Fixes” guidance to reference workflow skills instead of a DEV persona.
  • Refreshes the Agents reference to list only the remaining default BMM agents (Analyst, Architect, UX Designer, Technical Writer).
  • Updates QA mentions across docs to refer to the built-in QA workflow skill (bmad-qa-generate-e2e-tests) rather than a named agent.
  • Adjusts Getting Started to emphasize running workflows directly in fresh chats rather than loading removed personas first.

Technical Notes: The changes are documentation-only and aim to keep commands/triggers consistent with the current post–phase-4-agent-removal skill set, while preserving references to surviving agents (Mary/Winston/Sally/Paige).

🤖 Was this summary useful? React with 👍 or 👎

Copy link
Copy Markdown

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

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

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

| --- | --- | --- |
| Fix a specific bug or make a small, scoped change | **DEV agent** | Jumps straight into implementation without planning overhead |
| Change touches several files or you want a written plan first | **Quick Flow Solo Dev** | Creates a quick-spec before implementation so the agent stays aligned to your standards |
| Fix a specific bug or make a small, scoped change | `bmad-dev-story` | Jumps straight into implementation without planning overhead |
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

bmad-dev-story is designed to implement a story file (it discovers/uses sprint-status.yaml + ready-for-dev stories), but this section presents it as an ad-hoc “tell the AI in plain language” quick-fix workflow. That mismatch may leave users blocked when they don’t have story artifacts prepared.

Severity: medium

Other Locations
  • docs/how-to/quick-fixes.md:29
  • docs/how-to/quick-fixes.md:35
  • docs/how-to/quick-fixes.md:55

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.


| Agent | Skill ID | Triggers | Primary workflows |
| ---------------------- | ------------------ | ---------------------------------- | --------------------------------------------------------------------------------------------------- |
| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `DP` | Brainstorm Project, Research, Create Brief, Document Project |
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The Analyst row lists trigger RS / workflow “Research”, but the Analyst agent menu defines research triggers as MR/DR/TR (market/domain/technical) rather than RS. As written, this table likely points readers to a trigger that doesn’t exist in the default install.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

@alexeyv alexeyv force-pushed the delete-phase4-agents branch from f84b41c to 43ca26e Compare March 16, 2026 14:33
eatse21 added a commit to eatse21/BMAD-METHOD that referenced this pull request Mar 20, 2026
Remove all references to deleted phase-4 agent personas from French
documentation, matching upcoming PR bmad-code-org#2020 changes:

- Remove agent personas: dev/Amelia, pm/John, qa/Quinn, sm/Bob,
  quick-flow-solo-dev/Barry, bmad-master
- Replace deleted agent skill invocations with equivalent workflow skills
  (bmad-dev-story, bmad-qa-generate-e2e-tests, bmad-quick-dev, etc.)
- Depersonalize QA references ("Quinn" → "QA Intégré" / "Workflow QA")
- Simplify workflow invocation instructions (remove "invoke agent" pattern)
- Fix upgrade-to-v6.md SM/Scrum Master references
eatse21 added a commit to eatse21/BMAD-METHOD that referenced this pull request Mar 20, 2026
Remove all references to deleted phase-4 agent personas from French
documentation, matching upcoming PR bmad-code-org#2020 changes:

- Remove agent personas: dev/Amelia, pm/John, qa/Quinn, sm/Bob,
  quick-flow-solo-dev/Barry, bmad-master
- Replace deleted agent skill invocations with equivalent workflow skills
  (bmad-dev-story, bmad-qa-generate-e2e-tests, bmad-quick-dev, etc.)
- Depersonalize QA references ("Quinn" → "QA Intégré" / "Workflow QA")
- Simplify workflow invocation instructions (remove "invoke agent" pattern)
- Fix upgrade-to-v6.md SM/Scrum Master references
alexeyv added a commit that referenced this pull request Mar 20, 2026
* docs: i18n(fr): add complete French translation

Add comprehensive French (fr-FR) translation covering all documentation
sections and website configuration:

- Core docs, How-to guides, Explanations, References
- Website config: astro.config.mjs locale setup, fr-FR.json i18n strings
- Assets: French workflow map diagram and quick-dev diagram

Terminology standardized on "Quick Dev" (replacing legacy "Quick Flow").

* docs(fr): remove references to deleted phase-4 agent personas

Remove all references to deleted phase-4 agent personas from French
documentation, matching upcoming PR #2020 changes:

- Remove agent personas: dev/Amelia, pm/John, qa/Quinn, sm/Bob,
  quick-flow-solo-dev/Barry, bmad-master
- Replace deleted agent skill invocations with equivalent workflow skills
  (bmad-dev-story, bmad-qa-generate-e2e-tests, bmad-quick-dev, etc.)
- Depersonalize QA references ("Quinn" → "QA Intégré" / "Workflow QA")
- Simplify workflow invocation instructions (remove "invoke agent" pattern)
- Fix upgrade-to-v6.md SM/Scrum Master references

* docs(fr): fix typos

---------

Co-authored-by: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
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.

2 participants