docs(bmm): restrict bmad-project-context routing to invocation by name

[alexeyv]

What

Rewrites the bmad-project-context skill description so the skill routes only when invoked by name.

Why

The old description had two problems:

• "…so AI agents work well in it" — the pronoun had no antecedent; the repository was never named in the sentence.
• Its trigger list mixed verbatim phrases with broad intent paraphrases ("document this project", "wants to apply coding standards or governance to a repo", "wants to record a mistake agents keep making"), which let the router launch this heavyweight interview-style workflow on inferred intent rather than an explicit request.

The new description names the repository and the artifact (the AGENTS.md block), lists all four intents (setup / refresh / audit / record), and ends with "Must be invoked by name." Users who say "project context" in any phrasing still reach the skill — the name itself remains a routing surface; only outcome-descriptions that never name it stop auto-routing.

[greptile-apps]

Your trial has ended. Reactivate Greptile to resume code reviews.

[coderabbitai]

📝 Walkthrough

Walkthrough

The project context skill description now covers repository instruction audits, recording agent mistakes as pitfalls, and explicit invocation by name.

Changes

Project context skill guidance

Layer / File(s)	Summary
Update skill description src/bmm-skills/plan/bmad-project-context/SKILL.md	The description adds repository instruction auditing, agent mistake recording, and explicit name-based invocation requirements.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

• bmad-code-org/BMAD-METHOD#2599: Reorganizes the bmad-project-context skill and its invocation requirements.
• bmad-code-org/BMAD-METHOD#2674: Extends the same skill with audit and agent-mistake recording requirements.
• bmad-code-org/BMAD-METHOD#2701: Updates the same skill’s description and usage guidance.

Suggested reviewers: bmadcode

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the documentation change and the restriction to invocation by name.
Description check	✅ Passed	The description directly explains the routing change, its rationale, and the supported invocation behavior.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/project-context-skill-description

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/bmm-skills/plan/bmad-project-context/SKILL.md`:
- Line 3: Update the bmad-project-context skill metadata or module-help.csv to
register “project context” as an alias while preserving bmad-project-context as
the canonical name. Also revise stale documentation referencing automatic
workflow/project-context loading to state that project-context.md loads
passively and the skill requires explicit invocation.

🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 8416d776-47e3-4b3d-987a-ee865a53a52a

📥 Commits

Reviewing files that changed from the base of the PR and between ae7afac and 95b641c.

📒 Files selected for processing (1)

• src/bmm-skills/plan/bmad-project-context/SKILL.md

[coderabbitai]

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/usr/bin/env bash
set -euo pipefail

skill='src/bmm-skills/plan/bmad-project-context/SKILL.md'
sed -n '1,6p' "$skill"

rg -n -i \
  'bmad-project-context|project context|Must be invoked by name|inferred|automatic|setup|refresh|audit|record' \
  src docs 2>/dev/null || true

Repository: bmad-code-org/BMAD-METHOD

Length of output: 50382

---

🏁 Script executed:

#!/usr/bin/env bash
set -euo pipefail

echo "== find router/dispatch candidates =="
git ls-files | rg -n 'route|routing|dispatch|skills|skill' | head -200

echo
echo "== focused searches for router implementation =="
rg -n --glob '!node_modules' --glob '!dist' --glob '!build' \
  'router|routing|dispatch|invoke by name|Must be invoked by name|frontend|name-based|description-based|match' \
  . \
| head -300

echo
echo "== skill manifest/help relevant entry =="
sed -n '1,120p' src/bmm-skills/module-help.csv | rg -n 'bmad-project-context|project-context|Project Context'

Repository: bmad-code-org/BMAD-METHOD

Length of output: 50383

---

🏁 Script executed:

#!/usr/bin/env bash
set -euo pipefail

echo "== exact project-context SKILL frontmatter =="
sed -n '1,20p' src/bmm-skills/plan/bmad-project-context/SKILL.md

echo
echo "== related SKILL frontmatter descriptions =="
for f in \
  src/bmm-skills/plan/bmad-generate-project-context/SKILL.md \
  src/bmm-skills/v6-shims/bmad-document-project/SKILL.md \
  src/bmm-skills/plan/bmad-architecture/SKILL.md \
  src/bmm-skills/plan/bmad-sprint-planning/SKILL.md
do
  echo "--- $f"
  sed -n '1,8p' "$f"
done | sed -n '1,120p'

echo
echo "== focused docs for activation/direct invoke/automatic project context =="
rg -n -i \
  'project context|project-context|bmad-project-context|automatic|auto|directly|invoke|named|agents|must be invoked|inferred|trigger|activation' \
  docs reference how-to explanation tutorials reference core-tools commands workflow-map established-projects.md established-projects
| head -300

Repository: bmad-code-org/BMAD-METHOD

Length of output: 50382

---

Document and route bmad-project-context through project context.

The canonical skill name is bmad-project-context, but the PR note requires project context to continue routing here. Add project context to the skill metadata or module-help.csv so the alias stays discoverable. Update stale docs that say workflow/project context loads automatically; project-context.md is loaded passively, but the skill needs explicit invocation.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/bmm-skills/plan/bmad-project-context/SKILL.md` at line 3, Update the
bmad-project-context skill metadata or module-help.csv to register “project
context” as an alias while preserving bmad-project-context as the canonical
name. Also revise stale documentation referencing automatic
workflow/project-context loading to state that project-context.md loads
passively and the skill requires explicit invocation.

Source: Path instructions