Skip to content

Comments

fix: comprehensive pm-dev-java plugin-doctor cleanup#7

Merged
cuioss-oliver merged 3 commits intomainfrom
fix/pm-dev-java-plugin-doctor-cleanup
Feb 23, 2026
Merged

fix: comprehensive pm-dev-java plugin-doctor cleanup#7
cuioss-oliver merged 3 commits intomainfrom
fix/pm-dev-java-plugin-doctor-cleanup

Conversation

@cuioss-oliver
Copy link
Collaborator

Summary

  • Skill renames: java-createjava-core, java-optimize-quarkus-nativejava-quarkus (fixes identity/title mismatches)
  • Agent standardization: Added CONTINUOUS IMPROVEMENT RULE to all 9 agents, standardized to modern manage-lessons pattern, removed unused Write/Edit tools from read-only agents
  • Cross-reference fixes: Replaced 31 references to non-existent pm-dev-builder:builder-maven-rules with pm-dev-java:plan-marshall-plugin, fixed broken java-cdi-quarkusjava-quarkus refs
  • Enforcement blocks: Renamed CRITICAL RULESEnforcement in java-enforce-logrecords, removed banned ALL-CAPS keywords outside enforcement blocks
  • Miscellaneous: Added pom-maintenance.md reference, replaced vague workflow delegation with explicit script call in refactor agent, documented profiles.py script, fixed component type metadata

Test plan

  • ./pw verify pm-dev-java — 100 tests pass
  • ./pw module-tests plan-marshall — 744 tests pass
  • CI pipeline passes

🤖 Generated with Claude Code

- Rename java-create to java-core (fixes identity mismatch)
- Rename java-optimize-quarkus-native to java-quarkus (fixes title/name mismatch)
- Add missing CONTINUOUS IMPROVEMENT RULE to all 9 agents
- Standardize CI RULE to modern manage-lessons pattern
- Remove unused Write/Edit tools from read-only agents
- Replace non-existent pm-dev-builder:builder-maven-rules with pm-dev-java:plan-marshall-plugin (31 replacements across 11 files)
- Fix broken cross-references (java-cdi-quarkus → java-quarkus, java-core paths)
- Rename CRITICAL RULES to Enforcement block in java-enforce-logrecords
- Remove banned ALL-CAPS keywords outside enforcement blocks
- Add unreferenced pom-maintenance.md to plan-marshall-plugin references
- Replace vague workflow delegation with explicit script call in java-refactor-agent
- Document unreferenced profiles.py script in manage-maven-profiles
- Fix component type metadata (command → skill) in CI RULE sections
- Update all tests and cross-bundle references

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@gemini-code-assist
Copy link

Summary of Changes

Hello @cuioss-oliver, 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 performs a comprehensive cleanup and standardization of the pm-dev-java plugin. The changes streamline skill naming conventions, enhance agent behavior by introducing a consistent mechanism for reporting improvements, and update numerous internal references to ensure consistency and maintainability. These efforts aim to improve the clarity, robustness, and future extensibility of the Java development tools within the system.

Highlights

  • Skill Renames: Renamed java-create skill to java-core and java-optimize-quarkus-native skill to java-quarkus across file names, plugin configurations, documentation, and references.
  • Agent Standardization: Implemented a 'CONTINUOUS IMPROVEMENT RULE' in all 9 agents, standardizing how they report improvement opportunities to their callers via the manage-lessons skill. Additionally, removed Write and Edit tools from read-only agents.
  • Cross-Reference Updates: Replaced all 31 references to the deprecated pm-dev-builder:builder-maven-rules skill with pm-dev-java:plan-marshall-plugin. Also corrected a broken reference from java-cdi-quarkus to java-quarkus.
  • Enforcement Block Refinements: Renamed 'CRITICAL RULES' to 'Enforcement' in java-enforce-logrecords and updated 'ALWAYS' directives to 'MUST'. Removed 'CRITICAL' keywords from several other skill documents to standardize language.
  • Workflow Delegation and Documentation: Updated the java-refactor-agent to use an explicit script call for build verification. Documented the profiles.py script in manage-maven-profiles/SKILL.md and added a pom-maintenance.md reference to plan-marshall-plugin.
  • Component Type Metadata Correction: Corrected component type metadata from command to skill in java-analyze-all, java-full-workflow, and java-maintain-logger skills.
Changelog
  • marketplace/bundles/plan-marshall/skills/tools-permission-sync/SKILL.md
    • Updated command shortform reference from java-create to java-core.
  • marketplace/bundles/plan-marshall/skills/tools-script-executor/SKILL.md
    • Updated example reference from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-dev-java/.claude-plugin/plugin.json
    • Updated skill paths for java-create to java-core and java-optimize-quarkus-native to java-quarkus.
  • marketplace/bundles/pm-dev-java/README.md
    • Updated command and skill references from java-create to java-core.
    • Updated command and skill references from java-optimize-quarkus-native to java-quarkus.
    • Updated skill reference from java-cdi-quarkus to java-quarkus.
  • marketplace/bundles/pm-dev-java/agents/java-coverage-agent.md
    • Removed Write and Edit from the list of allowed tools.
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-fix-build-agent.md
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-fix-javadoc-agent.md
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-fix-tests-agent.md
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-implement-agent.md
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-implement-tests-agent.md
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-quality-agent.md
    • Removed Write and Edit from the list of allowed tools.
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-refactor-agent.md
    • Replaced vague build verification workflow with an explicit script call.
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/agents/java-verify-agent.md
    • Removed Write and Edit from the list of allowed tools.
    • Added a 'CONTINUOUS IMPROVEMENT RULE' section.
  • marketplace/bundles/pm-dev-java/skills/java-analyze-all/SKILL.md
    • Corrected component type metadata from command to skill.
  • marketplace/bundles/pm-dev-java/skills/java-cdi/SKILL.md
    • Updated related skill reference from java-cdi-quarkus to java-quarkus.
  • marketplace/bundles/pm-dev-java/skills/java-create/SKILL.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-core/SKILL.md.
    • Updated skill name and description.
    • Removed 'CRITICAL' keyword from a standard loading instruction.
  • marketplace/bundles/pm-dev-java/skills/java-create/standards/build-precondition-pattern.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-core/standards/build-precondition-pattern.md.
    • Updated skill reference from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-dev-java/skills/java-create/standards/implementation-verification.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-core/standards/implementation-verification.md.
  • marketplace/bundles/pm-dev-java/skills/java-create/standards/java-core-patterns.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-core/standards/java-core-patterns.md.
  • marketplace/bundles/pm-dev-java/skills/java-create/standards/java-modern-features.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-core/standards/java-modern-features.md.
  • marketplace/bundles/pm-dev-java/skills/java-create/standards/java-performance-patterns.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-core/standards/java-performance-patterns.md.
  • marketplace/bundles/pm-dev-java/skills/java-enforce-logrecords/SKILL.md
    • Updated references to 'CRITICAL RULES' to 'Enforcement'.
    • Changed 'ALWAYS verify' to 'MUST verify' in module handling rules.
    • Updated skill references from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-dev-java/skills/java-full-workflow/SKILL.md
    • Updated skill reference from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
    • Corrected component type metadata from command to skill.
  • marketplace/bundles/pm-dev-java/skills/java-maintain-logger/SKILL.md
    • Corrected component type metadata from command to skill.
    • Updated multiple skill references from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-dev-java/skills/java-maintenance/SKILL.md
    • Changed 'CRITICAL' to 'Important' in standard loading instruction.
    • Replaced direct Maven commands with plan-marshall-plugin skill calls for compliance verification.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/SKILL.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/SKILL.md.
    • Updated skill name and description.
    • Removed 'CRITICAL' keyword from a standard loading instruction.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/standards/container.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/standards/container.md.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/standards/integration-testing.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/standards/integration-testing.md.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/standards/quarkus-native.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/standards/quarkus-native.md.
    • Updated multiple skill references from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/standards/quarkus-reflection.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/standards/quarkus-reflection.md.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/standards/quarkus-testing.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/standards/quarkus-testing.md.
  • marketplace/bundles/pm-dev-java/skills/java-optimize-quarkus-native/standards/security.md
    • Renamed to marketplace/bundles/pm-dev-java/skills/java-quarkus/standards/security.md.
  • marketplace/bundles/pm-dev-java/skills/javadoc/SKILL.md
    • Removed 'CRITICAL' keyword from a standard loading instruction.
  • marketplace/bundles/pm-dev-java/skills/junit-core/SKILL.md
    • Changed 'CRITICAL' to 'Important' in standard loading instruction.
  • marketplace/bundles/pm-dev-java/skills/junit-integration/SKILL.md
    • Updated related skill reference from java-cdi-quarkus to java-cdi.
    • Updated related skill reference from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-dev-java/skills/manage-maven-profiles/SKILL.md
    • Added an 'Enforcement' section with execution mode, prohibited actions, and constraints.
    • Added an 'External Resources' section documenting the profiles.py script and its subcommands.
  • marketplace/bundles/pm-dev-java/skills/plan-marshall-plugin/SKILL.md
    • Added a reference to standards/pom-maintenance.md.
  • marketplace/bundles/pm-dev-java/skills/plan-marshall-plugin/extension.py
    • Updated the skill name and description for java-create to java-core.
  • marketplace/bundles/pm-plugin-development/skills/plugin-architecture/references/minimal-wrapper-pattern.md
    • Updated multiple skill references from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-plugin-development/skills/plugin-doctor/references/fix-catalog.md
    • Updated skill reference from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • marketplace/bundles/pm-plugin-development/skills/verification-mode/standards/planning-compliance.md
    • Updated example skill reference from pm-dev-builder:builder-maven-rules to pm-dev-java:plan-marshall-plugin.
  • test/plan-marshall/manage-plan-marshall-config/test_cmd_skill_domains.py
    • Updated test assertions to reflect the java-create to java-core skill rename.
  • test/plan-marshall/manage-plan-marshall-config/test_helpers.py
    • Updated default configuration for java-create to java-core.
  • test/plan-marshall/manage-plan-marshall-config/test_plan_marshall_config.py
    • Updated test assertions to reflect the java-create to java-core skill rename.
  • test/plan-marshall/permission-fix/test_permission.py
    • Updated test configuration for java-create to java-core.
Activity
  • The pull request was generated with Claude Code, indicating an automated or AI-assisted creation process.
  • All 100 tests for ./pw verify pm-dev-java passed.
  • All 744 tests for ./pw module-tests plan-marshall passed.
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.

Copy link

@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 provides a comprehensive cleanup and standardization of the pm-dev-java bundle. Renaming skills to more descriptive names (e.g., java-create to java-core) and standardizing the CONTINUOUS IMPROVEMENT RULE across agents improves consistency. The migration from the external pm-dev-builder dependency to the internal plan-marshall-plugin is a significant architectural improvement. However, there are several critical issues where the new skill is invoked using non-existent workflows (Execute Maven Build), which will cause runtime failures for the agents. Additionally, some sections violate Rule 9 by using descriptive text instead of actionable bash blocks for script operations. There are also some remaining all-caps keywords that should be addressed to align with the PR's stated goals.

cuioss-oliver and others added 2 commits February 23, 2026 19:28
…cit script calls

- Replace all `Skill:/Workflow: Execute Maven Build` blocks with explicit
  `python3 .plan/execute-script.py pm-dev-java:plan-marshall-plugin:maven run`
  calls in java-full-workflow, java-enforce-logrecords, java-maintain-logger
- Convert descriptive Skill references to bash blocks in java-maintenance (Rule 9)
- Fix `**CRITICAL:**` to `**Critical:**` in CI RULE sections of
  java-quality-agent, java-refactor-agent, java-verify-agent
- Replace non-existent workflow refs in minimal-wrapper-pattern.md with
  explicit script notation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cuioss-oliver cuioss-oliver merged commit 904c6af into main Feb 23, 2026
4 checks passed
@cuioss-oliver cuioss-oliver deleted the fix/pm-dev-java-plugin-doctor-cleanup branch February 23, 2026 19:34
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