Skip to content

chore: move document project to v6 shims - #2700

Merged
alexeyv merged 1 commit into
mainfrom
chore/document-project-v6-shim
Aug 9, 2026
Merged

chore: move document project to v6 shims#2700
alexeyv merged 1 commit into
mainfrom
chore/document-project-v6-shim

Conversation

@alexeyv

@alexeyv alexeyv commented Aug 9, 2026

Copy link
Copy Markdown
Collaborator

What

Moves the deprecated bmad-document-project skill from plan/ to v6-shims/ and updates its marketplace registration.

Why

The skill now exists only as a compatibility forwarder to bmad-project-context, so classifying it as a v6 shim reflects its current role and keeps it out of the active planning skill set.

How

  • Rename the skill directory without changing its forwarding behavior.
  • Point .claude-plugin/marketplace.json at the new location.

Testing

HUSKY=0 npm ci && npm run quality

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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

@coderabbitai

coderabbitai Bot commented Aug 9, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: eb4149d6-f0d1-4582-bde1-42e3c8fa4668

📥 Commits

Reviewing files that changed from the base of the PR and between 47bab7d and 7772b7f.

📒 Files selected for processing (2)
  • .claude-plugin/marketplace.json
  • src/bmm-skills/v6-shims/bmad-document-project/SKILL.md

📝 Walkthrough

Walkthrough

The marketplace now resolves bmad-document-project from v6-shims. The added deprecated skill explains its scope and forwards requests to bmad-project-context with setup intent.

Changes

Document project skill migration

Layer / File(s) Summary
Register and forward the deprecated skill
.claude-plugin/marketplace.json, src/bmm-skills/v6-shims/bmad-document-project/SKILL.md
The marketplace uses the v6 shim path. The skill marks bmad-document-project as deprecated and forwards requests to bmad-project-context.

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

Possibly related PRs

Suggested reviewers: bmadcode

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the move of the deprecated skill to the v6 shims directory.
Description check ✅ Passed The description accurately explains the directory move, marketplace update, rationale, behavior, and validation command.
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 chore/document-project-v6-shim

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

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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/v6-shims/bmad-document-project/SKILL.md`:
- Around line 10-14: Update the translated established-project guidance in the
referenced Chinese, Vietnamese, and French pages to remove recommendations for
the deprecated bmad-document-project workflow and direct complex-project users
to invoke bmad-project-context with setup intent instead, preserving the
original request and supplied paths/documents forwarding behavior described by
the bmad-document-project skill.
🪄 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: eb4149d6-f0d1-4582-bde1-42e3c8fa4668

📥 Commits

Reviewing files that changed from the base of the PR and between 47bab7d and 7772b7f.

📒 Files selected for processing (2)
  • .claude-plugin/marketplace.json
  • src/bmm-skills/v6-shims/bmad-document-project/SKILL.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Caution

Inline review comments failed to post. This is likely due to GitHub's internal server error or limits when posting large numbers of comments. If you are seeing this consistently it is likely a permissions issue. Please check "Moderation" -> "Code review limits" under your organization settings.

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/v6-shims/bmad-document-project/SKILL.md`:
- Around line 10-14: Update the translated established-project guidance in the
referenced Chinese, Vietnamese, and French pages to remove recommendations for
the deprecated bmad-document-project workflow and direct complex-project users
to invoke bmad-project-context with setup intent instead, preserving the
original request and supplied paths/documents forwarding behavior described by
the bmad-document-project skill.
🪄 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: eb4149d6-f0d1-4582-bde1-42e3c8fa4668

📥 Commits

Reviewing files that changed from the base of the PR and between 47bab7d and 7772b7f.

📒 Files selected for processing (2)
  • .claude-plugin/marketplace.json
  • src/bmm-skills/v6-shims/bmad-document-project/SKILL.md
🛑 Comments failed to post (1)
src/bmm-skills/v6-shims/bmad-document-project/SKILL.md (1)

10-14: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

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

if [ -d docs ]; then
  rg -n -i \
    'bmad-document-project|bmad-project-context|generate project docs|project documentation|src/bmm-skills/plan/bmad-document-project' \
    docs || true
else
  echo "docs/ does not exist; confirm that no documentation update is required."
fi

Repository: bmad-code-org/BMAD-METHOD

Length of output: 7647


🏁 Script executed:

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

echo "== Target skill =="
sed -n '1,80p' src/bmm-skills/v6-shims/bmad-document-project/SKILL.md

echo
echo "== Relevant docs: reference/agents =="
sed -n '1,55p' docs/reference/agents.md

echo
echo "== Relevant docs: how-to/established-projects =="
sed -n '30,65p' docs/how-to/established-projects.md

echo
echo "== Relevant docs: zh-cn how-to/established-projects =="
sed -n '55,63p' docs/zh-cn/how-to/established-projects.md

echo
echo "== Relevant docs: vi-vn how-to/established-projects =="
sed -n '50,62p' docs/vi-vn/how-to/established-projects.md

echo
echo "== Relevant docs: fr how-to/established-projects =="
sed -n '50,62p' docs/fr/how-to/established-projects.md

Repository: bmad-code-org/BMAD-METHOD

Length of output: 7043


Update translated project-context pages that still recommend bmad-document-project.

docs/zh-cn/how-to/established-projects.md, docs/vi-vn/how-to/established-projects.md, and docs/fr/how-to/established-projects.md still say complex projects can use the deprecated workflow. Point users to bmad-project-context with setup intent instead.

🤖 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/v6-shims/bmad-document-project/SKILL.md` around lines 10 - 14,
Update the translated established-project guidance in the referenced Chinese,
Vietnamese, and French pages to remove recommendations for the deprecated
bmad-document-project workflow and direct complex-project users to invoke
bmad-project-context with setup intent instead, preserving the original request
and supplied paths/documents forwarding behavior described by the
bmad-document-project skill.

Source: Path instructions

@alexeyv
alexeyv merged commit ae7afac into main Aug 9, 2026
7 checks passed
@alexeyv
alexeyv deleted the chore/document-project-v6-shim branch August 9, 2026 16:54
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