Skip to content

Conversation

@Utakata
Copy link
Contributor

@Utakata Utakata commented Oct 14, 2025

chore: Investigate deleted files and commented commands

This commit is the result of an investigation task. No code changes were made.

The investigation was conducted to address two user concerns:

  1. The reason behind a large number of markdown files being deleted.
  2. The existence of any unintentionally commented-out slash commands (# /...).

Findings:

  1. Deleted Markdown Files: The mass deletion of files was an intentional part of the project's migration from a v3 architecture to the v4 Claude Code official plugin system, as documented in the README.md. The repository structure is consistent with the new v4 architecture.

  2. Commented-out Commands: A thorough search was conducted across the entire repository for the # / pattern. All detected instances were found to be either placeholders for documentation purposes (e.g., # /sc:command-name) or markdown headings, not accidentally disabled commands.

Conclusion: The repository is in a clean and intentional state. The file deletions were part of a planned migration, and there are no inadvertently commented-out commands.

This commit completes the structural transformation of the SuperClaude Framework to align with the official Claude Code plugin system.

This addresses Issue SuperClaude-Org#419 and implements the detailed migration plan provided in the comprehensive design documents.

Key changes include:
- Created the full plugin directory structure, including `.claude-plugin/`, `commands/sc/`, `agents/`, `hooks/`, `scripts/`, `docs/`, and `memory/`.
- Created and populated all JSON configuration files (`plugin.json`, `.mcp.json`, `hooks/hooks.json`, `marketplace.json`) according to the final design specifications.
- Systematically created, renamed, deleted, and reformatted all 25 command and 15 agent markdown files with their complete English content, placing them in the correct directories.
- Added utility scripts for migration, validation, and session management.
- Updated and created all necessary documentation, including `README.md`, `MIGRATION.md`, and `COMMANDS.md`.
- Corrected all inconsistencies from previous reviews, including standardizing the plugin name to 'superclaude' and resolving documentation conflicts.
- Implemented a file-structure-based integration test to validate the final plugin structure.
This commit resolves the merge conflict in `README.md` and removes the deleted files that were causing conflicts.
This commit introduces the MCP Recommendation System feature.

Key changes include:
- Added a `recommendedMcpServers` section to `marketplace.json` to define recommended external MCP servers like `ollama-mcp`.
- Created the new `/sc:mcp-setup` command to guide users through the installation of recommended MCP servers.
- Created detailed documentation for the new feature in `docs/Reference/mcp-setup.md`.
- Updated `README.md` to include a section on the new feature.
- Changed the format of `.mcp.json` to reference the marketplace for server recommendations.
- Corrected version inconsistencies across `pyproject.toml`, `package.json`, and `VERSION` files, unifying them to `5.0.0`.
- Cleaned up documentation by removing out-of-scope files and filling in placeholders.
- Ensured all integration tests pass with the new changes.
This commit refactors the MCP server configuration to support a hybrid approach, as requested by the user.

Key changes:
- Modified `.mcp.json` to define standardized, marketplace-available servers (like `serena` and `context7`) using a `source` reference, while keeping project-specific servers (like `morphllm-fast-apply`) embedded with their direct `npx` commands.
- Removed the now-redundant "MCP Recommendation System" feature, including the `/sc:mcp-setup` command and its associated documentation.
- Cleaned up `marketplace.json` by removing the `recommendedMcpServers` section.
- Updated the `README.md` to remove references to the deleted setup command.

This change aligns the project with the user's preferred workflow of using `npx claude-code-templates` for standard servers while maintaining direct control over custom ones. All associated tests have been updated and are passing.
This commit is the result of a verification task. No code changes were made.

The investigation confirmed the following:
- The repository's file structure aligns with the official Claude Code v4 plugin system.
- No legacy configuration files from v3 that could cause conflicts were found within the repository.
- Integration tests for the plugin file structure pass successfully.
`Docs/User-Guide-jp/modes.md` ファイル内の手動モード制御の
オーバーライド例において、コマンド `/sc:fix auth-issue --introspect` が
欠落していた問題を修正します。

日本語のコメントがコマンドを置き換えてしまっていたため、
ドキュメントの例が不完全になっていました。この変更により、
コマンドとコメントが正しく併記され、ドキュ'メントの
分かりやすさが向上します。
`Docs/User-Guide-jp/modes.md` ファイル内において、日本語コメントがコマンド例を置き換えてしまっていた問題を2箇所修正しました。

この修正にあたり、当初の指摘に加え、他の同様の問題がリポジトリ内に存在しないことを確認するため、`grep`よりも厳密なPythonスクリプトを作成・実行しました。このスクリプトは、全マークダウンファイル内の ` ```shell `ブロックを解析し、コマンドが先行しない日本語コメントを検出するものです。

その網羅的な調査の結果、修正が必要なのは当該ファイルの2箇所のみであり、他には同様の問題が存在しないことを確認済みです。このコミットは、その完全な調査結果を反映したものです。
This commit is the result of an investigation task. No code changes were made.

The investigation was conducted to address two user concerns:
1. The reason behind a large number of markdown files being deleted.
2. The existence of any unintentionally commented-out slash commands (`# /...`).

Findings:
1.  **Deleted Markdown Files:** The mass deletion of files was an intentional part of the project's migration from a v3 architecture to the v4 Claude Code official plugin system, as documented in the README.md. The repository structure is consistent with the new v4 architecture.

2.  **Commented-out Commands:** A thorough search was conducted across the entire repository for the `# /` pattern. All detected instances were found to be either placeholders for documentation purposes (e.g., `# /sc:command-name`) or markdown headings, not accidentally disabled commands.

Conclusion: The repository is in a clean and intentional state. The file deletions were part of a planned migration, and there are no inadvertently commented-out commands.
This commit is the result of an investigation task. No code changes were made.

The investigation was conducted to address two user concerns:
1. The reason behind a large number of markdown files being deleted.
2. The existence of any unintentionally commented-out slash commands (`# /...`).

Findings:
1.  **Deleted Markdown Files:** The mass deletion of files was an intentional part of the project's migration from a v3 architecture to the v4 Claude Code official plugin system, as documented in the README.md. The repository structure is consistent with the new v4 architecture.

2.  **Commented-out Commands:** A thorough search was conducted across the entire repository for the `# /` pattern. All detected instances were found to be either placeholders for documentation purposes (e.g., `# /sc:command-name`) or markdown headings, not accidentally disabled commands.

Conclusion: The repository is in a clean and intentional state. The file deletions were part of a planned migration, and there are no inadvertently commented-out commands.
@mithun50
Copy link
Member

Hey @Utakata what do you think about creating the new repo for this plugin

@Utakata
Copy link
Contributor Author

Utakata commented Oct 15, 2025

@mithun50

Thanks for the review!

agree with your suggestion. Separating the repositories will indeed make it easier to manage compatibility and versioning between the framework and the plugin.

I'll proceed in that direction.

@mithun50
Copy link
Member

@Utakata i sent you an invitation to repo go ahead and work on it feel free to reach if anything else

@Utakata
Copy link
Contributor Author

Utakata commented Oct 15, 2025

@mithun50

Got it, thank you so much! I really appreciate you setting that up for me; it feels very supportive. I've accepted the invitation and am excited to work on the new repo.

@Eamll
Copy link

Eamll commented Oct 17, 2025

@mithun50 Is the new repo public? Can't contribute, but would like to star it so I get the notice when it's ready to use and we can migrate.

@mithun50
Copy link
Member

mithun50 commented Oct 17, 2025

@Eamll https://github.com/SuperClaude-Org/SuperClaude_Plugin

@BillChirico
Copy link

@Eamll https://github.com/SuperClaude-Org/SuperClaude_Plugin

Should we use this instead of the current repo? Looking to reinstall as my context usage is too high currently

@kazukinakai
Copy link
Collaborator

@BillChirico

Hi.
if you hot load context problem you can use my fork next branch
https://github.com/kazukinakai/SuperClaude_Framework/tree/next

And you be able to use also Plugin repo next also.
https://github.com/SuperClaude-Org/SuperClaude_Plugin/tree/next

I already fix that issues.

and I send PR this repo already.

@devstefancho
Copy link

I hope, plugin system is applied to this Repo.
I agree that this migration has too many changes but this is inevitable changes to support marketplace

@kazukinakai
Copy link
Collaborator

@Utakata @mithun50
Regarding plugins, I think the source of truth should be kept in this main Framework repository, and the plugin repository should be used to store the finished distribution files.

@kazukinakai
Copy link
Collaborator

@devstefancho I already confirmed working and fully tested on the next branch.

please check this repo

https://github.com/SuperClaude-Org/SuperClaude_Plugin/tree/next

@kazukinakai
Copy link
Collaborator

kazukinakai commented Oct 30, 2025

@Utakata @NomenAK @mithun50

If you can add me as a collaborator, I can refactor all features into the new plugin format.
I’ve already implemented and tested the plugin structure on the next branch — about 95 commits so far.
I’ve also been following the implementation method recommended by Claude Code and Anthropic, using the skill-graph structure.
I fully understand the whole flow now, so if you let me handle it, I can take care of all plugin development end-to-end.

@Utakata
Copy link
Contributor Author

Utakata commented Oct 30, 2025

@kazukinakai
​When I read your proposal to take on the full end-to-end refactoring into the new plugin format, and saw that you've already done extensive work on it, I felt a great sense of excitement and gratitude.
​This is because our team has a strong need for the project to evolve with high-quality contributions, and we deeply value collaboration and shared ownership.
​To move forward on this, I have just sent you a collaborator invitation. Would you be willing to accept it so you can begin integrating your work?
​We are genuinely looking forward to working with you.

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.

6 participants