Skip to content

Plugin structure update - #2

Merged
Gnnng merged 6 commits into
mainfrom
plugin-structure-update
Nov 17, 2025
Merged

Plugin structure update#2
Gnnng merged 6 commits into
mainfrom
plugin-structure-update

Conversation

@Gnnng

@Gnnng Gnnng commented Nov 17, 2025

Copy link
Copy Markdown
Contributor

No description provided.

This adds the codex plugin to the marketplace, providing integration with the OpenAI Codex CLI for complex code generation, modification, and debugging tasks.

Plugin includes:
- /codex command for executing Codex CLI tasks
- codex-runner agent for orchestrating iterative Codex executions
- Session management for resuming previous Codex sessions

The plugin is marked as experimental (v0.0.1-alpha) and not ready for production use. Clear warnings are included in the description, version tag, and documentation.
- Move plugin.json from root to .claude-plugin/plugin.json
- Move commands from .claude/commands/ to commands/ at root level
- Remove old .claude/ directory structure
- Bump version from 1.0.0 to 1.0.1

This aligns with the official Claude Code plugin specification where:
- plugin.json must be in .claude-plugin/ directory
- All component directories (commands/, agents/, etc.) must be at plugin root
- Components should NOT be nested in .claude/ or .claude-plugin/
- Move plugin.json from root to .claude-plugin/plugin.json
- Move commands from .claude/commands/ to commands/ at root level
- Remove old .claude/ directory structure
- Bump version from 0.0.1-alpha to 0.0.2-alpha

This aligns with the official Claude Code plugin specification where:
- plugin.json must be in .claude-plugin/ directory
- All component directories (commands/, agents/, etc.) must be at plugin root
- Components should NOT be nested in .claude/ or .claude-plugin/
- Add detailed plugin directory structure documentation to CLAUDE.md
- Specify that plugin.json must be in .claude-plugin/ directory
- Clarify that component directories must be at plugin root level
- Add visual examples and important rules for plugin structure
- Update marketplace.json with new plugin versions (git-workflow 1.0.1, codex 0.0.2-alpha)

This ensures all future plugins follow the official Claude Code specification.
- Remove 'category' field from git-workflow plugin.json
- Remove 'category' field from codex plugin.json
- The 'category' field is not part of the official Claude Code plugin schema
- All plugins now pass validation: claude plugin validate ./plugins/*/
- Add separate step to validate each plugin in plugins/ directory
- Previous CI only validated marketplace, missing plugin-specific errors
- Now catches validation errors like unsupported fields in plugin.json
- Loops through all plugins and validates them one by one

This ensures all plugins pass validation before merging.
@Gnnng
Gnnng merged commit 99ffd6b into main Nov 17, 2025
1 check passed
@Gnnng
Gnnng deleted the plugin-structure-update branch November 17, 2025 12:19
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