mindforge-cc 11.2.1 → 11.3.1

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/.mindforge/integrations/confluence.md

@@ -0,0 +1,27 @@
+# MindForge — Confluence Integration
+
+## Purpose
+Publish architecture snapshots, ADRs, and milestone/phase documentation to a
+ shared wiki without making Confluence the execution source of truth.
+
+## Published artifacts
+
+| MindForge artifact | Confluence target |
+|---|---|
+| `.planning/ARCHITECTURE.md` | Architecture overview page |
+| `.planning/decisions/ADR-*.md` | ADR child pages |
+| Phase verification summaries | Sprint or phase pages |
+| Milestone reports | Release or program pages |
+
+## Publishing rules
+Use update-by-title or update-by-page-ID so repeated publishes are idempotent.
+Do not create duplicate pages on re-run. If the target exists, update in place
+ and preserve the page history.
+
+## Data safety
+Confluence publishing must exclude secrets, tokens, raw audit log content, and
+ internal-only approver notes. Publish curated summaries, not raw machine state.
+
+## Failure handling
+Publishing failures are non-fatal. Log them, append a pending manual action to
+ `.planning/STATE.md`, and provide a retry command via `/mindforge:sync-confluence`.

package/.mindforge/integrations/connection-manager.md

@@ -0,0 +1,163 @@
+# MindForge Integrations — Connection Manager
+
+## Purpose
+Centralise credential handling, integration detection, health checks, retry policy,
+ and non-fatal failure handling for all external systems. Integrations consume
+ connection state from this layer; they do not manage secrets directly.
+
+## Credential storage principles
+
+### Rule 1 — Never store credentials in MindForge files
+MindForge configuration files may store base URLs, project IDs, channel IDs,
+ reviewer lists, and feature flags. They must never contain API tokens,
+ passwords, private keys, cookies, or session secrets.
+
+### Rule 2 — Use environment variables or an external secrets manager
+Supported variables:
+
+```bash
+# Jira
+JIRA_BASE_URL=https://your-org.atlassian.net
+JIRA_USER_EMAIL=engineer@your-org.com
+JIRA_API_TOKEN=stored-in-environment-only
+
+# Confluence
+CONFLUENCE_BASE_URL=https://your-org.atlassian.net/wiki
+CONFLUENCE_API_TOKEN=stored-in-environment-only
+
+# Slack
+SLACK_BOT_TOKEN=stored-in-environment-only
+SLACK_WEBHOOK_URL=stored-in-environment-only
+SLACK_CHANNEL_ID=C01234ABCDE
+
+# GitHub / GitLab
+GITHUB_TOKEN=stored-in-environment-only
+GITLAB_TOKEN=stored-in-environment-only
+```
+
+### Rule 3 — Audit only non-sensitive metadata
+AUDIT entries may contain integration name, action, status, external IDs,
+ attempt counts, and error classes. Never log raw headers, raw response bodies
+ containing secrets, or token values.
+
+## Availability detection protocol
+
+1. Check required environment variables exist.
+2. Read `.mindforge/org/integrations/INTEGRATIONS-CONFIG.md` for required
+   non-sensitive settings.
+3. Run one lightweight health check per integration.
+4. Return one of these states:
+
+| State | Meaning | Behaviour |
+|---|---|---|
+| `available` | Credentials present and health check passed | Proceed |
+| `unconfigured` | Credentials missing | Skip, log AUDIT |
+| `invalid_credentials` | Auth failed with 401/403 | Warn, log AUDIT, stop retries |
+| `unreachable` | DNS, timeout, or 5xx | Retry up to policy, then warn |
+| `rate_limited` | 429 | Respect `Retry-After`, retry once, then stop |
+
+Missing credentials are usually a graceful skip. Exception: if a CRITICAL
+ security finding notification cannot be delivered because Slack is unconfigured,
+ write an `Undelivered alerts` section to `.planning/STATE.md` and surface it in
+ `/mindforge:status`.
+
+## Credential hygiene in shell operations
+
+### Preventing token exposure in shell history
+Avoid inline command substitution with secrets. Prefer a function or a temporary
+ client-supported credential source:
+
+```bash
+build_auth_header() {
+  printf '%s' "${1}:${2}" | base64
+}
+AUTH_HEADER=$(build_auth_header "${JIRA_USER_EMAIL}" "${JIRA_API_TOKEN}")
+```
+
+Unset secrets after the command sequence completes:
+
+```bash
+unset JIRA_API_TOKEN
+unset GITHUB_TOKEN
+unset SLACK_BOT_TOKEN
+```
+
+### Debug mode prohibition
+Never run credential-bearing commands with shell tracing enabled:
+
+```bash
+set +x
+# credential operations
+```
+
+If debugging is needed elsewhere, disable tracing before any command that
+ includes an Authorization header or secret-bearing environment variable.
+
+### curl verbose mode prohibition
+Never use `curl -v` or `curl --verbose` with authenticated requests. Capture the
+ HTTP status code with `-s -o response.json -w "%{http_code}"` and log only
+ sanitised error summaries.
+
+## Health check examples
+
+### Jira
+```bash
+HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
+  -H "Authorization: Basic ${AUTH_HEADER}" \
+  "${JIRA_BASE_URL}/rest/api/3/myself")
+```
+
+### Slack
+Use `auth.test`. If the configured `SLACK_CHANNEL_ID` returns `channel_not_found`
+ or a 404-equivalent API error, mark the channel configuration invalid and tell
+ the user to update `INTEGRATIONS-CONFIG.md`.
+
+### GitHub
+Use `GET /user` with the token. A 404 from branch protection lookup later is not
+ a connection error; it means no branch protection is configured.
+
+## Credential rotation detection
+If a previously available integration now returns 401/403:
+
+1. Write AUDIT entry: `integration_credential_expired`
+2. Warn the user to rotate the relevant credential
+3. Do not retry with the expired credential
+
+## Integration resilience: shared patterns for all integrations
+
+### Non-fatal integration failures
+Integration failures must never fail the underlying source-code task. They are
+ non-fatal unless a compliance gate or required approval is blocked.
+
+### Retry policy
+
+| Attempt | Delay |
+|---|---|
+| 1 | immediate |
+| 2 | 5 seconds |
+| 3 | 20 seconds |
+
+After the third failure:
+1. Log an `integration_action` AUDIT entry with `"status": "failed"` and
+   `"attempts": 3`
+2. Add an item to `.planning/STATE.md` under `Pending integration actions`
+3. Provide the manual retry command, for example `/mindforge:sync-jira --phase 3`
+
+For 429 responses, obey `Retry-After` when present. If a second 429 occurs,
+ stop, log it, and do not retry again.
+
+## Integration action logging
+Every sync, publish, notify, approval, or PR operation writes an AUDIT entry:
+
+```json
+{
+  "id": "uuid-v4",
+  "timestamp": "ISO-8601",
+  "event": "integration_action",
+  "integration": "jira|confluence|slack|github|gitlab",
+  "action": "create_ticket|publish_page|send_notification|create_pr",
+  "status": "success|failed|skipped",
+  "detail": "brief description",
+  "external_id": "service-specific ID"
+}
+```

package/.mindforge/integrations/github.md

@@ -0,0 +1,25 @@
+# MindForge — GitHub Integration
+
+## Purpose
+Strengthen shipping with PR templates, reviewer assignment guidance, branch
+ protection awareness, and release metadata checks.
+
+## API policy
+Use GitHub REST API v3 for all required operations. GraphQL is optional for
+ advanced queries only and is not required for Day 4.
+
+## Pre-flight checks
+
+1. Verify the branch has at least one commit ahead of base:
+   `git log origin/${GITHUB_DEFAULT_BRANCH}..HEAD --oneline | wc -l`
+2. Query branch protection:
+   `GET /repos/{owner}/{repo}/branches/{branch}/protection`
+3. Treat HTTP 404 from the protection endpoint as `no branch protection
+   configured`, not as a connection failure.
+
+If there are zero commits ahead of base, do not attempt PR creation.
+
+## PR creation guidance
+Use `.github/pull_request_template.md` when present, assign default reviewers
+ from config, and ensure the PR body links verification artifacts and the
+ relevant phase or milestone documents.

package/.mindforge/integrations/gitlab.md

@@ -0,0 +1,13 @@
+# MindForge — GitLab Integration
+
+## Purpose
+Provide GitLab parity for merge request creation, reviewer defaults, and branch
+ policy awareness when GitHub is not the source control platform.
+
+## Scope
+Day 4 covers configuration and process guidance only:
+- read project and reviewer metadata from `INTEGRATIONS-CONFIG.md`
+- create merge requests with milestone or phase summaries
+- treat integration failures as non-fatal
+
+Full API parity with GitHub can be extended in later milestones.

package/.mindforge/integrations/jira.md

@@ -0,0 +1,102 @@
+# MindForge — Jira Integration
+
+## Purpose
+Synchronise MindForge planning state into Jira for organisational visibility
+ while keeping MindForge as the source of truth for technical execution.
+
+## Mapping model
+
+| MindForge artifact/event | Jira representation |
+|---|---|
+| Phase N | Epic |
+| `PLAN-N-M.md` | Story |
+| `task_started` | Story transition to In Progress |
+| `task_completed` | Story transition to Done |
+| `task_failed` | Story comment + blocked transition when available |
+| `security_finding` HIGH/CRITICAL | Bug with security labels |
+| Phase verified | Epic transitioned to Ready for Review |
+| UAT signed off | Epic transitioned to Done |
+
+Jira-to-MindForge state ingestion is out of scope for Day 4. MindForge is the
+ source of truth; Jira reflects it.
+
+## API and authentication
+Use Jira REST API v3. Read credentials through `connection-manager.md`.
+Do not log tokens, auth headers, or raw credential-bearing commands.
+
+## Epic creation
+Create one Epic per phase. Verify the Epic Name field ID in your Jira instance
+ with `GET /rest/api/3/field` and locate `Epic Name`; do not assume
+ `customfield_10014` is universal.
+
+## Story creation
+Project type matters:
+
+- Team-managed / next-gen projects: link with `parent.key`
+- Company-managed / classic projects: use the Epic-link custom field discovered
+  from `GET /rest/api/3/field`
+
+## Dynamic transition ID lookup
+Never hardcode transition IDs. Before transitioning an issue, fetch available
+ transitions from `GET /rest/api/3/issue/{issueKey}/transitions` and match by
+ transition name.
+
+MindForge event to transition-name mapping:
+
+| Event | Preferred Jira transition name | Notes |
+|---|---|---|
+| `task_started` | `In Progress` | common default |
+| `task_completed` | `Done` | sometimes `Resolve Issue` or `Close Issue` |
+| `task_failed` | `On Hold` | fallback to `Blocked` if present |
+| `UAT_signed_off` | `Done` | used for epics |
+
+If the transition name is unavailable:
+1. Log a `sync_warning` AUDIT entry
+2. Skip the transition
+3. Never fail the source task because Jira workflow names differ
+
+Cache resolved transition IDs in `.planning/jira-sync.json` by project key.
+Refresh the cache if a transition returns 400.
+
+## Security bug creation
+When a `security_finding` has `HIGH` or `CRITICAL` severity, create a Bug with
+ the OWASP category, file, line, and remediation summary.
+
+## Conflict handling
+Preserve manual Jira edits. Sync may add comments, labels, or new issues, but
+ it must not destructively overwrite manual Jira changes.
+
+## Rate limiting and backoff
+Maintain at least 200 ms between normal calls. For batches larger than 10
+ tickets, start exponential backoff at 500 ms. On 429, respect `Retry-After`
+ and retry once; on a second 429, stop and log the failure.
+
+## Sync state file
+Track mappings in `.planning/jira-sync.json`:
+
+```json
+{
+  "schema_version": "1.0.0",
+  "last_sync": "ISO-8601",
+  "project_key": "ENG",
+  "phase_mappings": {
+    "1": {
+      "epic_key": "ENG-42",
+      "story_keys": { "01": "ENG-43" }
+    }
+  },
+  "transition_cache": {
+    "ENG": {
+      "in_progress_id": "21",
+      "done_id": "31",
+      "blocked_id": "41",
+      "cached_at": "ISO-8601"
+    }
+  },
+  "_warning": "Do not store credentials in this file."
+}
+```
+
+`jira-sync.json` contains project metadata, not credentials, but it may expose
+ internal project structure. Consider gitignoring it in public/open-source
+ distributions.