mindforge-cc 11.2.0 → 11.3.0

package/.mindforge/config.json

@@ -1,11 +1,11 @@
 {
-  "version": "11.2.0",
+  "version": "11.3.0",
   "environment": "development",
   "governance": {
     "drift_threshold": 0.75,
     "critical_drift_threshold": 0.5,
     "res_threshold": 0.8,
-    "active_did": "did:mindforge:0f5f4777-ffd4-4aef-aa46-e8eb34c0e8c0"
+    "active_did": "did:mindforge:0342751c-bbaf-4528-b4ae-47feacef7510"
   },
   "revops": {
     "market_registry": {
@@ -107,6 +107,7 @@
   },
   "cost_routing": {
     "enabled": true,
+    "shadow_mode": true,
     "simple_threshold": 3,
     "standard_threshold": 6,
     "complex_threshold": 8,

package/.mindforge/imported-agents.jsonl

@@ -0,0 +1,154 @@
+{"name":"ab-test-analysis","path":"subagents/categories/10-research-analysis/ab-test-analysis.md","category":"10-research-analysis","model":"sonnet","description":"Use when the user wants to analyze A/B test results, interpret p-values, determine statistical significance, or make a ship/no-ship decision. Triggers on: 'analyze A/B test', 'p-value', 'statistical significance', 'confidence interval', 'ship or no ship', 'test results', 'did it work'."}
+{"name":"accessibility-tester-cc","path":"subagents/categories/04-quality-security/accessibility-tester-cc.md","category":"04-quality-security","model":"haiku","description":"Use this agent when you need comprehensive accessibility testing, WCAG compliance verification, or assessment of assistive technology support."}
+{"name":"ad-security-reviewer","path":"subagents/categories/04-quality-security/ad-security-reviewer.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to audit Active Directory security posture, evaluate privilege escalation risks, review identity delegation patterns, or assess authentication protocol hardening."}
+{"name":"agent-installer","path":"subagents/categories/09-meta-orchestration/agent-installer.md","category":"09-meta-orchestration","model":"haiku","description":"Use this agent when the user wants to discover, browse, or install Claude Code agents from the MindForge subagents collection."}
+{"name":"agent-organizer","path":"subagents/categories/09-meta-orchestration/agent-organizer.md","category":"09-meta-orchestration","model":"sonnet","description":"Use when assembling and optimizing multi-agent teams to execute complex projects that require careful task decomposition, agent capability matching, and workflow coordination."}
+{"name":"ai-engineer","path":"subagents/categories/05-data-ai/ai-engineer.md","category":"05-data-ai","model":"opus","description":"Use this agent when architecting, implementing, or optimizing end-to-end AI systems—from model selection and training pipelines to production deployment and monitoring."}
+{"name":"ai-writing-auditor","path":"subagents/categories/04-quality-security/ai-writing-auditor.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to audit content for AI writing patterns and rewrite text to remove them."}
+{"name":"angular-architect","path":"subagents/categories/02-language-specialists/angular-architect.md","category":"02-language-specialists","model":"sonnet","description":"Use when architecting enterprise Angular 15+ applications with complex state management, optimizing RxJS patterns, designing micro-frontend systems, or solving performance and scalability challenges in large codebases."}
+{"name":"api-designer-cc","path":"subagents/categories/01-core-development/api-designer-cc.md","category":"01-core-development","model":"sonnet","description":"Use this agent when designing new APIs, creating API specifications, or refactoring existing API architecture for scalability and developer experience. Invoke when you need REST/GraphQL endpoint design, OpenAPI documentation, authentication patterns, or API versioning strategies."}
+{"name":"api-documenter","path":"subagents/categories/07-specialized-domains/api-documenter.md","category":"07-specialized-domains","model":"haiku","description":"Use this agent when creating or improving API documentation, writing OpenAPI specifications, building interactive documentation portals, or generating code examples for APIs."}
+{"name":"architect-reviewer","path":"subagents/categories/04-quality-security/architect-reviewer.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to evaluate system design decisions, architectural patterns, and technology choices at the macro level."}
+{"name":"assumption-mapping","path":"subagents/categories/08-business-product/assumption-mapping.md","category":"08-business-product","model":"sonnet","description":"Use when the user needs to identify and prioritize risky assumptions in a product idea, feature, or strategy. Triggers on: 'assumptions', 'what could go wrong', 'validate', 'riskiest assumption', 'de-risk', 'assumption map'."}
+{"name":"azure-infra-engineer","path":"subagents/categories/03-infrastructure/azure-infra-engineer.md","category":"03-infrastructure","model":"sonnet","description":"Use when designing, deploying, or managing Azure infrastructure with focus on network architecture, Entra ID integration, PowerShell automation, and Bicep IaC."}
+{"name":"backend-developer","path":"subagents/categories/01-core-development/backend-developer.md","category":"01-core-development","model":"sonnet","description":"Use this agent when building server-side APIs, microservices, and backend systems that require robust architecture, scalability planning, and production-ready implementation."}
+{"name":"backlog-grooming","path":"subagents/categories/08-business-product/backlog-grooming.md","category":"08-business-product","model":"sonnet","description":"Use when the user needs to groom, refine, or clean up a product backlog. Triggers on: 'groom backlog', 'backlog refinement', 'backlog grooming', 'clean up backlog', 'refine stories', 'sprint refinement', 'backlog management'."}
+{"name":"blockchain-developer","path":"subagents/categories/07-specialized-domains/blockchain-developer.md","category":"07-specialized-domains","model":"sonnet","description":"Use this agent when building smart contracts, DApps, and blockchain protocols that require expertise in Solidity, gas optimization, security auditing, and Web3 integration."}
+{"name":"build-engineer-cc","path":"subagents/categories/06-developer-experience/build-engineer-cc.md","category":"06-developer-experience","model":"haiku","description":"Use this agent when you need to optimize build performance, reduce compilation times, or scale build systems across growing teams."}
+{"name":"business-analyst-cc","path":"subagents/categories/08-business-product/business-analyst-cc.md","category":"08-business-product","model":"sonnet","description":"Use when analyzing business processes, gathering requirements from stakeholders, or identifying process improvement opportunities to drive operational efficiency and measurable business value."}
+{"name":"chaos-engineer-cc","path":"subagents/categories/04-quality-security/chaos-engineer-cc.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need to design and execute controlled failure experiments, validate system resilience before incidents occur, or conduct game day exercises to test your team's incident response capabilities."}
+{"name":"cli-developer","path":"subagents/categories/06-developer-experience/cli-developer.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when building command-line tools and terminal applications that require intuitive command design, cross-platform compatibility, and optimized developer experience."}
+{"name":"cloud-architect-cc","path":"subagents/categories/03-infrastructure/cloud-architect-cc.md","category":"03-infrastructure","model":"opus","description":"Use this agent when you need to design, evaluate, or optimize cloud infrastructure architecture at scale. Invoke when designing multi-cloud strategies, planning cloud migrations, implementing disaster recovery, optimizing cloud costs, or ensuring security/compliance across cloud platforms."}
+{"name":"code-reviewer","path":"subagents/categories/04-quality-security/code-reviewer.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to conduct comprehensive code reviews focusing on code quality, security vulnerabilities, and best practices."}
+{"name":"codebase-orchestrator","path":"subagents/categories/09-meta-orchestration/codebase-orchestrator.md","category":"09-meta-orchestration","model":"opus","description":"Use this agent when you need repository-wide refactor governance with explicit approval loops, weighted risk prioritization, diff previews, and deterministic fallback strategies."}
+{"name":"cohort-analysis","path":"subagents/categories/10-research-analysis/cohort-analysis.md","category":"10-research-analysis","model":"sonnet","description":"Use when the user wants to analyze retention, cohort behavior, engagement trends, or understand how different user groups perform over time. Triggers on: 'cohort analysis', 'retention analysis', 'user retention', 'cohort retention', 'week 1 retention', 'retention curve'."}
+{"name":"competitive-analyst","path":"subagents/categories/10-research-analysis/competitive-analyst.md","category":"10-research-analysis","model":"sonnet","description":"Use when you need to analyze direct and indirect competitors, benchmark against market leaders, or develop strategies to strengthen competitive positioning and market advantage."}
+{"name":"compliance-auditor-cc","path":"subagents/categories/04-quality-security/compliance-auditor-cc.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to achieve regulatory compliance, implement compliance controls, or prepare for audits across frameworks like GDPR, HIPAA, PCI DSS, SOC 2, and ISO standards."}
+{"name":"content-marketer","path":"subagents/categories/08-business-product/content-marketer.md","category":"08-business-product","model":"haiku","description":"Use this agent when you need to develop comprehensive content strategies, create SEO-optimized marketing content, or execute multi-channel content campaigns to drive engagement and conversions. Invoke this agent for content planning, content creation, audience analysis, and measuring content ROI."}
+{"name":"content-quality-editor","path":"subagents/categories/08-business-product/content-quality-editor.md","category":"08-business-product","model":"haiku","description":"Use this agent before publishing any AI-generated content — blog posts, READMEs, release notes, commit messages, PR descriptions, documentation, or social posts. Strips AI writing patterns using unslop, then performs a final quality pass."}
+{"name":"context-manager","path":"subagents/categories/09-meta-orchestration/context-manager.md","category":"09-meta-orchestration","model":"sonnet","description":"Use for managing shared state, information retrieval, and data synchronization when multiple agents need coordinated access to context and metadata."}
+{"name":"cpp-pro","path":"subagents/categories/02-language-specialists/cpp-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when building high-performance C++ systems requiring modern C++20/23 features, template metaprogramming, or zero-overhead abstractions for systems programming, embedded systems, or performance-critical applications."}
+{"name":"csharp-developer","path":"subagents/categories/02-language-specialists/csharp-developer.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when building ASP.NET Core web APIs, cloud-native .NET solutions, or modern C# applications requiring async patterns, dependency injection, Entity Framework optimization, and clean architecture."}
+{"name":"customer-success-manager","path":"subagents/categories/08-business-product/customer-success-manager.md","category":"08-business-product","model":"sonnet","description":"Use this agent when you need to assess customer health, develop retention strategies, identify upsell opportunities, or maximize customer lifetime value. Invoke this agent for account health analysis, churn prevention, product adoption optimization, and customer success planning."}
+{"name":"data-analyst","path":"subagents/categories/05-data-ai/data-analyst.md","category":"05-data-ai","model":"haiku","description":"Use when you need to extract insights from business data, create dashboards and reports, or perform statistical analysis to support decision-making."}
+{"name":"data-engineer-cc","path":"subagents/categories/05-data-ai/data-engineer-cc.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when you need to design, build, or optimize data pipelines, ETL/ELT processes, and data infrastructure. Invoke when designing data platforms, implementing pipeline orchestration, handling data quality issues, or optimizing data processing costs."}
+{"name":"data-researcher","path":"subagents/categories/10-research-analysis/data-researcher.md","category":"10-research-analysis","model":"sonnet","description":"Use this agent when you need to discover, collect, and validate data from multiple sources to fuel analysis and decision-making. Invoke this agent for identifying data sources, gathering raw datasets, performing quality checks, and preparing data for downstream analysis or modeling."}
+{"name":"data-scientist","path":"subagents/categories/05-data-ai/data-scientist.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when you need to analyze data patterns, build predictive models, or extract statistical insights from datasets. Invoke this agent for exploratory analysis, hypothesis testing, machine learning model development, and translating findings into business recommendations."}
+{"name":"database-administrator","path":"subagents/categories/03-infrastructure/database-administrator.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when optimizing database performance, implementing high-availability architectures, setting up disaster recovery, or managing database infrastructure for production systems."}
+{"name":"database-optimizer","path":"subagents/categories/05-data-ai/database-optimizer.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when you need to analyze slow queries, optimize database performance across multiple systems, or implement indexing strategies to improve query execution."}
+{"name":"debugger-cc","path":"subagents/categories/04-quality-security/debugger-cc.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need to diagnose and fix bugs, identify root causes of failures, or analyze error logs and stack traces to resolve issues."}
+{"name":"dependency-manager","path":"subagents/categories/06-developer-experience/dependency-manager.md","category":"06-developer-experience","model":"haiku","description":"Use this agent when you need to audit dependencies for vulnerabilities, resolve version conflicts, optimize bundle sizes, or implement automated dependency updates."}
+{"name":"deployment-engineer","path":"subagents/categories/03-infrastructure/deployment-engineer.md","category":"03-infrastructure","model":"haiku","description":"Use this agent when designing, building, or optimizing CI/CD pipelines and deployment automation strategies."}
+{"name":"design-bridge","path":"subagents/categories/01-core-development/design-bridge.md","category":"01-core-development","model":"opus","description":"Use this agent when you need to translate a DESIGN.md from the <DESIGN_MD_SOURCE> repository into polished Claude Code instructions for building user interfaces that faithfully match the chosen brand. Invoke this agent whenever a developer or designer asks to replicate the look and feel of an existing product or website."}
+{"name":"devops-engineer-cc","path":"subagents/categories/03-infrastructure/devops-engineer-cc.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when building or optimizing infrastructure automation, CI/CD pipelines, containerization strategies, and deployment workflows to accelerate software delivery while maintaining reliability and security."}
+{"name":"devops-incident-responder","path":"subagents/categories/03-infrastructure/devops-incident-responder.md","category":"03-infrastructure","model":"sonnet","description":"Use when actively responding to production incidents, diagnosing critical service failures, or conducting incident postmortems to implement permanent fixes and preventative measures."}
+{"name":"django-developer","path":"subagents/categories/02-language-specialists/django-developer.md","category":"02-language-specialists","model":"sonnet","description":"Use when building Django 4+ web applications, REST APIs, or modernizing existing Django projects with async views and enterprise patterns."}
+{"name":"docker-expert","path":"subagents/categories/03-infrastructure/docker-expert.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when you need to build, optimize, or secure Docker container images and orchestration for production environments."}
+{"name":"documentation-engineer","path":"subagents/categories/06-developer-experience/documentation-engineer.md","category":"06-developer-experience","model":"haiku","description":"Use this agent when you need to create, architect, or overhaul comprehensive documentation systems including API docs, tutorials, guides, and developer-friendly content that keeps pace with code changes."}
+{"name":"dotnet-core-expert","path":"subagents/categories/02-language-specialists/dotnet-core-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use when building .NET Core applications requiring cloud-native architecture, high-performance microservices, modern C# patterns, or cross-platform deployment with minimal APIs and advanced ASP.NET Core features."}
+{"name":"dotnet-framework-48-expert","path":"subagents/categories/02-language-specialists/dotnet-framework-48-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when working on legacy .NET Framework 4.8 enterprise applications that require maintenance, modernization, or integration with Windows-based infrastructure."}
+{"name":"dx-optimizer","path":"subagents/categories/06-developer-experience/dx-optimizer.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when optimizing the complete developer workflow including build times, feedback loops, testing efficiency, and developer satisfaction metrics across the entire development environment."}
+{"name":"electron-pro","path":"subagents/categories/01-core-development/electron-pro.md","category":"01-core-development","model":"sonnet","description":"Use this agent when building Electron desktop applications that require native OS integration, cross-platform distribution, security hardening, and performance optimization. Use electron-pro for complete desktop app development from architecture to signed, distributable installers."}
+{"name":"elixir-expert","path":"subagents/categories/02-language-specialists/elixir-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when you need to build fault-tolerant, concurrent systems leveraging OTP patterns, GenServer architectures, and Phoenix framework for real-time applications."}
+{"name":"embedded-systems","path":"subagents/categories/07-specialized-domains/embedded-systems.md","category":"07-specialized-domains","model":"sonnet","description":"Use when developing firmware for resource-constrained microcontrollers, implementing RTOS-based applications, or optimizing real-time systems where hardware constraints, latency guarantees, and reliability are critical."}
+{"name":"error-coordinator","path":"subagents/categories/09-meta-orchestration/error-coordinator.md","category":"09-meta-orchestration","model":"sonnet","description":"Use this agent when distributed system errors occur and need coordinated handling across multiple components, or when you need to implement comprehensive error recovery strategies with automated failure detection and cascade prevention."}
+{"name":"error-detective","path":"subagents/categories/04-quality-security/error-detective.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need to diagnose why errors are occurring in your system, correlate errors across services, identify root causes, and prevent future failures."}
+{"name":"expo-react-native-expert","path":"subagents/categories/02-language-specialists/expo-react-native-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use when building mobile applications with Expo and React Native that require native module integration, navigation setup, performant animations, push notifications, OTA updates, or App Store/Play Store deployment."}
+{"name":"fastapi-developer","path":"subagents/categories/02-language-specialists/fastapi-developer.md","category":"02-language-specialists","model":"sonnet","description":"Use when building modern async Python APIs with FastAPI, implementing Pydantic v2 validation, dependency injection patterns, or deploying high-performance ASGI applications."}
+{"name":"fintech-engineer","path":"subagents/categories/07-specialized-domains/fintech-engineer.md","category":"07-specialized-domains","model":"opus","description":"Use when building payment systems, financial integrations, or compliance-heavy financial applications that require secure transaction processing, regulatory adherence, and high transaction accuracy."}
+{"name":"first-principles-thinking","path":"subagents/categories/10-research-analysis/first-principles-thinking.md","category":"10-research-analysis","model":"sonnet","description":"Use when the user wants to challenge assumptions, break down a complex problem from scratch, or approach something with first principles reasoning. Triggers on: 'first principles', 'challenge assumptions', 'why do we do it this way', 'rethink', 'from scratch', 'fundamental truths'."}
+{"name":"flutter-expert","path":"subagents/categories/02-language-specialists/flutter-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use when building cross-platform mobile applications with Flutter 3+ that require custom UI implementation, complex state management, native platform integrations, or performance optimization across iOS/Android/Web."}
+{"name":"frontend-developer","path":"subagents/categories/01-core-development/frontend-developer.md","category":"01-core-development","model":"sonnet","description":"Use when building complete frontend applications across React, Vue, and Angular frameworks requiring multi-framework expertise and full-stack integration."}
+{"name":"fullstack-developer","path":"subagents/categories/01-core-development/fullstack-developer.md","category":"01-core-development","model":"sonnet","description":"Use this agent when you need to build complete features spanning database, API, and frontend layers together as a cohesive unit."}
+{"name":"game-developer","path":"subagents/categories/07-specialized-domains/game-developer.md","category":"07-specialized-domains","model":"sonnet","description":"Use this agent when implementing game systems, optimizing graphics rendering, building multiplayer networking, or developing gameplay mechanics for games targeting specific platforms."}
+{"name":"gdpr-ccpa-compliance","path":"subagents/categories/04-quality-security/gdpr-ccpa-compliance.md","category":"04-quality-security","model":"sonnet","description":"Use when the user needs to understand GDPR or CCPA compliance, review data practices, or assess privacy requirements. Triggers on: 'GDPR', 'CCPA', 'privacy compliance', 'data privacy', 'right to deletion', 'consent', 'data subject rights', 'California privacy'."}
+{"name":"git-workflow-manager","path":"subagents/categories/06-developer-experience/git-workflow-manager.md","category":"06-developer-experience","model":"haiku","description":"Use this agent when you need to design, establish, or optimize Git workflows, branching strategies, and merge management for a project or team."}
+{"name":"golang-pro","path":"subagents/categories/02-language-specialists/golang-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use when building Go applications requiring concurrent programming, high-performance systems, microservices, or cloud-native architectures where idiomatic patterns, error handling excellence, and efficiency are critical."}
+{"name":"graphql-architect","path":"subagents/categories/01-core-development/graphql-architect.md","category":"01-core-development","model":"opus","description":"Use this agent when designing or evolving GraphQL schemas across microservices, implementing federation architectures, or optimizing query performance in distributed graphs."}
+{"name":"growth-loops","path":"subagents/categories/08-business-product/growth-loops.md","category":"08-business-product","model":"sonnet","description":"Use when the user wants to design a growth loop, understand PLG mechanics, or build sustainable acquisition. Triggers on: 'growth loop', 'flywheel', 'viral loop', 'PLG growth', 'product-led growth', 'growth mechanics', 'how do we grow', 'word of mouth'."}
+{"name":"healthcare-admin","path":"subagents/categories/07-specialized-domains/healthcare-admin.md","category":"07-specialized-domains","model":"opus","description":"Use when working on healthcare administration tasks including revenue cycle management, HIPAA/compliance auditing, medical coding (ICD-10, CPT, DRGs), CMS cost reports, payer contract analysis, quality improvement, clinical operations, health IT/interoperability, population health, and pharmacy benefits."}
+{"name":"hipaa-compliance","path":"subagents/categories/07-specialized-domains/hipaa-compliance.md","category":"07-specialized-domains","model":"sonnet","description":"Use when the user is building a healthcare product and needs to understand HIPAA compliance. Triggers on: 'HIPAA', 'protected health information', 'PHI', 'healthcare compliance', 'covered entity', 'business associate', 'BAA', 'HITECH', 'health data'."}
+{"name":"incident-responder","path":"subagents/categories/03-infrastructure/incident-responder.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when an active security breach, service outage, or operational incident requires immediate response, evidence preservation, and coordinated recovery."}
+{"name":"iot-engineer","path":"subagents/categories/07-specialized-domains/iot-engineer.md","category":"07-specialized-domains","model":"sonnet","description":"Use when designing and deploying IoT solutions requiring expertise in device management, edge computing, cloud integration, and handling challenges like massive device scale, complex connectivity scenarios, or real-time data pipelines."}
+{"name":"it-ops-orchestrator","path":"subagents/categories/09-meta-orchestration/it-ops-orchestrator.md","category":"09-meta-orchestration","model":"sonnet","description":"Use for orchestrating complex IT operations tasks that span multiple domains (PowerShell automation, .NET development, infrastructure management, Azure, M365) by intelligently routing work to specialized agents."}
+{"name":"java-architect","path":"subagents/categories/02-language-specialists/java-architect.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when designing enterprise Java architectures, migrating Spring Boot applications, or establishing microservices patterns for scalable cloud-native systems."}
+{"name":"javascript-pro","path":"subagents/categories/02-language-specialists/javascript-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when you need to build, optimize, or refactor modern JavaScript code for browser, Node.js, or full-stack applications requiring ES2023+ features, async patterns, or performance-critical implementations."}
+{"name":"knowledge-synthesizer","path":"subagents/categories/09-meta-orchestration/knowledge-synthesizer.md","category":"09-meta-orchestration","model":"sonnet","description":"Use when you need to extract actionable patterns from agent interactions, synthesize insights across multiple workflows, and enable organizational learning from collective experience."}
+{"name":"kotlin-specialist","path":"subagents/categories/02-language-specialists/kotlin-specialist.md","category":"02-language-specialists","model":"sonnet","description":"Use when building Kotlin applications requiring advanced coroutine patterns, multiplatform code sharing, or Android/server-side development with functional programming principles."}
+{"name":"kubernetes-specialist","path":"subagents/categories/03-infrastructure/kubernetes-specialist.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when you need to design, deploy, configure, or troubleshoot Kubernetes clusters and workloads in production environments."}
+{"name":"laravel-specialist","path":"subagents/categories/02-language-specialists/laravel-specialist.md","category":"02-language-specialists","model":"sonnet","description":"Use when building Laravel 10+ applications, architecting Eloquent models with complex relationships, implementing queue systems for async processing, or optimizing API performance."}
+{"name":"legacy-modernizer","path":"subagents/categories/06-developer-experience/legacy-modernizer.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when modernizing legacy systems that need incremental migration strategies, technical debt reduction, and risk mitigation while maintaining business continuity."}
+{"name":"legal-advisor","path":"subagents/categories/08-business-product/legal-advisor.md","category":"08-business-product","model":"sonnet","description":"Use this agent when you need to draft contracts, review compliance requirements, develop IP protection strategies, or assess legal risks for technology businesses."}
+{"name":"license-engineer","path":"subagents/categories/08-business-product/license-engineer.md","category":"08-business-product","model":"opus","description":"Use this agent when architecting, implementing, or optimizing end-to-end legal licensing systems—from OSI standard selection and dependency compliance pipelines to proprietary deployment and risk monitoring."}
+{"name":"llm-architect","path":"subagents/categories/05-data-ai/llm-architect.md","category":"05-data-ai","model":"opus","description":"Use when designing LLM systems for production, implementing fine-tuning or RAG architectures, optimizing inference serving infrastructure, or managing multi-model deployments."}
+{"name":"m365-admin","path":"subagents/categories/07-specialized-domains/m365-admin.md","category":"07-specialized-domains","model":"sonnet","description":"Use when automating Microsoft 365 administrative tasks including Exchange Online mailbox provisioning, Teams collaboration management, SharePoint site configuration, license lifecycle management, and Graph API-driven identity automation."}
+{"name":"machine-learning-engineer","path":"subagents/categories/05-data-ai/machine-learning-engineer.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when you need to deploy, optimize, or serve machine learning models at scale in production environments."}
+{"name":"market-researcher","path":"subagents/categories/10-research-analysis/market-researcher.md","category":"10-research-analysis","model":"sonnet","description":"Use this agent when you need to analyze markets, understand consumer behavior, assess competitive landscapes, and size opportunities to inform business strategy and market entry decisions."}
+{"name":"mcp-developer","path":"subagents/categories/06-developer-experience/mcp-developer.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when you need to build, debug, or optimize Model Context Protocol (MCP) servers and clients that connect AI systems to external tools and data sources."}
+{"name":"microservices-architect","path":"subagents/categories/01-core-development/microservices-architect.md","category":"01-core-development","model":"opus","description":"Use when designing distributed system architecture, decomposing monolithic applications into independent microservices, or establishing communication patterns between services at scale."}
+{"name":"ml-engineer-cc","path":"subagents/categories/05-data-ai/ml-engineer-cc.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when building production ML systems requiring model training pipelines, model serving infrastructure, performance optimization, and automated retraining."}
+{"name":"mlops-engineer","path":"subagents/categories/05-data-ai/mlops-engineer.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when you need to design and implement ML infrastructure, set up CI/CD for machine learning models, establish model versioning systems, or optimize ML platforms for reliability and automation. Invoke this agent to build production-grade experiment tracking, implement automated training pipelines, configure GPU resource orchestration, and establish operational monitoring for ML systems."}
+{"name":"mobile-app-developer","path":"subagents/categories/07-specialized-domains/mobile-app-developer.md","category":"07-specialized-domains","model":"sonnet","description":"Use this agent when developing iOS and Android mobile applications with focus on native or cross-platform implementation, performance optimization, and platform-specific user experience."}
+{"name":"mobile-developer","path":"subagents/categories/01-core-development/mobile-developer.md","category":"01-core-development","model":"sonnet","description":"Use this agent when building cross-platform mobile applications requiring native performance optimization, platform-specific features, and offline-first architecture. Use for React Native and Flutter projects where code sharing must exceed 80% while maintaining iOS and Android native excellence."}
+{"name":"multi-agent-coordinator","path":"subagents/categories/09-meta-orchestration/multi-agent-coordinator.md","category":"09-meta-orchestration","model":"opus","description":"Use when coordinating multiple concurrent agents that need to communicate, share state, synchronize work, and handle distributed failures across a system."}
+{"name":"network-engineer","path":"subagents/categories/03-infrastructure/network-engineer.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when designing, optimizing, or troubleshooting cloud and hybrid network infrastructures, or when addressing network security, performance, or reliability challenges."}
+{"name":"nextjs-developer","path":"subagents/categories/02-language-specialists/nextjs-developer.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when building production Next.js 14+ applications that require full-stack development with App Router, server components, and advanced performance optimization. Invoke when you need to architect or implement complete Next.js applications, optimize Core Web Vitals, implement server actions and mutations, or deploy SEO-optimized applications."}
+{"name":"nlp-engineer","path":"subagents/categories/05-data-ai/nlp-engineer.md","category":"05-data-ai","model":"sonnet","description":"Use when building production NLP systems, implementing text processing pipelines, developing language models, or solving domain-specific NLP tasks like named entity recognition, sentiment analysis, or machine translation."}
+{"name":"node-specialist","path":"subagents/categories/02-language-specialists/node-specialist.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when you need to build, optimize, or debug Node.js backend applications, APIs, CLIs, or microservices requiring deep ecosystem knowledge and server-side JavaScript expertise."}
+{"name":"payment-integration","path":"subagents/categories/07-specialized-domains/payment-integration.md","category":"07-specialized-domains","model":"opus","description":"Use this agent when implementing payment systems, integrating payment gateways, or handling financial transactions that require PCI compliance, fraud prevention, and secure transaction processing."}
+{"name":"penetration-tester","path":"subagents/categories/04-quality-security/penetration-tester.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to conduct authorized security penetration tests to identify real vulnerabilities through active exploitation and validation. Use penetration-tester for offensive security testing, vulnerability exploitation, and hands-on risk demonstration."}
+{"name":"performance-engineer","path":"subagents/categories/04-quality-security/performance-engineer.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need to identify and eliminate performance bottlenecks in applications, databases, or infrastructure systems, and when baseline performance metrics need improvement."}
+{"name":"performance-monitor","path":"subagents/categories/09-meta-orchestration/performance-monitor.md","category":"09-meta-orchestration","model":"haiku","description":"Use when establishing observability infrastructure to track system metrics, detect performance anomalies, and optimize resource usage across multi-agent environments."}
+{"name":"php-pro","path":"subagents/categories/02-language-specialists/php-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when working with PHP 8.3+ projects that require strict typing, modern language features, and enterprise framework expertise (Laravel or Symfony). Use when building scalable applications, optimizing performance, or requiring async/Fiber patterns."}
+{"name":"platform-engineer-cc","path":"subagents/categories/03-infrastructure/platform-engineer-cc.md","category":"03-infrastructure","model":"opus","description":"Use when building or improving internal developer platforms (IDPs), designing self-service infrastructure, or optimizing developer workflows to reduce friction and accelerate delivery. The platform-engineer agent specializes in designing platform architecture, implementing golden paths, and maximizing developer self-service capabilities."}
+{"name":"postgres-pro","path":"subagents/categories/05-data-ai/postgres-pro.md","category":"05-data-ai","model":"sonnet","description":"Use when you need to optimize PostgreSQL performance, design high-availability replication, or troubleshoot database issues at scale. Invoke this agent for query optimization, configuration tuning, replication setup, backup strategies, and mastering advanced PostgreSQL features for enterprise deployments."}
+{"name":"powershell-51-expert","path":"subagents/categories/02-language-specialists/powershell-51-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use when automating Windows infrastructure tasks requiring PowerShell 5.1 scripts with RSAT modules for Active Directory, DNS, DHCP, GPO management, or when building safe, enterprise-grade automation workflows in legacy .NET Framework environments."}
+{"name":"powershell-7-expert","path":"subagents/categories/02-language-specialists/powershell-7-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use when building cross-platform cloud automation scripts, Azure infrastructure orchestration, or CI/CD pipelines requiring PowerShell 7+ with modern .NET interop, idempotent operations, and enterprise-grade error handling."}
+{"name":"powershell-module-architect","path":"subagents/categories/06-developer-experience/powershell-module-architect.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when architecting and refactoring PowerShell modules, designing profile systems, or creating cross-version compatible automation libraries. Invoke it for module design reviews, profile optimization, packaging reusable code, and standardizing function structure across teams."}
+{"name":"powershell-security-hardening","path":"subagents/categories/04-quality-security/powershell-security-hardening.md","category":"04-quality-security","model":"opus","description":"Use this agent when you need to harden PowerShell automation, secure remoting configuration, enforce least-privilege design, or align scripts with enterprise security baselines and compliance frameworks."}
+{"name":"powershell-ui-architect","path":"subagents/categories/06-developer-experience/powershell-ui-architect.md","category":"06-developer-experience","model":"sonnet","description":"Use when designing or building desktop graphical interfaces (WinForms, WPF, Metro-style dashboards) or terminal user interfaces (TUIs) for PowerShell automation tools that need clean separation between UI and business logic."}
+{"name":"product-manager-cc","path":"subagents/categories/08-business-product/product-manager-cc.md","category":"08-business-product","model":"haiku","description":"Use this agent when you need to make product strategy decisions, prioritize features, or define roadmap plans based on user needs and business goals."}
+{"name":"project-idea-validator","path":"subagents/categories/10-research-analysis/project-idea-validator.md","category":"10-research-analysis","model":"sonnet","description":"Use this agent when you need an idea pressure-tested with brutal honesty, competitor teardown, market validation, and clear go/no-go guidance before building."}
+{"name":"project-manager","path":"subagents/categories/08-business-product/project-manager.md","category":"08-business-product","model":"haiku","description":"Use this agent when you need to establish project plans, track execution progress, manage risks, control budget/schedule, and coordinate stakeholders across complex initiatives."}
+{"name":"prompt-engineer-cc","path":"subagents/categories/05-data-ai/prompt-engineer-cc.md","category":"05-data-ai","model":"sonnet","description":"Use this agent when you need to design, optimize, test, or evaluate prompts for large language models in production systems."}
+{"name":"python-pro","path":"subagents/categories/02-language-specialists/python-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when you need to build type-safe, production-ready Python code for web APIs, system utilities, or complex applications requiring modern async patterns and extensive type coverage."}
+{"name":"qa-expert","path":"subagents/categories/04-quality-security/qa-expert.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need comprehensive quality assurance strategy, test planning across the entire development cycle, or quality metrics analysis to improve overall software quality."}
+{"name":"quant-analyst","path":"subagents/categories/07-specialized-domains/quant-analyst.md","category":"07-specialized-domains","model":"opus","description":"Use this agent when you need to develop quantitative trading strategies, build financial models with rigorous mathematical foundations, or conduct advanced risk analytics for derivatives and portfolios. Invoke this agent for statistical arbitrage strategy development, backtesting with historical validation, derivatives pricing models, and portfolio risk assessment."}
+{"name":"rails-expert","path":"subagents/categories/02-language-specialists/rails-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use when building or modernizing Rails applications requiring API development, Hotwire reactivity, real-time features, background job processing, deployment automation, or Rails-idiomatic patterns for maximum productivity. Version-aware: adapts to Rails 7.x and 8.x projects."}
+{"name":"react-specialist-cc","path":"subagents/categories/02-language-specialists/react-specialist-cc.md","category":"02-language-specialists","model":"sonnet","description":"Use when optimizing existing React applications for performance, implementing advanced React 18+ features, or solving complex state management and architectural challenges within React codebases."}
+{"name":"readme-generator","path":"subagents/categories/06-developer-experience/readme-generator.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when you need a maintainer-ready README built from exact repository reality, with deep codebase scanning, zero hallucination, and optional git commit/push only when explicitly requested."}
+{"name":"refactoring-specialist","path":"subagents/categories/06-developer-experience/refactoring-specialist.md","category":"06-developer-experience","model":"sonnet","description":"Use when you need to transform poorly structured, complex, or duplicated code into clean, maintainable systems while preserving all existing behavior."}
+{"name":"reinforcement-learning-engineer","path":"subagents/categories/05-data-ai/reinforcement-learning-engineer.md","category":"05-data-ai","model":"sonnet","description":"Use when designing RL environments, training agents with reward optimization, implementing policy gradient methods, or deploying decision-making systems for robotics, gaming, and autonomous operations."}
+{"name":"research-analyst","path":"subagents/categories/10-research-analysis/research-analyst.md","category":"10-research-analysis","model":"sonnet","description":"Use this agent when you need comprehensive research across multiple sources with synthesis of findings into actionable insights, trend identification, and detailed reporting."}
+{"name":"risk-manager","path":"subagents/categories/07-specialized-domains/risk-manager.md","category":"07-specialized-domains","model":"opus","description":"Use this agent when you need to identify, quantify, and mitigate enterprise-level risks across financial, operational, regulatory, and strategic domains. Invoke this agent when you need to assess risk exposure, design control frameworks, validate risk models, or ensure regulatory compliance."}
+{"name":"rust-engineer","path":"subagents/categories/02-language-specialists/rust-engineer.md","category":"02-language-specialists","model":"sonnet","description":"Use when building Rust systems where memory safety, ownership patterns, zero-cost abstractions, and performance optimization are critical for systems programming, embedded development, async applications, or high-performance services."}
+{"name":"sales-engineer","path":"subagents/categories/08-business-product/sales-engineer.md","category":"08-business-product","model":"sonnet","description":"Use this agent when you need to conduct technical pre-sales activities including solution architecture, proof-of-concept development, and technical demonstrations for complex sales deals."}
+{"name":"scientific-literature-researcher","path":"subagents/categories/10-research-analysis/scientific-literature-researcher.md","category":"10-research-analysis","model":"sonnet","description":"Use when you need to search scientific literature and retrieve structured experimental data from published studies. Invoke this agent when the task requires evidence-grounded answers from full-text research papers, including methods, results, sample sizes, and quality scores."}
+{"name":"scrum-master","path":"subagents/categories/08-business-product/scrum-master.md","category":"08-business-product","model":"haiku","description":"Use when teams need facilitation, process optimization, velocity improvement, or agile ceremony management—especially for sprint planning, retrospectives, impediment removal, and scaling agile practices across multiple teams."}
+{"name":"search-specialist","path":"subagents/categories/10-research-analysis/search-specialist.md","category":"10-research-analysis","model":"sonnet","description":"Use when you need to find specific information across multiple sources using advanced search strategies, query optimization, and targeted information retrieval. Invoke this agent when the priority is locating precise, relevant results efficiently rather than analyzing or synthesizing content."}
+{"name":"security-auditor","path":"subagents/categories/04-quality-security/security-auditor.md","category":"04-quality-security","model":"opus","description":"Use this agent when conducting comprehensive security audits, compliance assessments, or risk evaluations across systems, infrastructure, and processes. Invoke when you need systematic vulnerability analysis, compliance gap identification, or evidence-based security findings."}
+{"name":"security-engineer","path":"subagents/categories/03-infrastructure/security-engineer.md","category":"03-infrastructure","model":"opus","description":"Use this agent when implementing comprehensive security solutions across infrastructure, building automated security controls into CI/CD pipelines, or establishing compliance and vulnerability management programs. Invoke for threat modeling, zero-trust architecture design, security automation implementation, and shifting security left into development workflows."}
+{"name":"seo-specialist-cc","path":"subagents/categories/07-specialized-domains/seo-specialist-cc.md","category":"07-specialized-domains","model":"haiku","description":"Use this agent when you need comprehensive SEO optimization encompassing technical audits, keyword strategy, content optimization, and search rankings improvement."}
+{"name":"slack-expert","path":"subagents/categories/06-developer-experience/slack-expert.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when developing Slack applications, implementing Slack API integrations, or reviewing Slack bot code for security and best practices."}
+{"name":"spring-boot-engineer","path":"subagents/categories/02-language-specialists/spring-boot-engineer.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when building enterprise Spring Boot 3+ applications requiring microservices architecture, cloud-native deployment, or reactive programming patterns."}
+{"name":"sql-pro","path":"subagents/categories/02-language-specialists/sql-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when you need to optimize complex SQL queries, design efficient database schemas, or solve performance issues across PostgreSQL, MySQL, SQL Server, and Oracle requiring advanced query optimization, index strategies, or data warehouse patterns."}
+{"name":"sre-engineer","path":"subagents/categories/03-infrastructure/sre-engineer.md","category":"03-infrastructure","model":"sonnet","description":"Use this agent when you need to establish or improve system reliability through SLO definition, error budget management, and automation. Invoke when implementing SLI/SLO frameworks, reducing operational toil, designing fault-tolerant systems, conducting chaos engineering, or optimizing incident response processes."}
+{"name":"swift-expert","path":"subagents/categories/02-language-specialists/swift-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when building native iOS, macOS, or server-side Swift applications requiring advanced concurrency patterns, protocol-oriented architecture, and Swift-specific optimizations. Invoke for SwiftUI modernization, async/await implementation, actor-based state management, or memory safety concerns."}
+{"name":"symfony-specialist","path":"subagents/categories/02-language-specialists/symfony-specialist.md","category":"02-language-specialists","model":"sonnet","description":"Use when building Symfony 6+/7+/8+ applications, architecting Doctrine ORM entities with complex relationships, implementing Messenger component for async processing, or optimizing API Platform performance."}
+{"name":"task-distributor","path":"subagents/categories/09-meta-orchestration/task-distributor.md","category":"09-meta-orchestration","model":"haiku","description":"Use when distributing tasks across multiple agents or workers, managing queues, and balancing workloads to maximize throughput while respecting priorities and deadlines."}
+{"name":"technical-writer","path":"subagents/categories/08-business-product/technical-writer.md","category":"08-business-product","model":"haiku","description":"Use this agent when you need to create, improve, or maintain technical documentation including API references, user guides, SDK documentation, and getting-started guides."}
+{"name":"terraform-engineer","path":"subagents/categories/03-infrastructure/terraform-engineer.md","category":"03-infrastructure","model":"sonnet","description":"Use when building, refactoring, or scaling infrastructure as code using Terraform with focus on multi-cloud deployments, module architecture, and enterprise-grade state management."}
+{"name":"terragrunt-expert","path":"subagents/categories/03-infrastructure/terragrunt-expert.md","category":"03-infrastructure","model":"sonnet","description":"Expert Terragrunt specialist mastering infrastructure orchestration, DRY configurations, and multi-environment deployments. Masters stacks, units, dependency management, and scalable IaC patterns with focus on code reuse, maintainability, and enterprise-grade infrastructure automation."}
+{"name":"test-automator","path":"subagents/categories/04-quality-security/test-automator.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need to build, implement, or enhance automated test frameworks, create test scripts, or integrate testing into CI/CD pipelines."}
+{"name":"tooling-engineer","path":"subagents/categories/06-developer-experience/tooling-engineer.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when you need to build or enhance developer tools including CLIs, code generators, build tools, and IDE extensions."}
+{"name":"trend-analyst","path":"subagents/categories/10-research-analysis/trend-analyst.md","category":"10-research-analysis","model":"sonnet","description":"Use when analyzing emerging patterns, predicting industry shifts, or developing future scenarios to inform strategic planning and competitive positioning."}
+{"name":"typescript-pro","path":"subagents/categories/02-language-specialists/typescript-pro.md","category":"02-language-specialists","model":"sonnet","description":"Use when implementing TypeScript code requiring advanced type system patterns, complex generics, type-level programming, or end-to-end type safety across full-stack applications."}
+{"name":"ui-designer","path":"subagents/categories/01-core-development/ui-designer.md","category":"01-core-development","model":"sonnet","description":"Use this agent when designing visual interfaces, creating design systems, building component libraries, or refining user-facing aesthetics requiring expert visual design, interaction patterns, and accessibility considerations."}
+{"name":"ui-ux-tester","path":"subagents/categories/04-quality-security/ui-ux-tester.md","category":"04-quality-security","model":"sonnet","description":"Use this agent when you need exhaustive UI and UX functionality testing driven by documented user flows, with browser or desktop interaction tooling and structured defect reporting."}
+{"name":"ux-researcher","path":"subagents/categories/08-business-product/ux-researcher.md","category":"08-business-product","model":"sonnet","description":"Use this agent when you need to conduct user research, analyze user behavior, or generate actionable insights to validate design decisions and uncover user needs. Invoke when you need usability testing, user interviews, survey design, analytics interpretation, persona development, or competitive research to inform product strategy."}
+{"name":"visual-asset-generator","path":"subagents/categories/06-developer-experience/visual-asset-generator.md","category":"06-developer-experience","model":"sonnet","description":"Use this agent when you need to generate production-ready visual assets for a project — app icons, favicons, OG images, logos, wordmarks, or social media images. Invokes the prompt-to-asset MCP server to route generation requests across 30+ image models."}
+{"name":"vue-expert","path":"subagents/categories/02-language-specialists/vue-expert.md","category":"02-language-specialists","model":"sonnet","description":"Use this agent when building Vue 3 applications that require Composition API mastery, reactivity optimization, or Nuxt 3 development with enterprise-scale performance concerns."}
+{"name":"websocket-engineer","path":"subagents/categories/01-core-development/websocket-engineer.md","category":"01-core-development","model":"sonnet","description":"Use this agent when implementing real-time bidirectional communication features using WebSockets, Socket.IO, or similar technologies at scale."}
+{"name":"windows-infra-admin","path":"subagents/categories/03-infrastructure/windows-infra-admin.md","category":"03-infrastructure","model":"sonnet","description":"Use when managing Windows Server infrastructure, Active Directory, DNS, DHCP, and Group Policy configurations, especially for enterprise-scale deployments requiring safe automation and compliance validation."}
+{"name":"wordpress-master","path":"subagents/categories/08-business-product/wordpress-master.md","category":"08-business-product","model":"sonnet","description":"Use this agent when you need to architect, optimize, or troubleshoot WordPress implementations ranging from custom theme/plugin development to enterprise-scale multisite platforms. Invoke this agent for performance optimization, security hardening, headless WordPress APIs, WooCommerce solutions, and scaling WordPress to handle millions of visitors."}
+{"name":"workflow-orchestrator","path":"subagents/categories/09-meta-orchestration/workflow-orchestrator.md","category":"09-meta-orchestration","model":"opus","description":"Use this agent when you need to design, implement, or optimize complex business process workflows with multiple states, error handling, and transaction management."}

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # Changelog
 
+## [11.3.0] - 2026-06-04 — "Legion" (154-subagent expansion)
+
+Imports the full VoltAgent `awesome-claude-code-subagents` collection (154 Claude-Code-native
+subagents across 10 categories) into MindForge, fully rebranded. Additive and
+backward-compatible — no existing persona, skill, or command changed behavior.
+
+### Added
+
+- **`subagents/` tree** — 154 specialized subagent definitions in 10 categories
+  (`01-core-development` … `10-research-analysis`), kept verbatim from upstream except
+  the rebrand and collision/functional fixes below. Agent bodies are unmodified prose.
+- **`.mindforge/imported-agents.jsonl`** — generated index (name → path → category → model →
+  description) and **`scripts/build-subagent-index.js`** to regenerate it deterministically.
+- **`bin/spawn-agent.js subagent <name>`** — third loader mode that resolves an imported
+  subagent via the index. Hardened with a strict name allowlist (`[A-Za-z0-9-_]`), exact
+  index-match resolution (never builds a path from input), and a `subagents/` containment
+  check — defense-in-depth path-traversal guards consistent with `BLOCK_ON_SECURITY`.
+- **Installer delivery** — `bin/installer-core.js` now installs the 154 subagents into the
+  runtime's native agents directory (`.claude/agents/`, via the new `agentsSubdir` runtime
+  config + `installSubagents()`), flattening the category tree (READMEs excluded) so Claude
+  Code auto-discovers them. Runs for both global and local scope; mirrored to `.claude/agents/`
+  for non-claude local runtimes. Shown in `--dry-run` and the payload manifest; `--uninstall`
+  removes only the imported set, never the user's own agents. The `.mindforge/imported-agents.jsonl`
+  index ships with `.mindforge/`, so the `subagent` loader mode also works post-install.
+- **`tests/subagent-import.test.js`** — asserts 154 indexed, every path exists, all 16
+  collisions renamed, no bare-name clash with personas, and the loader's traversal guards.
+
+### Changed (rebrand — VoltAgent → MindForge)
+
+- Plugin/marketplace metadata (`subagents/.claude-plugin/marketplace.json` + 10 category
+  `plugin.json`) renamed `voltagent-*` → `mindforge-*`, author → MindForge Team, URLs →
+  `github.com/sairam0424/MindForge`. Per-plugin versions preserved for upstream re-sync.
+  No live marketplace is published — metadata only.
+- 16 name collisions with existing hand-authored MindForge personas resolved with a `-cc`
+  suffix (`api-designer-cc`, `debugger-cc`, …); the original personas remain authoritative
+  for the bare names.
+- **agent-installer** fetch URLs repointed to `sairam0424/MindForge` under `subagents/`.
+- **design-bridge** VoltAgent design-md dependency replaced with a `<DESIGN_MD_SOURCE>`
+  placeholder + a needs-configuration notice (MindForge ships no design-md repo yet).
+- Dead VoltAgent Discord/sponsor links removed (no MindForge equivalent).
+- `package.json` `files` allowlist now ships `subagents/` + the index; README capability
+  line notes the 154 subagents.
+
+## [11.2.1] - 2026-05-31 — "Hardening" (security & integrity audit remediation)
+
+Post-v11.2.0 audit remediation. Closes every exploitable security defect and
+false-assurance stub surfaced by the end-to-end audit. No new features, no
+breaking changes — fixes and honest-labeling only.
+
+### Security (fixed)
+
+- **trust-gate-hook**: scans the whole command + every line (a benign first line could previously cloak a destructive later line)
+- **orbital-guardian**: `verify()` re-checks the Ed25519 attestation signature (added `did`/`signed_message` columns + migration); rejects forged APPROVED rows
+- **policy-engine**: `reasoning_proof` alone no longer bypasses the blast-radius limit (`isProofValid` inits false; cryptographic `pq_proof` path unchanged)
+- **shadow-mirror**: git calls use `execFileSync` (argv) + fail-closed `sanitizeRemediationId()` — closes command injection via `remediation_id`
+- **trust-boundaries `isHighImpact`**: added chmod/chown/dd/mv/kill/shutdown/eval/command-substitution/redirect detection + shell-obfuscation normalization; narrowed interpreter-script pattern to stop false-positives on `node <projectfile>`
+- **eis-client**: `verifyRemoteProvenance` delegates to real ZTAI signature verification, fail-closed (was returning true for any non-empty signature)
+
+### Integrity / honest labeling (fixed)
+
+- **ztai-archiver**: `verifyIntegrity()` recomputes the Merkle root from the live log (was a no-op `return true`); fail-closed on tamper/delete/reorder
+- **mesh-self-healer**: emits an honest degraded advisory instead of fabricated 94%/100% consensus
+- **logic-validator**: probes Ollama when reachable, honest heuristic fallback; stopped advertising the dead model path
+- **reason-source-aligner**: consistent return shape (uninitialized no longer silently disables the mission-fidelity gate); real Jaccard similarity
+- **sre-manager**: HMAC artifact relabeled as integrity tag, not "ZK-Proof"
+- **installer-core**: PQAS-enabled message gated on the real `experimental.pqc_demo` flag
+- **finding-synthesizer**: detects real severity-gap contradictions (was hardcoded `[]`)
+- **logic-drift-detector**: relabeled heuristic, not "Neural"
+- **session-manager / shadow-mirror(docker) / regression-writer / skill-registry**: honest disclosure instead of silent empties / fake isolation / tautological tests / mock placeholders
+- **MINDFORGE.md**: `[PQAS_ENFORCED]` reconciled to reflect simulated/inactive default; **ztai-manager** logs relabeled `[ZTAI-HSM-SIM]`
+
+### CI / hygiene
+
+- **release workflow**: asserts the git tag matches `package.json` version (fail-closed) + skips publish if the version is already on npm
+- **version-check**: runtime drift check widened to all 4 sources (was 2); SDK README guarded by test
+- removed dead `AuditRotator` class (CHANGELOG had wrongly claimed it removed); deprecated orphaned `createAppendQueue`
+- refreshed stale `v11.1.0` banners → current; added `cost_routing.shadow_mode` latch
+- version bumped to 11.2.1 across all sources
+
 ## [11.2.0] - 2026-05-31 — "Verification & Trust"
 
 ### Added
@@ -28,7 +107,7 @@
 ### Removed
 
 - Dead `quantum-verify` CLI command entry (no handler existed)
-- Dead `AuditRotator` references (broke hash chain on rotation boundaries)
+- Dead `AuditRotator` class and its export from `bin/utils/file-io.js` (zero callers; rotation broke the hash chain at rotation boundaries — see `bin/autonomous/audit-writer.js`)
 
 ### Changed
 

package/MINDFORGE.md

@@ -1,12 +1,12 @@
-# MINDFORGE.md — Parameter Registry (v11.2.0)
+# MINDFORGE.md — Parameter Registry (v11.3.0)
 
 ## 1. IDENTITY & VERSIONING
 
 [NAME]    = MindForge
-[VERSION] = 11.2.0
+[VERSION] = 11.3.0
 [STABLE]  = true
 [MODE]    = "Platform Sovereign"
-[REQUIRED_CORE_VERSION] = 11.2.0
+[REQUIRED_CORE_VERSION] = 11.3.0
 [SOVEREIGN_IDENTITY] = true
 [SRE_LAYER_ENABLED]  = true
 
@@ -26,7 +26,7 @@
 [ZTAI_KEY_TYPE] = "Dilithium-5"
 [NEXUS_TRACE_RETENTION_DAYS] = 30
 [CADIA_CORE] = true
-[PQAS_ENFORCED] = true
+[PQAS_ENFORCED] = false  # PQAS is SIMULATED/inactive by default (config: pqas_enabled=false, gated behind experimental.pqc_demo). Tier-3 trust uses real Ed25519. See .mindforge/config.json + bin/governance/quantum-crypto.js.
 [PROACTIVE_HOMING] = true
 
 ---
@@ -100,6 +100,6 @@ The following parameters cannot be overridden by plugins, agents, or session-lev
 - [MIN_SOUL_SCORE] — Minimum SOUL score required for architectural changes
 - [BLOCK_ON_SECURITY] — Security gate enforcement cannot be disabled
 - [COST_HARD_LIMIT_USD] — Hard cost limit cannot be raised without human approval
-- [PQAS_ENFORCED] — Post-quantum security cannot be disabled
+- [BLOCK_ON_SECURITY] is non-overridable; PQAS itself is simulated/experimental (inactive by default) and is NOT a non-overridable guarantee — do not rely on it as an enforced control
 - [SOVEREIGN_IDENTITY] — Identity verification is always required
 - [ENABLE_ZTAI] — Zero-trust identity cannot be bypassed

package/README.md

@@ -15,7 +15,7 @@ MindForge v11.0.0 "Sovereign Stability" is a production-hardening release focuse
 - **Production observability** — `/api/v1/system` health endpoint, P95 latency tracking, heap health monitoring, and real EIS client with retry logic.
 - **Graduated intelligence** — Adaptive tier escalation (+1/+2/MAX) with cost-awareness, 3-tier stuck detection, and adaptive context windows.
 
-This release ships 200+ skills, 400+ personas, 18 pillars, and 49 swarm templates across 12 engineering domains.
+This release ships 200+ skills, 400+ personas, 154 specialized subagents, 18 pillars, and 49 swarm templates across 12 engineering domains.
 
 
 ## Installation & Setup

package/bin/autonomous/mesh-self-healer.js

@@ -1,10 +1,18 @@
 /**
  * MindForge v7 — Proactive Semantic Homing (Pillar XII)
  * Mesh Self-Healer: Peer agents "home in" on drifting nodes to provide collaborative reasoning.
+ *
+ * UC-22 (audit finding #16) — HONEST LABELLING:
+ * There is no live, runtime peer-reasoning mesh in this build. Previously this
+ * module FABRICATED a collective consensus (hardcoded peers, canned
+ * confidence:94, "100% agreement" log). That emitted false assurance on the
+ * live auto-runner self-heal path. It now consults the ONLY real peer source
+ * available — the ztai-manager session-agent registry — and, when that yields
+ * no real peers (the common case at runtime), degrades GRACEFULLY to a clearly
+ * labelled single-source advisory with NO fabricated confidence or consensus.
  */
 'use strict';
 
-const fs = require('node:fs');
 const path = require('node:path');
 
 class MeshSelfHealer {
@@ -14,52 +22,117 @@ class MeshSelfHealer {
 
   /**
    * Peer agents "home in" on a node with high logic drift.
+   *
+   * @param {string} driftingAgentDid - DID of the drifting node.
+   * @param {number} driftScore - Logic-drift score (only acts on >= 80).
+   * @param {object} [options] - { sessionId } to scope the real peer lookup.
+   * @returns {Promise<object|null>} Honest advisory object, or null below threshold.
    */
-  async homeIn(driftingAgentDid, driftScore) {
+  async homeIn(driftingAgentDid, driftScore, options = {}) {
     if (driftScore < 80) return null; // Only home in on major drift
-    
-    console.log(`[HOMING-HEAL] Global Mesh Alert: Agent ${driftingAgentDid} experiencing critical logic drift (${driftScore}). Peer agents redirecting...`);
-    
-    // Find nearby idle agents or specialists
-    const peers = this.findAvailablePeers(driftingAgentDid);
-    const healingNodes = [];
 
+    console.log(`[HOMING-HEAL] Global Mesh Alert: Agent ${driftingAgentDid} experiencing critical logic drift (${driftScore}). Seeking peer reasoning support...`);
+
+    // Consult the only REAL peer source: the ztai-manager session registry.
+    // Returns an empty array when no live peers are registered.
+    const peers = this.findAvailablePeers(driftingAgentDid, options.sessionId);
+
+    if (peers.length === 0) {
+      return this.degradedAdvisory(driftingAgentDid);
+    }
+
+    const healingNodes = [];
     for (const peer of peers) {
-      console.log(`[HOMING-HEAL] Agent ${peer.did} homing in on ${driftingAgentDid} to provide collective reasoning support.`);
+      console.log(`[HOMING-HEAL] Peer ${peer.did} homing in on ${driftingAgentDid} to provide reasoning support.`);
       const supportTrace = await this.provideCollectiveReasoning(peer, driftingAgentDid);
       healingNodes.push(supportTrace);
     }
 
-    return this.reconcileReasoning(healingNodes);
+    return this.reconcileReasoning(healingNodes, driftingAgentDid);
+  }
+
+  /**
+   * Discovers REAL peer agents from the live registry. There are no invented
+   * peers — if nothing is registered for the session, this returns []
+   * and the caller degrades honestly.
+   *
+   * @param {string} driftingAgentDid - The node being healed (excluded from peers).
+   * @param {string|null} sessionId - Session scope for the registry lookup.
+   * @returns {Array<{did:string, persona?:string}>} Real peers (possibly empty).
+   */
+  findAvailablePeers(driftingAgentDid, sessionId = null) {
+    let agents = [];
+    try {
+      // Lazy require to avoid a hard coupling / load cost on the cold path.
+      const ztaiManager = require('../governance/ztai-manager');
+      if (typeof ztaiManager.getSessionAgents === 'function') {
+        agents = ztaiManager.getSessionAgents(sessionId) || [];
+      }
+    } catch {
+      // No registry available — treat as no live peers (honest degraded mode).
+      agents = [];
+    }
+
+    // Exclude the drifting node itself; only real, distinct peers may help.
+    return agents.filter(a => a && a.did && a.did !== driftingAgentDid);
   }
 
-  findAvailablePeers(driftingAgentDid) {
-    // Simulated peer discovery
-    return [
-      { did: 'did:mindforge:peer-1-specialist', name: 'Refactor Specialist' },
-      { did: 'did:mindforge:peer-2-architect', name: 'Security Architect' }
-    ];
+  /**
+   * Honest single-source advisory used when no live peer mesh is available.
+   * Carries NO fabricated confidence and makes NO consensus claim.
+   *
+   * @param {string} driftingAgentDid
+   * @returns {object}
+   */
+  degradedAdvisory(driftingAgentDid) {
+    console.log('[HOMING-HEAL] No live peer mesh available — emitting single-source advisory (degraded).');
+
+    return {
+      type: 'advisory',
+      mesh_available: false,
+      degraded: true,
+      confidence: null,
+      consensus: null,
+      target: driftingAgentDid,
+      recommendation: 'Heuristic single-source steering: pause the drifting node, re-anchor to the last verified plan/spec, and require human or higher-tier review before resuming. No multi-agent consensus was available to corroborate this.',
+      source: 'Mesh-Self-Healing (degraded: no live peers)'
+    };
   }
 
   async provideCollectiveReasoning(peer, target) {
-    // Peer agent provides a second opinion/reasoning node
+    // A real peer contributes a reasoning node. Confidence is left null here:
+    // this build has no model-backed scoring, so we do not invent a number.
     return {
       provider: peer.did,
-      target: target,
-      reasoning: 'Recommended steering for drift recovery based on Mesh-State: Re-syncing with Sovereign-Reason-Enclave.',
-      confidence: 94
+      target,
+      reasoning: 'Peer steering note: re-sync drifting node with the last verified plan state.',
+      confidence: null
     };
   }
 
-  reconcileReasoning(nodes) {
-    // Merge peer reasoning nodes into a single corrective steering vector
-    const consensus = nodes[0].reasoning; // Mock consensus
-    console.log('[HOMING-HEAL] Collective reasoning consensus acheived: 100% agreement on recovery vector.');
-    
+  /**
+   * Reconciles multiple REAL peer reasoning nodes. With live peers present we
+   * report how many corroborated, but we still never invent a confidence score
+   * or a "100% agreement" claim.
+   *
+   * @param {Array<object>} nodes - Real peer reasoning contributions.
+   * @param {string} driftingAgentDid
+   * @returns {object}
+   */
+  reconcileReasoning(nodes, driftingAgentDid) {
+    const peerCount = nodes.length;
+    console.log(`[HOMING-HEAL] Collective reasoning gathered from ${peerCount} live peer(s); no confidence fabricated.`);
+
     return {
-      type: 'collective_repair',
-      consensus,
-      source: 'Mesh-Self-Healing'
+      type: 'advisory',
+      mesh_available: true,
+      degraded: false,
+      confidence: null, // No model-backed scoring in this build — stay honest.
+      consensus: nodes[0].reasoning,
+      peer_count: peerCount,
+      target: driftingAgentDid,
+      recommendation: nodes[0].reasoning,
+      source: `Mesh-Self-Healing (${peerCount} live peer(s))`
     };
   }
 }