blue-gardener 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+# Blue Gardener
+
+CLI tool to manage AI coding agents across multiple platforms - install, remove, and sync specialized AI agents for your projects.
+
+**[📚 Full Documentation](https://bluegardenproject.github.io/blue-gardener/)**
+
+## Supported Platforms
+
+- **Cursor** - Native agent support
+- **Claude Desktop** - MCP agents
+- **Codex** - OpenAI Codex
+- **GitHub Copilot** - Custom instructions
+- **Windsurf** - Cascade rules
+- **OpenCode** - Custom agents
+
+## Quick Start
+
+Install Blue Gardener:
+
+::: code-group
+
+```bash [npm]
+npm install -D blue-gardener
+npx blue-gardener add
+```
+
+```bash [pnpm]
+pnpm add -D blue-gardener
+pnpm blue-gardener add
+```
+
+```bash [yarn]
+yarn add -D blue-gardener
+yarn blue-gardener add
+```
+
+:::
+
+## Available Agents
+
+44 specialized agents across 6 categories:
+
+- **Orchestrators** (5) - Planning and coordination
+- **Development** (9) - React, Node.js, Go implementation
+- **Quality** (9) - Code review, testing, optimization
+- **Infrastructure** (9) - CI/CD, databases, Docker
+- **Configuration** (1) - Multi-platform AI setup
+- **Blockchain** (11) - Smart contracts, DeFi, Web3
+
+**[Browse Agent Catalog →](https://bluegardenproject.github.io/blue-gardener/agents/)**
+
+## Key Features
+
+### Multi-Platform Support
+
+Works seamlessly with 6 different AI coding platforms.
+
+### Category-Based Selection
+
+```
+? Select a category:
+  > Orchestrators (5 agents)
+    Development (9 agents)
+    Quality (9 agents)
+    ...
+```
+
+### Orchestration Patterns
+
+Agents collaborate through proven patterns:
+
+- Feature Development Flow
+- Quality Assurance Flow
+- Refactoring Flow
+
+**[Learn Orchestration →](https://bluegardenproject.github.io/blue-gardener/guide/orchestration)**
+
+## Documentation
+
+- **[Getting Started](https://bluegardenproject.github.io/blue-gardener/guide/getting-started)** - Installation and first steps
+- **[Platforms](https://bluegardenproject.github.io/blue-gardener/guide/platforms)** - Platform-specific details
+- **[Agent Catalog](https://bluegardenproject.github.io/blue-gardener/agents/)** - Browse all 44 agents
+- **[Orchestration](https://bluegardenproject.github.io/blue-gardener/guide/orchestration)** - How agents work together
+- **[CLI Reference](https://bluegardenproject.github.io/blue-gardener/reference/cli)** - Complete command docs
+
+## License
+
+MIT

package/agents/CATALOG.md

@@ -0,0 +1,272 @@
+# Agent Catalog
+
+Complete list of available agents in Blue Gardener.
+
+**Total: 44 agents**
+
+| Category       | Count |
+| -------------- | ----- |
+| Orchestrators  | 5     |
+| Development    | 9     |
+| Quality        | 9     |
+| Infrastructure | 9     |
+| Configuration  | 1     |
+| Blockchain     | 11    |
+
+---
+
+## Orchestrators
+
+High-level planning and coordination agents that understand the full picture and delegate to specialists.
+
+| Agent                                    | Description                                                                                                         |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `blue-feature-specification-analyst`     | Product-technical bridge that clarifies requirements, defines acceptance criteria, and creates implementation plans |
+| `blue-architecture-designer`             | Technical strategy specialist for component architecture, data flow, and system integration                         |
+| `blue-refactoring-strategy-planner`      | Strategic planner for large refactoring efforts, migrations, and technical debt reduction                           |
+| `blue-app-quality-gate-keeper`           | Quality gate orchestrator for security, performance, and code quality audits before releases                        |
+| `blue-implementation-review-coordinator` | Post-implementation coordinator that ensures features meet quality standards through iterative review-fix cycles    |
+
+## Development Specialists
+
+Domain experts for implementation work.
+
+| Agent                                         | Description                                                                         |
+| --------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `blue-react-developer`                        | React ecosystem specialist for components, hooks, patterns, and React Native        |
+| `blue-state-management-expert`                | State management covering Redux, Zustand, XState, Jotai, and Context                |
+| `blue-ui-styling-specialist`                  | Visual implementation with Tailwind, CSS-in-JS, and responsive design               |
+| `blue-api-integration-expert`                 | Data layer specialist for REST, GraphQL, tRPC, and data fetching patterns           |
+| `blue-third-party-api-strategist`             | Plans third-party API integrations: auth, rate limits, data mapping, error handling |
+| `blue-animation-specialist`                   | Web animations and micro-interactions with CSS, Framer Motion, and GSAP             |
+| `blue-storybook-specialist`                   | Storybook configuration, efficient story writing, and component documentation       |
+| `blue-node-backend-implementation-specialist` | Node.js/TypeScript backend with Express, Fastify, NestJS, and Hono                  |
+| `blue-go-backend-implementation-specialist`   | Go backend with standard library, Gin, Echo, and Fiber frameworks                   |
+
+## Quality Specialists
+
+Code quality, testing, and optimization experts.
+
+| Agent                             | Description                                                                     |
+| --------------------------------- | ------------------------------------------------------------------------------- |
+| `blue-frontend-code-reviewer`     | Frontend code quality for JavaScript/TypeScript, React, Vue, and web apps       |
+| `blue-node-backend-code-reviewer` | Node.js/TypeScript backend code quality and best practices                      |
+| `blue-go-backend-code-reviewer`   | Go backend code quality, idioms, and concurrency patterns                       |
+| `blue-accessibility-specialist`   | Accessibility (a11y) expert for WCAG compliance and screen reader support       |
+| `blue-unit-testing-specialist`    | Unit testing with Jest, Vitest, and React Testing Library                       |
+| `blue-e2e-testing-specialist`     | End-to-end testing with Playwright and Cypress                                  |
+| `blue-performance-specialist`     | Performance optimization for bundle size, rendering, and caching                |
+| `blue-security-specialist`        | Frontend security for auth flows, XSS/CSRF prevention, and secure data handling |
+| `blue-seo-specialist`             | SEO optimization for meta tags, structured data, and search engine visibility   |
+
+## Infrastructure
+
+CI/CD, tooling, databases, and configuration specialists.
+
+| Agent                                     | Description                                                                   |
+| ----------------------------------------- | ----------------------------------------------------------------------------- |
+| `blue-github-actions-specialist`          | GitHub Actions and workflow specialist for CI/CD pipelines                    |
+| `blue-typescript-cli-developer`           | TypeScript CLI tool development with complexity-aware architecture            |
+| `blue-docker-specialist`                  | Docker and containerization for development and production                    |
+| `blue-monorepo-specialist`                | Monorepo tooling with Nx, Turborepo, and pnpm workspaces                      |
+| `blue-cron-job-implementation-specialist` | Cron job expert for implementing, maintaining, and monitoring scheduled tasks |
+| `blue-database-architecture-specialist`   | Database-agnostic design, schema planning, and database type selection        |
+| `blue-relational-database-specialist`     | PostgreSQL and MySQL implementation, queries, and optimization                |
+| `blue-document-database-specialist`       | MongoDB document modeling, aggregation pipelines, and operations              |
+| `blue-keyvalue-database-specialist`       | Redis caching, sessions, pub/sub, and key-value store patterns                |
+
+## Configuration
+
+AI platform and tool configuration experts.
+
+| Agent                                       | Description                                                                                                                                               |
+| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `blue-ai-platform-configuration-specialist` | Multi-platform AI configuration for agents, rules, and conventions across 6 platforms (Cursor, Claude Desktop, Codex, GitHub Copilot, Windsurf, OpenCode) |
+
+## Blockchain
+
+Smart contract development, DeFi, and Web3 specialists.
+
+| Agent                                   | Description                                                                |
+| --------------------------------------- | -------------------------------------------------------------------------- |
+| `blue-blockchain-product-strategist`    | Blockchain product planning, chain selection, and tokenomics strategy      |
+| `blue-blockchain-architecture-designer` | Smart contract architecture, protocol design, and system integration       |
+| `blue-blockchain-ethereum-developer`    | Solidity/EVM development with Foundry/Hardhat, testing, and gas efficiency |
+| `blue-blockchain-solana-developer`      | Rust/Anchor development for Solana programs and account model              |
+| `blue-blockchain-frontend-integrator`   | Wallet connections, Web3 React hooks, and transaction UX                   |
+| `blue-blockchain-backend-integrator`    | Event indexing, The Graph subgraphs, and blockchain API services           |
+| `blue-blockchain-security-auditor`      | Smart contract security audits, vulnerability detection, and remediation   |
+| `blue-blockchain-code-reviewer`         | Smart contract code quality, best practices, and documentation             |
+| `blue-blockchain-gas-optimizer`         | EVM gas optimization, storage packing, and efficient patterns              |
+| `blue-blockchain-tokenomics-designer`   | Token economics, distribution, incentives, and sustainable models          |
+| `blue-blockchain-defi-specialist`       | DeFi mechanics: lending, AMMs, yield strategies, and protocol design       |
+
+---
+
+## Orchestration Patterns
+
+Blue Gardener agents are designed to work together. Here are the key orchestration patterns:
+
+**For comprehensive orchestration patterns and workflows, see [ORCHESTRATION_GUIDE.md](../ORCHESTRATION_GUIDE.md).**
+
+### Feature Development Flow
+
+For implementing new features:
+
+```
+1. @blue-feature-specification-analyst
+   → Clarifies requirements
+   → Creates implementation plan
+
+2. @blue-architecture-designer
+   → Designs technical approach
+   → Recommends specialists
+
+3. Implementation specialists (parallel):
+   → @blue-react-developer
+   → @blue-state-management-expert
+   → @blue-ui-styling-specialist
+
+4. @blue-implementation-review-coordinator
+   → Quality review with feedback loops
+   → Delegates to @blue-app-quality-gate-keeper
+   → Routes fixes to specialists
+   → Iterates until quality standards met
+   → Final sign-off
+```
+
+### Backend Development Flow
+
+For building backend services:
+
+```
+1. @blue-architecture-designer
+   → System design
+   → Database selection
+
+2. @blue-database-architecture-specialist
+   → Schema design
+   → Scaling strategy
+
+3. Implementation:
+   → @blue-node-backend-implementation-specialist (Node.js)
+   → @blue-go-backend-implementation-specialist (Go)
+   → Database specialist (relational/document/keyvalue)
+
+4. Code review:
+   → @blue-node-backend-code-reviewer
+   → @blue-go-backend-code-reviewer
+```
+
+### Blockchain Project Flow
+
+For crypto/blockchain projects:
+
+```
+1. @blue-blockchain-product-strategist
+   → Requirements and chain selection
+   → Tokenomics high-level design
+
+2. @blue-blockchain-architecture-designer
+   → Smart contract architecture
+   → Protocol design
+
+3. Implementation:
+   → @blue-blockchain-ethereum-developer (EVM)
+   → @blue-blockchain-solana-developer (Solana)
+   → @blue-blockchain-frontend-integrator (dApp)
+   → @blue-blockchain-backend-integrator (indexing)
+
+4. Quality:
+   → @blue-blockchain-code-reviewer
+   → @blue-blockchain-security-auditor
+   → @blue-blockchain-gas-optimizer
+
+5. Economics (if tokenized):
+   → @blue-blockchain-tokenomics-designer
+   → @blue-blockchain-defi-specialist (if DeFi)
+```
+
+### Refactoring Flow
+
+For large migrations and refactoring:
+
+```
+1. @blue-refactoring-strategy-planner
+   → Analyzes current state
+   → Creates phased migration plan
+   → Identifies risks
+
+2. Phase execution with quality gates:
+   → Implementation specialists per phase
+   → @blue-implementation-review-coordinator after each phase
+   → Sign-off before next phase begins
+
+3. Final verification:
+   → @blue-implementation-review-coordinator
+   → Comprehensive quality check
+   → @blue-unit-testing-specialist
+   → @blue-e2e-testing-specialist
+```
+
+### Third-Party API Integration Flow
+
+For integrating external APIs (Stripe, Auth0, etc.):
+
+```
+1. @blue-architecture-designer
+   → Identifies need for third-party integration
+   → High-level technical strategy
+
+2. @blue-third-party-api-strategist
+   → Reviews API documentation
+   → Plans auth, rate limits, data mapping
+   → Defines error handling strategy
+   → Creates implementation tasks
+
+3. @blue-api-integration-expert
+   → Implements the technical details
+   → React Query/RTK Query hooks
+   → Error handling code
+
+4. @blue-security-specialist (if auth/payments)
+   → Reviews security aspects
+```
+
+### Quality Assurance Flow
+
+For post-implementation quality verification:
+
+```
+1. @blue-implementation-review-coordinator
+   → Coordinates comprehensive review
+   → Manages feedback loops
+
+2. Delegates to @blue-app-quality-gate-keeper
+   → Determines relevant audits
+   → Coordinates specialist reviews:
+     • @blue-frontend-code-reviewer (frontend)
+     • @blue-node-backend-code-reviewer (backend)
+     • @blue-security-specialist (auth, payments)
+     • @blue-performance-specialist (user-facing)
+     • @blue-accessibility-specialist (UI)
+     • @blue-seo-specialist (public pages)
+
+3. Review coordinator analyzes findings
+   → Routes fixes to implementation specialists
+   → Re-audits after fixes
+   → Iterates until quality standards met
+
+4. Final sign-off with quality report
+```
+
+### Scaling with Complexity
+
+| Task Complexity    | Typical Agents Involved                                                |
+| ------------------ | ---------------------------------------------------------------------- |
+| Simple bug fix     | 1-2 (developer + reviewer)                                             |
+| Standard feature   | 4-6 (planner + architect + implementation + review coordinator)        |
+| Complex feature    | 7-9 (add security, testing specialists)                                |
+| Full release audit | 6-8 (review coordinator + quality-gate-keeper + quality specialists)   |
+| Major refactoring  | 5-7 (strategy-planner + implementation + review coordinator + testing) |
+| Blockchain dApp    | 6-9 (strategist + architect + devs + security + review coordinator)    |