CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, this project adheres to Semantic Versioning, commits follow Conventional Commits, and this changelog is generated by Structured Changelog.

Unreleased

v0.12.0 - 2026-03-08

Highlights

• Post-generation install instructions for Kiro CLI and Claude Code
• Output path validation to prevent duplicate subdirectory nesting

Added

• printInstallInstructions() prints platform-specific install commands after generation (6b35246)
• Help text documents deployment output path requirements (plugin root vs subdirectory) (6b35246)

Fixed

• Reject output paths ending in agents, steering, skills, commands with actionable error (5cef768)

Documentation

• New Installation section in Kiro CLI docs with copy vs direct install workflows (1dee8a5)
• Project vs User-Level Agents comparison table explaining Kiro's design constraints (1dee8a5)
• Steering files workaround for project-level context in Kiro CLI (1dee8a5)

Tests

• Added TestGeneratePlatformPlugin_RejectsSubdirectoryPaths for output path validation (78d4fb3)

v0.11.0 - 2026-03-02

Highlights

• BREAKING: Module path migrated from github.com/agentplexus/assistantkit to github.com/plexusone/assistantkit
• Organization migration to plexusone GitHub organization

Changed

• Module path renamed from github.com/agentplexus/assistantkit to github.com/plexusone/assistantkit (232a4c2)
• Updated multi-agent-spec/sdk/go dependency to v0.8.0 from plexusone org (232a4c2)
• Updated all internal imports to use new module path (232a4c2)
• Updated documentation site URL to plexusone.github.io (232a4c2)
• Upgraded go-github from v82 to v84 for compatibility with gogithub v0.10.0 (53d78cc)

Documentation

• Updated all documentation references to plexusone organization (232a4c2)
• Updated installation instructions with new module path (232a4c2)

v0.10.0 - 2026-02-21

Highlights

• Self-directed team support with crew, swarm, and council workflow types
• New validate command for specs directory validation before generation
• Single-source prefix for Kiro: define prefix once in deployment config, applied everywhere
• Team DAG validation with agent reference checking

Added

• teams/core.SelfDirectedTeam wrapper for multi-agent-spec teams with workflow helpers (27b71cb)
• teams/claude.Adapter for converting self-directed teams to Claude Code format (c3875e8)
• generate.Teams() function for generating platform-specific team files (0015566)
• Re-exported SelfDirectedTeam, SelfDirectedConfig, NewSelfDirectedTeam in teams package (acf8181)
• assistantkit validate command for pre-generation validation of specs directories (0e66a0d)
• generate.Validate() function returning ValidateResult with checks, errors, warnings, and stats (0e66a0d)
• Team DAG validation: acyclicity check, agent reference resolution, input from reference validation (3c8a75e)
• --skip-validate flag for generate command to bypass validation (3c8a75e)
• Single-source prefix: kiroCli.prefix in deployment config applies to agent names, filenames, and README (3c8a75e)
• convertToKiroAgentWithName() for prefixed agent name generation (3c8a75e)
• buildKiroAgentsReadmeWithPrefix() for prefixed README generation (3c8a75e)
• Kiro CLI usage examples in generated README with coordinator detection (17a53a9)
• Installation section in generated Kiro README for kiro-cli setup (17a53a9)

Changed

• generate command now runs validation by default before generation (3c8a75e)
• KiroTargetConfig extended with PluginDir and Format fields (3c8a75e)
• DeploymentTarget struct now includes KiroCli field for structured config (3c8a75e)

Fixed

• Kiro steering file names now correctly apply prefix from deployment config (878625d)
• Kiro agent JSON filenames and name fields now apply prefix from deployment config (3c8a75e)
• Kiro agent tool mapping now includes execute_bash, fs_read, fs_write (cebcb40)

Dependencies

• Upgraded multi-agent-spec/sdk/go v0.5.0 → v0.7.0 for self-directed workflow support (bf83492)
• Upgraded gogithub v0.8.0 → v0.9.1 (ad497aa)

Documentation

• Claude Code deployment guide with plugin structure and sub-agent system (69084c1)
• Kiro CLI deployment guide with prefix configuration and multi-team setup (5301b57)
• Added enhancement proposal for validate and test commands (1aff391)
• Updated enhancement doc with implementation status and single-source prefix docs (2207fed)

Infrastructure

• Updated CI workflows to Go 1.24 and 1.25 (da1303a)

v0.9.0 - 2026-02-02

Highlights

• Unified specs/ directory with deployment-driven plugin generation
• Single 'assistantkit generate' command replaces separate subcommands

Added

• Generate() function for unified deployment-driven plugin generation from specs/ (b2d8fb1)
• generatePlatformPlugin() helper for per-platform complete plugin generation (b2d8fb1)
• Main generate command now runnable with --specs, --target, --output flags (679e6dd)

Changed

• loadAgents() now uses agents.ReadCanonicalDir() supporting both .md and .json files (b2d8fb1)
• Each deployment target now receives complete plugin (agents, commands, skills, manifest) (b2d8fb1)

Deprecated

• generate plugins subcommand - use generate --specs=... --target=... instead (679e6dd)
• generate agents subcommand - use generate --specs=... --target=... instead (679e6dd)
• generate all subcommand - use generate --specs=... --target=... instead (679e6dd)
• generate deployment subcommand - use generate --specs=... --target=... instead (679e6dd)

Dependencies

• Upgraded go-github v81 → v82 (90aecb4)

Documentation

• Updated README CLI section for unified generate workflow (88e7399)
• Updated CLAUDE.md with generate package and CLI workflow sections (88e7399)

v0.8.0 - 2026-01-25

Highlights

• Simplified agent generation with 'generate agents' and 'generate all' commands
• Markdown command file support with YAML frontmatter

Added

• generate agents command for simplified multi-agent-spec workflow (2f5db70)
• generate all command combining plugins and agents generation (2f5db70)
• Markdown command file support with YAML frontmatter in commands/core (42abcd7)
• Auto-detection of command file format (.md vs .json) (42abcd7)
• CLI dependency checking with HITL prompts in requirements (1be8e02)

Dependencies

• Upgraded multi-agent-spec/sdk/go v0.4.0 → v0.5.0 (aa4e40a)

Documentation

• Added 'generate agents' command documentation to README (b9a9a39)

v0.7.0 - 2026-01-24

Highlights

• Adopt multi-agent-spec SDK as canonical agent model with new powers, skills/kiro, and CLI packages

Added

• powers package with canonical Power type and Kiro IDE power generation (POWER.md, mcp.json, steering files) (48a5262)
• skills/kiro adapter for generating Kiro steering files from canonical skills (b56063d)
• Markdown skill format with YAML frontmatter in skills/core (b56063d)
• generate package for programmatic plugin and deployment generation (Claude, Kiro, Gemini) (f5df2a5)
• cmd/assistantkit CLI with generate plugins and generate deployment subcommands (22d3d57)
• genagents CLI: --skills/--skills-output flags for steering file generation (d204e70)
• genagents CLI: --install flag to copy agents and skills to ~/.kiro/ (d204e70)
• Model type constants: ModelHaiku, ModelSonnet, ModelOpus (458c974)

Changed

• BREAKING: Agent struct replaced with type alias to multiagentspec.Agent; setter methods removed in favor of builder pattern (458c974)
• BREAKING: Agent.Model field type changed from string to Model (type alias to multiagentspec.Model) (458c974)
• Kiro agent adapter uses actual tool names (execute_bash, fs_read, fs_write) with deduplication (458c974)

Dependencies

• Upgraded multi-agent-spec/sdk/go v0.3.0 → v0.4.0 (840400b)
• Added github.com/spf13/cobra v1.10.2 for CLI framework (840400b)

Documentation

• Added CLI reference documentation for generate plugins command (67bfa39)
• Updated README with CLI install and usage sections (67bfa39)
• Added v0.7.0 release notes (054a744)

Tests

• Updated agent tests for Model type and builder-style API (026fcfc)
• Updated Kiro adapter tests for new tool names and deduplication (026fcfc)

v0.6.0 - 2026-01-18

Highlights

• Unified bundle generation package for multi-tool plugin output

Added

• bundle package for unified plugin bundle generation across tools (Claude, Kiro, Gemini, Cursor, Codex, VS Code) (7419d87)
• bundle.New(), Generate(), GenerateAll() methods for creating and outputting bundles (7419d87)
• Consolidated plugin.json format for Claude with embedded MCP servers and hooks (7419d87)
• MCPServerConfig, HooksConfig, HookEntry, Hook types in plugins/claude (885b084)

Changed

• BREAKING: ClaudePlugin.Hooks field type changed from string to *HooksConfig (885b084)
• ClaudePlugin now supports embedded MCPServers map for consolidated config (885b084)
• ToCanonical() and FromCanonical() updated to convert MCP servers (885b084)

Dependencies

• Updated multi-agent-spec/sdk/go v0.1.0 → v0.3.0 (aa28c70)
• Updated gogithub v0.5.0 → v0.6.0 (aa28c70)

Documentation

• Updated Claude marketplace docs with bundle API examples and consolidated format (fecbd4c)

Tests

• Added unit tests for bundle package (New, AddComponents, Generate, GenerateAll) (aeb9962)

v0.5.0 - 2026-01-18

Highlights

• Module renamed from aiassistkit to assistantkit

Changed

• BREAKING: Module path renamed from github.com/agentplexus/aiassistkit to github.com/plexusone/assistantkit (2232018)
• Package name renamed from aiassistkit to assistantkit (2232018)
• Main source file renamed from aiassistkit.go to assistantkit.go (2232018)

Documentation

• Updated documentation for assistantkit rename (3bdf058)
• Added v0.5.0 release notes with migration guide (01c2124)

v0.4.0 - 2026-01-17

Highlights

• Migration to agentplexus organization with hooks package for AI assistant lifecycle events

Added

• hooks package with adapters for AI assistant lifecycle hooks (Claude, Cursor, Windsurf) (e7155b9)
• hooks/core with canonical hook types, events, and adapter interface (e7155b9)
• hooks/claude adapter for Claude Code hooks (PreToolUse, PostToolUse, etc.) (e7155b9)
• hooks/cursor adapter for Cursor IDE hooks (e7155b9)
• hooks/windsurf adapter for Windsurf hooks (e7155b9)

Changed

• Module path changed from github.com/grokify/aiassistkit to github.com/plexusone/assistantkit (35abed5)

Dependencies

• Added github.com/plexusone/multi-agent-spec/sdk/go for multi-agent specifications (9a7c9c7)

Documentation

• Updated documentation for agentplexus migration (f02d4da)
• Added v0.4.0 release notes (f02d4da)

v0.3.0 - 2026-01-17

Highlights

• Automated marketplace publishing with GitHub PR creation

Added

• publish package for automated plugin submission to AI assistant marketplaces (f51322d)
• publish/claude adapter for Claude Code marketplace (anthropics/claude-plugins-official) (f51322d)
• publish/github client wrapper using gogithub for GitHub API operations (f51322d)

Dependencies

• Added github.com/grokify/gogithub v0.5.0 for GitHub API utilities (f51322d)
• Added github.com/google/go-github/v81 for GitHub API client (f51322d)

v0.2.0 - 2026-01-17

Highlights

• Multi-platform agent generation with new AWS adapters and genagents CLI

Added

• agents/agentkit adapter for AWS AgentKit/Agent Builder JSON format (d49e2f5)
• agents/awsagentcore adapter for AWS CDK TypeScript code generation (d49e2f5)
• cmd/genagents CLI for multi-platform agent generation from canonical specs (5bcd07e)

Documentation

• Comprehensive MkDocs documentation site with Material theme (2ca28b3)
• Release notes section with v0.1.0 and v0.2.0 notes (ab6ec4e)

Infrastructure

• GitHub Actions workflow for MkDocs gh-pages deployment (70d0053)

v0.1.0 - 2026-01-12

Highlights

• Initial release with unified configuration management for AI coding assistants supporting 9 tools

Added

• mcp package with adapters for MCP server configurations (Claude, Cursor, Windsurf, VS Code, Codex, Cline, Roo, Kiro) (ae9f762)
• context package with converter for generating CLAUDE.md from CONTEXT.json (50bacd7)
• agents package with adapters for AI assistant agent definitions (Claude, Codex, Gemini, Kiro) (b62c572)
• commands package with adapters for slash command definitions (Claude, Codex, Gemini) (7578daf)
• plugins package with adapters for plugin/extension configurations (Claude, Gemini) (76ba9cf)
• skills package with adapters for reusable skill definitions (Claude, Codex) (e532fc1)
• teams package for multi-agent team orchestration with process types (sequential, parallel, hierarchical) (5c75117)
• validation package with configuration validators (Claude, Codex, Gemini) (95ec174)
• Adapter pattern with canonical types and tool-specific converters (ae9f762)
• Self-registering adapters via init() for automatic discovery (ae9f762)
• JSON Schema validation for plugins, commands, skills, agents, teams, and validation configs (95ec174)

Documentation

• PRD.md product requirements document (a741e66)
• TRD.md technical requirements document (a741e66)
• ROADMAP.md and ROADMAP.json for project planning (a741e66)
• README.md with installation and usage examples (a741e66)
• PRESENTATION.md Marp slides for project overview (a741e66)