Skip to content

docs(plugins): Use fully qualified agent name repository-explorer:repository-explorer#918

Merged
yamadashy merged 1 commit intomainfrom
fix/repository-explorer
Oct 24, 2025
Merged

docs(plugins): Use fully qualified agent name repository-explorer:repository-explorer#918
yamadashy merged 1 commit intomainfrom
fix/repository-explorer

Conversation

@yamadashy
Copy link
Copy Markdown
Owner

Update all documentation to use the correct fully qualified agent name format for the repository-explorer agent.

Summary

This PR standardizes the agent name references across all documentation from repository-explorer to repository-explorer:repository-explorer to align with Claude Code's agent naming convention.

When a plugin name and agent name are identical, Claude Code requires the fully qualified format plugin-name:agent-name for proper agent resolution.

Changes

  • Updated README.md
  • Updated plugin documentation (6 files in .claude/plugins/)
  • Updated website documentation (12 language versions)

Files changed: 18 files
Lines changed: 28 insertions, 28 deletions

Checklist

  • Run npm run test
  • Run npm run lint

…ository-explorer

Updated all documentation to use the correct fully qualified agent name
format (plugin-name:agent-name) for the repository-explorer agent.

Changed from:
- repository-explorer

To:
- repository-explorer:repository-explorer

This change ensures consistency with Claude Code's agent naming convention
where agents are referenced using the format plugin-name:agent-name when
the plugin name and agent name are the same.

Files updated:
- README.md
- Plugin documentation (6 files in .claude/plugins/)
- Website documentation (12 language versions)
Copilot AI review requested due to automatic review settings October 24, 2025 15:22
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR updates documentation to use the fully qualified agent name format repository-explorer:repository-explorer instead of the shortened form repository-explorer, aligning with Claude Code's naming convention requirement where identical plugin and agent names must use the plugin-name:agent-name format.

Key changes:

  • Standardized agent name references across all documentation files
  • Updated 12 website documentation files (various language translations)
  • Updated 6 plugin documentation files in .claude/plugins/

Reviewed Changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated no comments.

Show a summary per file
File Description
README.md Updated agent name reference in main documentation
website/client/src/*/guide/claude-code-plugins.md (12 files) Updated heading for repository-explorer section across all language versions
.claude/plugins/repository-explorer/agents/repository-explorer.md Updated agent references in description examples
.claude/plugins/repository-explorer/commands/explore-local.md Updated agent references in command documentation
.claude/plugins/repository-explorer/commands/explore-remote.md Updated agent references in command documentation
.claude/plugins/repomix-commands/commands/pack-local.md Updated agent selection strategy reference
.claude/plugins/repomix-commands/commands/pack-remote.md Updated agent selection strategy reference

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @yamadashy, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request aims to improve the accuracy and consistency of agent naming within the project's documentation. By updating all references to the repository-explorer agent to its fully qualified format, repository-explorer:repository-explorer, the changes ensure proper integration and resolution within the Claude Code environment. This standardization is vital for maintaining clear and unambiguous communication regarding agent usage across all documentation.

Highlights

  • Standardized Agent Naming: All documentation now consistently uses the fully qualified agent name repository-explorer:repository-explorer instead of the shorthand repository-explorer.
  • Claude Code Compliance: This change ensures adherence to Claude Code's specific naming convention, which requires the plugin-name:agent-name format when a plugin and agent share the same name, facilitating proper agent resolution.
  • Extensive Documentation Update: The update has been applied across a wide range of documentation, including the main README.md, plugin-specific markdown files, and website documentation translated into 12 different languages.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Oct 24, 2025

Walkthrough

All references to the agent identifier "repository-explorer" are updated to the fully-qualified namespaced form "repository-explorer:repository-explorer" across plugin commands, agent definitions, and website documentation in multiple languages. No logic or behavioral changes are introduced.

Changes

Cohort / File(s) Summary
Plugin Command References
\.claude/plugins/repomix-commands/commands/pack-local.md, pack-remote.md
Updated agent selection references from "repository-explorer" to "repository-explorer:repository-explorer" in agent identification sections
Repository Explorer Agent & Commands
\.claude/plugins/repository-explorer/agents/repository-explorer.md, \.claude/plugins/repository-explorer/commands/explore-local.md, explore-remote.md
Consistently replaced all references to the agent from "repository-explorer" to "repository-explorer:repository-explorer" across descriptions, examples, usage instructions, and task templates
Root Documentation
README.md
Updated plugin display name from "repository-explorer" to "repository-explorer:repository-explorer" in the plugin listing
Website Documentation (Multi-language)
website/client/src/{en,de,es,fr,hi,id,ja,ko,pt-br,vi,zh-cn,zh-tw}/guide/claude-code-plugins.md
Updated section header for the repository-explorer plugin from "repository-explorer" to "repository-explorer:repository-explorer" across all language versions

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

This is a large-scale but highly homogeneous refactoring of agent identifier references. While spanning numerous files (including multiple language variants), the changes follow a single repetitive pattern—a straightforward text substitution from "repository-explorer" to "repository-explorer:repository-explorer"—requiring verification of consistency rather than deep logic review.

Possibly related PRs

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
✅ Passed checks (2 passed)
Check name Status Explanation
Title Check ✅ Passed The PR title "docs(plugins): Use fully qualified agent name repository-explorer:repository-explorer" clearly and concisely describes the primary change across the entire changeset. The raw summary confirms that all 18 files were updated consistently to replace "repository-explorer" with "repository-explorer:repository-explorer" throughout documentation files, which directly matches the title's intent. The title is specific, avoids vague language, and accurately reflects the main objective of standardizing agent name references.
Description Check ✅ Passed The PR description exceeds the template requirements by including all essential elements: it provides a comprehensive summary section explaining the purpose and rationale for the changes, a detailed breakdown of what was modified across multiple documentation files, and the completed checklist confirming both npm run test and npm run lint were executed. The description clearly communicates why the fully qualified agent name format is required and what impact the changes have across the codebase.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fix/repository-explorer

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 271b09e and 86e1c6a.

📒 Files selected for processing (18)
  • .claude/plugins/repomix-commands/commands/pack-local.md (1 hunks)
  • .claude/plugins/repomix-commands/commands/pack-remote.md (1 hunks)
  • .claude/plugins/repository-explorer/agents/repository-explorer.md (1 hunks)
  • .claude/plugins/repository-explorer/commands/explore-local.md (5 hunks)
  • .claude/plugins/repository-explorer/commands/explore-remote.md (5 hunks)
  • README.md (1 hunks)
  • website/client/src/de/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/en/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/es/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/fr/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/hi/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/id/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/ja/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/ko/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/pt-br/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/vi/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/zh-cn/guide/claude-code-plugins.md (1 hunks)
  • website/client/src/zh-tw/guide/claude-code-plugins.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
website/client/src/ko/guide/claude-code-plugins.md

[typographical] ~25-~25: Une espace est requise.
Context: ...저장소 패키징 및 분석 ### 3. repository-explorer:repository-explorer (AI 분석 에이전트 플러그인) R...

(DEUX_POINTS_ESPACE)


[grammar] ~25-~25: Il y a peut-être une erreur ici
Context: ...er:repository-explorer (AI 분석 에이전트 플러그인) Repomix CLI를 사용하여 코드베이스를 지능적으로 탐색하는 AI 기...

(QB_NEW_FR)

website/client/src/fr/guide/claude-code-plugins.md

[typographical] ~25-~25: Une espace est requise.
Context: ...Hub distants ### 3. repository-explorer:repository-explorer (Plugin Agent d'Anal...

(DEUX_POINTS_ESPACE)


[grammar] ~25-~25: «  analyse  » semble plus probable dans ce contexte
Context: ...lorer:repository-explorer (Plugin Agent d'Analyse IA) Agent d'analyse de dépôt alimenté par...

(QB_NEW_FR_OTHER_ERROR_IDS_REPLACEMENT_ORTHOGRAPHY_UPPERCASE)


[grammar] ~25-~25: Il y a peut-être une erreur ici
Context: ...ory-explorer (Plugin Agent d'Analyse IA) Agent d'analyse de dépôt alimenté par l'...

(QB_NEW_FR)

.claude/plugins/repository-explorer/commands/explore-local.md

[style] ~7-~7: Consider using an alternative to strengthen your wording.
Context: ... When the user runs this command, they want to explore and understand a local proje...

(WANT_KEEN)

website/client/src/de/guide/claude-code-plugins.md

[grammar] ~25-~25: Hier könnte ein Fehler sein.
Context: ...itory-explorer (KI-Analyse-Agent-Plugin) KI-gesteuerter Repository-Analyse-Agent,...

(QB_NEW_DE)

.claude/plugins/repository-explorer/commands/explore-remote.md

[style] ~7-~7: Consider using an alternative to strengthen your wording.
Context: ... When the user runs this command, they want to explore and understand a remote repo...

(WANT_KEEN)

website/client/src/es/guide/claude-code-plugins.md

[style] ~25-~25: Considere alternativas para este anglicismo (recomendable sobre todo en contextos más formales).
Context: ...epository-explorer:repository-explorer (Plugin de Agente de Análisis de IA) Agente de...

(ES_SIMPLE_REPLACE_ANGLICISM_PREMIUM_PLUGIN)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (5)
  • GitHub Check: Build and run (windows-latest, 22.x)
  • GitHub Check: Build and run (windows-latest, 24.x)
  • GitHub Check: Test (windows-latest, 22.x)
  • GitHub Check: Test (windows-latest, 20.x)
  • GitHub Check: claude-review
🔇 Additional comments (18)
website/client/src/ja/guide/claude-code-plugins.md (1)

25-25: Fully-qualified agent identifier consistently applied.

The heading update from repository-explorer to repository-explorer:repository-explorer aligns with the Claude Code naming requirement and matches updates across other language versions. All command examples (lines 36-37) already use the fully-qualified form, so the documentation is now internally consistent.

.claude/plugins/repomix-commands/commands/pack-remote.md (1)

82-83: Fully-qualified agent identifier in delegation strategy.

The Agent Selection Strategy correctly references repository-explorer:repository-explorer for users to select the appropriate sub-agent. This improves clarity and ensures proper agent resolution when directing analysis tasks to the repomix output handler.

website/client/src/en/guide/claude-code-plugins.md (1)

25-25: Canonical reference document updated correctly.

The English guide heading update establishes the fully-qualified identifier convention that localizations depend on. Command examples throughout (lines 36-37, 115, 118, 129, 132) already reference the namespaced form, ensuring documentation consistency.

website/client/src/zh-tw/guide/claude-code-plugins.md (1)

25-25: Localized heading updated consistently.

The Traditional Chinese guide reflects the same fully-qualified agent identifier change, maintaining consistency with other language versions while preserving proper translation of "AI Analysis Agent Plugin" description.

README.md (1)

1032-1032: Main documentation display name updated appropriately.

The README heading update prominently displays the fully-qualified agent identifier where users first encounter the plugin documentation. Note that the installation command (line 1078) correctly uses repository-explorer@repomix (plugin package name), not the agent identifier, which maintains proper semantic separation.

website/client/src/vi/guide/claude-code-plugins.md (1)

25-25: Localized Vietnamese guide updated consistently.

The Vietnamese version applies the same fully-qualified identifier convention, ensuring consistent user experience across language variants.

website/client/src/zh-cn/guide/claude-code-plugins.md (1)

25-25: Simplified Chinese guide updated consistently.

The Simplified Chinese version correctly applies the fully-qualified identifier convention, aligning with all other localized documentation.

website/client/src/hi/guide/claude-code-plugins.md (1)

25-25: Hindi guide updated—all localizations now consistent.

The Hindi version completes the fully-qualified identifier update across all localized documentation, ensuring users worldwide encounter the correct agent naming convention regardless of language preference.

website/client/src/es/guide/claude-code-plugins.md (1)

25-25: LGTM! Consistent agent identifier update across locales.

The heading update properly reflects the fully-qualified namespace format required by Claude Code for identical plugin and agent names.

website/client/src/fr/guide/claude-code-plugins.md (1)

25-25: LGTM! Consistent with other locales.

Heading update aligns with the namespace format standardization across all language versions.

.claude/plugins/repomix-commands/commands/pack-local.md (1)

74-77: LGTM! Agent selection strategy properly updated.

The namespace-qualified identifier ensures correct agent resolution per Claude Code's requirements. The conditional fallback logic remains sound.

website/client/src/pt-br/guide/claude-code-plugins.md (1)

25-25: LGTM! Consistent with other localized documentation.

Heading properly updated to the fully-qualified namespace format.

website/client/src/id/guide/claude-code-plugins.md (1)

25-25: LGTM! Consistent locale update.

Heading properly reflects the fully-qualified namespace format standardized across all locales.

website/client/src/de/guide/claude-code-plugins.md (1)

25-25: LGTM! Consistent with all other localized guides.

The fully-qualified namespace identifier is now standardized across all language versions.

.claude/plugins/repository-explorer/agents/repository-explorer.md (1)

3-3: LGTM! Agent definition properly updated with namespace-qualified self-references.

The agent description now consistently references repository-explorer:repository-explorer in examples and instructions, enabling correct Claude Code plugin resolution and providing users with accurate agent identifiers for documentation.

website/client/src/ko/guide/claude-code-plugins.md (1)

25-25: LGTM! Final locale guide properly updated.

Heading update is consistent across all 6 localized guides, ensuring uniform documentation of the namespace-qualified agent identifier.

.claude/plugins/repository-explorer/commands/explore-local.md (1)

5-5: Agent name qualification consistently applied throughout.

All six occurrences of the agent identifier have been updated to the fully-qualified format across the description, note, responsibilities, instructions, command flow, and remember sections. The changes maintain documentation clarity and consistency.

Also applies to: 9-9, 22-22, 36-36, 62-62, 72-72

.claude/plugins/repository-explorer/commands/explore-remote.md (1)

5-5: Agent qualification verified in searched directories — all references properly use qualified format.

All agent references found in .claude/plugins/repository-explorer/commands/ and .claude/plugins/repomix-commands/commands/ use the fully-qualified "repository-explorer:repository-explorer" format. No unqualified references were detected in these locations.

However, verification was limited to 4 files found in the specified directories. The original review requested verification across 18 files mentioned in the PR summary. To ensure comprehensive verification:

  • Confirm the scope of all 18 files and their locations
  • Verify that the other ~14 files also apply this qualification consistently

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 and usage tips.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying repomix with  Cloudflare Pages  Cloudflare Pages

Latest commit: 86e1c6a
Status: ✅  Deploy successful!
Preview URL: https://73894f9c.repomix.pages.dev
Branch Preview URL: https://fix-repository-explorer.repomix.pages.dev

View logs

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request updates documentation to use the fully qualified agent name format (plugin-name:agent-name) for the repository-explorer agent, aligning with Claude Code's agent naming convention. The changes involve updating README.md, plugin documentation, and website documentation across multiple languages. No specific style guide was provided, so the review focuses on correctness and clarity.

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Warning

Gemini encountered an error creating the review. You can try again by commenting /gemini review.

@codecov
Copy link
Copy Markdown

codecov bot commented Oct 24, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.55%. Comparing base (271b09e) to head (86e1c6a).
⚠️ Report is 2 commits behind head on main.

❌ Your project status has failed because the head coverage (73.55%) is below the target coverage (75.00%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #918      +/-   ##
==========================================
- Coverage   74.60%   73.55%   -1.06%     
==========================================
  Files         111      111              
  Lines        7782     7782              
  Branches     1450     1472      +22     
==========================================
- Hits         5806     5724      -82     
- Misses       1976     2058      +82     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@claude
Copy link
Copy Markdown
Contributor

claude bot commented Oct 24, 2025

PR Review: Documentation Update for Agent Name Format

Summary

This PR successfully standardizes the agent name references across all documentation from repository-explorer to repository-explorer:repository-explorer to align with Claude Code's agent naming convention. The changes are consistent and comprehensive.

✅ Strengths

  1. Comprehensive Coverage: All 18 files across the codebase have been updated consistently
  2. Clear Rationale: The PR description clearly explains why this change is necessary
  3. No Code Changes: This is a documentation-only change, reducing risk
  4. Checklist Completed: Tests and linting have been run
  5. Conventional Commits: Follows the project's commit message format with proper scope

🔍 Code Quality Assessment

Details

Consistency ✅

All occurrences updated correctly across 18 files (2 plugin commands, 2 plugin agents, README, 12 language website docs). Grep search confirms no remaining old format instances.

Commit Message ⚠️ Minor Issue

The commit headline appears truncated but the body provides full context. Low impact.

Documentation Quality ✅

Changes are accurate with no formatting issues. Multilingual consistency maintained.

🎯 Premortem Analysis

Potential Failure Scenarios & Mitigations

1. Backward Compatibility

  • Risk: Older Claude Code versions might not support the new format
  • Likelihood: Low | Impact: Medium
  • Mitigation: Consider adding migration notes if users report issues

2. Incomplete Migration

  • Risk: External docs may still use old format
  • Likelihood: Medium | Impact: Low
  • Mitigation: ✅ Codebase search shows complete coverage

3. User Confusion

  • Risk: Users with bookmarked old docs
  • Likelihood: Low | Impact: Low
  • Mitigation: PR description provides clear context

4. Agent Resolution Issues

  • Risk: Fully qualified name might not work everywhere
  • Likelihood: Very Low | Impact: High
  • Mitigation: ✅ Tests pass, aligns with official convention

🛡️ Security & Performance

  • Security: ✅ No concerns - documentation only
  • Performance: ✅ No impact - no code changes
  • Test Coverage: ✅ Tests pass

📝 Suggestions

Optional Improvements

  1. Consider if the truncated commit headline is acceptable
  2. Add migration notice if users report confusion
  3. Consider verification script for future similar changes

✅ Recommendation

APPROVE - This PR is ready to merge.

The changes are correct, comprehensive, and low-risk. Documentation now accurately reflects Claude Code's agent naming convention.


Review conducted following CLAUDE.md guidelines

@yamadashy yamadashy merged commit 1d139e8 into main Oct 24, 2025
57 of 58 checks passed
@yamadashy yamadashy deleted the fix/repository-explorer branch October 24, 2025 17:13
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