@konductro/claude-plugin 2.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,29 @@
+{
+  "name": "konductro",
+  "description": "Konductro platform integration — perform technical analysis, submit findings, and manage delivery tasks",
+  "version": "1.0.0",
+  "userConfig": {
+    "konductro_url": {
+      "title": "Konductro URL",
+      "description": "Konductro platform URL (e.g., https://platform.konductro.com or http://localhost:3000)",
+      "type": "string",
+      "sensitive": false
+    },
+    "cli_token": {
+      "title": "CLI Token",
+      "description": "Personal CLI token from Konductro Settings → CLI Access",
+      "type": "string",
+      "sensitive": true
+    }
+  },
+  "mcpServers": {
+    "konductro": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/servers/konductro-api.js"],
+      "env": {
+        "KONDUCTRO_URL": "${user_config.konductro_url}",
+        "KONDUCTRO_CLI_TOKEN": "${user_config.cli_token}"
+      }
+    }
+  }
+}

package/README.md

@@ -0,0 +1,107 @@
+# @konductro/claude-plugin
+
+Claude Code plugin for the Konductro platform. Enables technical analysis, story decomposition, ticket management, prototype delivery, and ticket-to-PR workflows directly from Claude Code.
+
+## Prerequisites
+
+- **Node.js** 18+
+- **Konductro CLI token** (generated in Konductro → Settings → CLI Access)
+
+## Install
+
+### 1. Install the plugin globally
+
+```bash
+npm install -g @konductro/claude-plugin
+```
+
+### 2. Configure for Claude Code
+
+```bash
+konductro-claude-setup --url https://platform.konductro.com --token YOUR_CLI_TOKEN
+```
+
+Get your CLI token from **Konductro → Settings → CLI Access**.
+
+## Skills
+
+Skills are guided, multi-step workflows invoked with a slash command:
+
+| Skill | Description |
+|---|---|
+| `/technical-analysis` | Perform a full codebase analysis for a Konductro project phase |
+| `/decompose` | Decompose a story into technical tasks by exploring the codebase |
+| `/prototype` | Build a UX prototype: load design system, generate HTML, publish to S3, submit |
+| `/find-prototype` | Find and download the approved UX prototype for the current project |
+| `/profile-repository` | Scan the current repo and submit its profile to Konductro |
+| `/start-ticket` | Pick up an assigned ticket — creates branch, pushes ticket spec, sets status |
+
+## Tools
+
+Tools are called automatically by Claude based on natural language. You don't invoke them directly — just ask.
+
+### Tickets and delivery
+
+| Tool | What it does |
+|---|---|
+| `list_my_tickets` | List all tickets assigned to you with status, project, sprint info |
+| `get_ticket_context` | Load full context for a ticket — AC, architectural notes, parent story, repo |
+| `start_work` | Start work on a ticket — creates branch via ADO, pushes spec file, sets in_progress |
+| `create_pr` | Create a pull request for a ticket — auto-assigns reviewer, moves ticket to pr_open |
+
+### Technical analysis
+
+| Tool | What it does |
+|---|---|
+| `list_tech_analysis_tasks` | List your pending technical analysis assignments |
+| `get_task_context` | Load requirements and project context for a tech analysis task |
+| `submit_tech_analysis` | Submit your analysis document back to Konductro |
+
+### Story decomposition
+
+| Tool | What it does |
+|---|---|
+| `list_decomposition_tasks` | List your pending story decomposition assignments |
+| `get_decomposition_context` | Load story details, requirements, and repo context for decomposition |
+| `submit_decomposition_task` | Submit a single decomposed task |
+| `complete_decomposition` | Mark decomposition as complete after all tasks submitted |
+
+### Prototype delivery
+
+| Tool | What it does |
+|---|---|
+| `find_project_prototypes` | Find published prototypes for a project by matching the git remote URL |
+| `list_prototype_tasks` | List your pending prototype build assignments |
+| `get_prototype_context` | Load engagement details, design system, approved docs, and S3 config |
+| `start_prototype_work` | Mark a prototype task as in progress |
+| `request_upload_credentials` | Get temporary S3 credentials to upload prototype files |
+| `submit_prototype` | Submit the published prototype back to Konductro |
+
+### Repository profiling
+
+| Tool | What it does |
+|---|---|
+| `profile_repository` | Submit a repository profile (tech stack, APIs, dependencies) |
+
+### Examples
+
+```
+"What tickets are assigned to me?"          → list_my_tickets
+"Show me the context for MRB-15"            → get_ticket_context
+"I want to start work on MRB-15"            → /start-ticket (guided flow)
+"Run a technical analysis"                  → /technical-analysis (guided flow)
+"Build the prototype for this engagement"   → /prototype (guided flow)
+"Open a PR for MRB-15"                      → create_pr
+```
+
+## Update
+
+```bash
+npm update -g @konductro/claude-plugin
+```
+
+To update your CLI token:
+
+```bash
+konductro-claude-setup --url https://platform.konductro.com --token NEW_TOKEN
+```

package/bin/postinstall.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+console.log('');
+console.log('╔══════════════════════════════════════════════════════╗');
+console.log('║  Konductro Claude Plugin installed                   ║');
+console.log('║                                                      ║');
+console.log('║  Run setup to configure:                             ║');
+console.log('║  konductro-claude-setup --url <URL> --token <TOKEN>  ║');
+console.log('║                                                      ║');
+console.log('║  Get your CLI token from:                            ║');
+console.log('║  Konductro → Settings → CLI Access                   ║');
+console.log('╚══════════════════════════════════════════════════════╝');
+console.log('');

package/bin/setup.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+
+/**
+ * Konductro Claude Plugin Setup
+ *
+ * Configures Claude Code to use the Konductro MCP server.
+ * Usage: konductro-claude-setup --url <konductro-url> --token <cli-token>
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, copyFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+function parseArgs(args) {
+  const parsed = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--url' && args[i + 1]) {
+      parsed.url = args[i + 1].replace(/\/$/, '');
+      i++;
+    } else if (args[i] === '--token' && args[i + 1]) {
+      parsed.token = args[i + 1];
+      i++;
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      parsed.help = true;
+    }
+  }
+  return parsed;
+}
+
+function printHelp() {
+  console.log(`
+Konductro Claude Plugin Setup
+
+Usage:
+  konductro-claude-setup --url <konductro-url> --token <cli-token>
+
+Options:
+  --url     Konductro platform URL (e.g., https://platform.konductro.com)
+  --token   Your personal CLI token from Konductro Settings → CLI Access
+  --help    Show this help message
+
+Example:
+  konductro-claude-setup --url https://platform.konductro.com --token sk-konductro-abc123
+`);
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (!args.url || !args.token) {
+    console.error('Error: Both --url and --token are required.\n');
+    printHelp();
+    process.exit(1);
+  }
+
+  // Find the MCP server path (installed globally or locally)
+  const serverPath = join(__dirname, '..', 'servers', 'konductro-api.js');
+  if (!existsSync(serverPath)) {
+    console.error('Error: MCP server not found at', serverPath);
+    process.exit(1);
+  }
+
+  // Claude Code reads user-scoped MCP config from ~/.claude.json
+  const mcpConfigPath = join(homedir(), '.claude.json');
+
+  // Load existing config or create new
+  let config = {};
+  if (existsSync(mcpConfigPath)) {
+    try {
+      config = JSON.parse(readFileSync(mcpConfigPath, 'utf8'));
+    } catch {
+      console.warn('Warning: Could not parse existing .claude.json, will add MCP config.');
+      config = {};
+    }
+  }
+
+  if (!config.mcpServers) config.mcpServers = {};
+
+  // Add/update Konductro server
+  config.mcpServers.konductro = {
+    command: 'node',
+    args: [serverPath],
+    env: {
+      KONDUCTRO_URL: args.url,
+      KONDUCTRO_CLI_TOKEN: args.token,
+    },
+  };
+
+  // Write config
+  writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2) + '\n');
+
+  // Copy skills to ~/.claude/commands/ so they appear as /slash-commands
+  const commandsDir = join(homedir(), '.claude', 'commands');
+  if (!existsSync(commandsDir)) {
+    mkdirSync(commandsDir, { recursive: true });
+  }
+
+  const skillsDir = join(__dirname, '..', 'skills');
+  if (existsSync(skillsDir)) {
+    // Copy each skill's .md file as a command
+    const skillFolders = readdirSync(skillsDir);
+    for (const folder of skillFolders) {
+      const skillPath = join(skillsDir, folder, 'SKILL.md');
+      if (existsSync(skillPath)) {
+        const destPath = join(commandsDir, `${folder}.md`);
+        copyFileSync(skillPath, destPath);
+      }
+    }
+  }
+
+  console.log('');
+  console.log('✓ Konductro plugin configured for Claude Code');
+  console.log('');
+  console.log('  MCP server: ' + serverPath);
+  console.log('  Commands:   ' + commandsDir);
+  console.log('  Konductro:  ' + args.url);
+  console.log('  Config:     ' + mcpConfigPath);
+  console.log('');
+  console.log('Skills (slash commands):');
+  console.log('  /technical-analysis  — perform codebase analysis');
+  console.log('  /decompose           — decompose a story into tasks');
+  console.log('  /prototype           — build a UX prototype');
+  console.log('  /profile-repository  — scan and submit repo profile');
+  console.log('  /start-ticket        — pick up a ticket and start work');
+  console.log('');
+  console.log('MCP tools (available in conversation):');
+  console.log('  list_tech_analysis_tasks    — see analysis assignments');
+  console.log('  list_decomposition_tasks    — see decomposition assignments');
+  console.log('  list_prototype_tasks        — see prototype assignments');
+  console.log('  list_my_tickets             — see assigned tickets');
+  console.log('  get_ticket_context          — load full ticket context');
+  console.log('  profile_repository          — scan and register repo');
+  console.log('');
+  console.log('To update your token later, run this command again.');
+  console.log('');
+}
+
+main();

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@konductro/claude-plugin",
+  "version": "2.0.0",
+  "description": "Claude Code plugin for the Konductro platform — technical analysis and delivery tasks",
+  "license": "UNLICENSED",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "konductro-claude-setup": "./bin/setup.js"
+  },
+  "files": [
+    "bin/",
+    "servers/",
+    "skills/",
+    ".claude-plugin/"
+  ],
+  "scripts": {
+    "postinstall": "node bin/postinstall.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}