claude-code-spec-kit-subagent-plugin

Claude Code Spec Kit Subagent Plugin

Spec Kit Partner is now provided as a Claude Code plugin: a next-generation, conversational, adaptive, and agentic tool designed to help humans co-create rigorous, multi-perspective technical specs for GitHub Spec Kit projects. It leverages dynamic memory graphs, adaptive workflows, and explicit multi-role analysis to bridge human creativity and technical rigor. Yes, it is particularly useful for humans who are non-technical and/or not trained yet in Spec Kit Methodology.

---

Features

• Conversational Orchestration: Natural, empathic dialogue management tailored to user preferences.
• Multi-Role Analysis: Dynamically identifies and embodies relevant professional perspectives for robust analysis.
• Memory Graph: Persists all insights, relationships, and synthesis steps in a queryable, file-based graph.
• Adaptive Workflow: Adjusts process phases and requirements in response to user input and context.
• Transparent Logging: All actions, analysis, and conversations are logged for auditability and recovery.
• Claude Code Marketplace Compatible: Fully supports Claude Code plugin marketplaces, including a complete .claude-plugin/marketplace.json descriptor.

---

Plugin Directory & File Structure

All plugin metadata, code, and agent-generated artifacts are organized as follows:

claude-code-spec-kit-subagent-plugin/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── agents/
│   └── spec-kit-partner.md
├── spec-kit-partner/
│   ├── src/
│   │   ├── main.py
│   │   ├── workflow_manager.py
│   │   ├── memory_graph.py
│   │   ├── user_profile.py
│   │   └── multi_role_analysis.py
│   └── project-data/
│       ├── memory-graph.json
│       ├── user_profile.json
│       ├── workflow_state.json
│       ├── multi-role-analysis.json
│       ├── logs/
│       │   ├── conversation.log
│       │   └── internal_monologue.log
│       ├── spec/
│       │   ├── spec.md
│       │   └── state.json
│       └── diagrams/
│           ├── system_flow.mermaid
│           ├── memory_graph.mermaid
│           ├── workflow_state_machine.mermaid
│           ├── multi_role_analysis_flow.mermaid
│           ├── agent_user_interaction.mermaid
│           ├── data_flow.mermaid
│           └── role_perspective_map.mermaid
├── assets/
│   ├── icon.png
│   ├── screenshot1.png
│   └── screenshot2.png
├── README.md
├── LICENSE
└── CHANGELOG.md

---

Marketplace Metadata

Marketplace and plugin metadata are defined in:

• .claude-plugin/plugin.json — Main plugin manifest.
• .claude-plugin/marketplace.json — Marketplace listing fields including display_name, summary, categories, icon, documentation_url, publisher, license, screenshots, and more.

See Official Claude Code Marketplace Docs.

---

Diagram Output Types

All diagrams are output as Mermaid (.mermaid) format for easy rendering and AI parsing. Rendered .svg or .png versions may also be exported, but .mermaid is canonical.

---

Initialization Protocol

On first run or when required files are missing:

• Ensure all required directories exist before writing.
• Generate all support code and persistent data files as described in Initialization Protocol.
• Populate each .json file using provided schemas and set initial values.
• Log all steps and errors to project-data/logs/conversation.log.

See spec-kit-partner.md for full protocol.

---

Usage

1. Install this plugin into your Claude Code environment using your plugin manager or by cloning this repository under /plugins/.
2. On first invocation, the plugin will create and initialize all required files and directories in its workspace.
3. All runtime state, logs, diagrams, and outputs are self-contained within the plugin directory.
4. For more details on engine architecture, data schemas, and interaction protocols, refer to the main spec file or plugin documentation.

---

Development & Contributing

This repository includes automated workflows to ensure code quality:

• Python Linting - Validates syntax and style of Python code
• JSON Validation - Ensures plugin manifests are valid and complete
• Asset Validation - Checks that referenced files exist
• Markdown/Mermaid Linting - Validates documentation syntax
• Python Tests - Runs automated test suite

All workflows run automatically on pull requests. See CONTRIBUTING.md for detailed development guidelines.

---

License

This project is licensed under the MIT License.

---

Contact & Support