Skip to content

Conversation

@TechNickAI
Copy link
Owner

Summary

  • Merge standalone agents plugin into core ai-coding-config plugin
  • Move agents from plugins/agents/agents/ to plugins/core/agents/
  • Bump marketplace and core plugin version to 4.0.0
  • Update all documentation and symlinks

Why

The previous structure created redundant naming when accessing agents: agents:mobile-ux-reviewer had an awkward agent-agents: display pattern in Claude Code's @ mentions.

Following the pattern used by superpowers and other Claude Code marketplaces, this consolidates everything into a single ai-coding-config plugin containing commands, agents, and context.

New access pattern: ai-coding-config:mobile-ux-reviewer

Breaking Changes

Users who installed the agents plugin separately need to reinstall from ai-coding-config:

/plugin install ai-coding-config

Test plan

  • Verify agents are accessible via @ai-coding-config:mobile-ux-reviewer pattern
  • Confirm symlinks work correctly: .claude/agents β†’ plugins/core/agents
  • Test /ai-coding-config command for new installations

πŸ€– Generated with Claude Code

Merge the standalone agents plugin into the core ai-coding-config plugin,
moving all agents from plugins/agents/agents/ to plugins/core/agents/.
This eliminates the redundant plugin naming pattern (agents:mobile-ux-reviewer
becomes ai-coding-config:mobile-ux-reviewer) and follows the established
pattern used by Claude Code marketplace superpowers and similar plugins.

This single-plugin architecture simplifies the marketplace structure while
keeping commands, agents, and context in one cohesive package. Users who
installed the agents plugin separately will need to reinstall from the main
ai-coding-config plugin. Version bumped to 4.0.0 to reflect the breaking
change.

πŸ€– Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@claude
Copy link

claude bot commented Dec 19, 2025

Code Review - PR #14: Consolidate agents into core plugin

Overview

This PR successfully consolidates the standalone agents plugin into the core ai-coding-config plugin, improving the user experience by simplifying the plugin structure and fixing the awkward naming pattern.

βœ… Strengths

1. Clean Architectural Improvement

  • The consolidation from agents:mobile-ux-reviewer to ai-coding-config:mobile-ux-reviewer is a significant UX improvement
  • Follows established patterns from other Claude Code marketplaces (superpowers, etc.)
  • Reduces plugin proliferation and simplifies installation

2. Thorough Documentation Updates

  • All references updated consistently across:
    • README.md: Installation instructions updated from /plugin install ai-coding-config agents to just /plugin install ai-coding-config
    • AGENTS.md: Symlink documentation corrected
    • ai-coding-config.md command: Installation mapping updated
  • Version bumps are semantic and appropriate (3.x β†’ 4.0.0 for breaking change)

3. Proper File Operations

  • Agent files moved (not copied) from plugins/agents/agents/ to plugins/core/agents/
  • Symlink updated correctly: .claude/agents now points to ../plugins/core/agents
  • Old plugin.json for standalone agents removed appropriately

4. Breaking Change Communication

  • PR body clearly documents the breaking change
  • Provides migration instructions for users who installed agents separately
  • Test plan includes verification steps

πŸ” Observations & Suggestions

1. Migration Path for Existing Users
The PR mentions users need to reinstall, but there's a potential issue:

  • Users who have agents plugin installed will have a stale/broken plugin reference
  • Consider: Does the /plugin install ai-coding-config command automatically clean up the old agents plugin entry?
  • Suggestion: Document or add a migration step to explicitly uninstall the old agents plugin first:
    /plugin uninstall agents
    /plugin install ai-coding-config

2. Symlink Compatibility Check
The ai-coding-config.md command at line 424-426 still references checking for old symlinks:

- .claude/agents/ β†’ ~/.ai_coding_config/plugins/agents/agents/

This is updated correctly in the PR to:

- .claude/agents/ β†’ ~/.ai_coding_config/plugins/core/agents/

βœ… Verified correct

3. Bootstrap Script Compatibility
Question: Does the bootstrap script (scripts/bootstrap.sh) need updating to reflect this structure change? If it references the old agents plugin location, users bootstrapping from main after this merge might encounter issues.

4. Version Consistency

  • Marketplace version: 4.0.0 βœ…
  • Core plugin version: 4.0.0 βœ…
  • Both properly incremented for breaking change

πŸ”’ Security & Quality

  • No security concerns: Pure file reorganization
  • No code changes: Agent files are moved unchanged (0 additions/deletions for agent .md files)
  • Test coverage: Manual test plan provided, appropriate for structural change
  • Breaking change handling: Well documented

πŸ“Š Impact Assessment

Positive:

  • Cleaner mental model for users (one core plugin vs. two related plugins)
  • Better @ mention experience in Claude Code
  • Follows marketplace best practices

Neutral:

  • Existing users need to reinstall (documented)
  • Version bump to 4.0.0 signals breaking change appropriately

Risks:

  • Users who don't read release notes might be confused why agents are suddenly missing
  • Consider: Could the marketplace update mechanism auto-migrate this?

βœ… Recommendation: APPROVE with minor suggestions

This is a well-executed structural improvement. The code quality is excellent, documentation is thorough, and the breaking change is appropriately communicated.

Before merge, please verify:

  1. Bootstrap script compatibility with new structure
  2. Plugin uninstall/reinstall migration path works smoothly
  3. Consider adding a migration note to the README or a CHANGELOG entry

After merge:

  • Consider a release announcement explaining the change to existing users
  • Update any external documentation or blog posts referencing the old two-plugin structure

Great work on improving the plugin architecture! πŸŽ‰

Copy link

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

@TechNickAI TechNickAI merged commit d3c79c9 into main Dec 19, 2025
4 checks passed
TechNickAI pushed a commit that referenced this pull request Dec 19, 2025
Merge standalone skills plugin into core ai-coding-config plugin following
the same pattern as PR #14 for agents.

- Move skills from plugins/skills/skills/ to plugins/core/skills/
- Bump marketplace and core plugin version to 5.0.0
- Update all documentation and symlinks
- Remove plugins/skills/ directory

Previous structure had awkward naming: skills:brainstorming
New access pattern: ai-coding-config:brainstorming

This completes the consolidation work, creating one unified plugin
containing commands, agents, skills, and context.

πŸ€– Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
TechNickAI added a commit that referenced this pull request Dec 19, 2025
* πŸ—οΈ Consolidate skills into ai-coding-config plugin

Merge standalone skills plugin into core ai-coding-config plugin following
the same pattern as PR #14 for agents.

- Move skills from plugins/skills/skills/ to plugins/core/skills/
- Bump marketplace and core plugin version to 5.0.0
- Update all documentation and symlinks
- Remove plugins/skills/ directory

Previous structure had awkward naming: skills:brainstorming
New access pattern: ai-coding-config:brainstorming

This completes the consolidation work, creating one unified plugin
containing commands, agents, skills, and context.

πŸ€– Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

* πŸ› Fix duplicate detection paths for consolidated plugin structure

Update example paths in ai-coding-config.md to reflect that agents and
skills now live in `ai-coding-config/core/*/` instead of separate plugin
directories.

Cursor Bugbot correctly identified this would cause duplicate detection
to fail for skills since the path pointed to non-existent location.

πŸ€– Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

* πŸ› Add deleted plugin paths to symlink compatibility check

Include deleted skills and agents plugin paths in the list of paths
that should trigger symlink updates. Without this, users with direct
symlinks to old locations won't be offered the fix.

πŸ€– Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

---------

Co-authored-by: Nick Sullivan <[email protected]>
Co-authored-by: Claude Sonnet 4.5 <[email protected]>
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