@agents-at-scale/ark 0.1.55 → 0.1.57

package/templates/marketplace/README.md

@@ -1,197 +1,8 @@
-# ARK Marketplace
+# Ark Marketplace
 
-Welcome to the ARK Marketplace - a central repository for sharing reusable ARK components across projects and teams.
+The Ark Marketplace lives in a separate repository:
 
-## Overview
+**Repository**: https://github.com/mckinsey/agents-at-scale-marketplace
+**Documentation**: https://mckinsey.github.io/agents-at-scale-marketplace/
 
-The marketplace serves as a community-driven collection of:
-
-- **Agents** - Pre-configured AI agents for specific tasks
-- **Teams** - Multi-agent workflows and orchestration patterns
-- **Models** - Model configurations for different providers and use cases
-- **Tools** - Extensions that add capabilities to agents
-- **MCP Servers** - Model Context Protocol server implementations
-- **Queries** - Reusable query templates and patterns
-- **Projects** - Complete, end-to-end Ark project templates and solutions
-
-## Repository Structure
-
-```
-marketplace/
-├── agents/           # Reusable agent definitions
-├── teams/            # Multi-agent workflow configurations
-├── models/           # Model configurations by provider
-├── queries/          # Query templates and patterns
-├── tools/            # Tool definitions and implementations
-├── mcp-servers/      # MCP server configurations
-├── projects/         # Complete Ark project templates and solutions
-├── tests/            # Test configurations and utilities
-├── scripts/          # Automation and validation scripts
-├── docs/             # Documentation and guides
-├── templates/        # Component creation templates
-└── .github/          # GitHub workflows and templates
-```
-
-## Contributing Components
-
-### Getting Started
-
-1. **Fork** this repository
-2. **Choose** the appropriate directory for your component type
-3. **Copy** the relevant template from `templates/` directory
-4. **Implement** your component following the guidelines
-5. **Test** your component thoroughly
-6. **Submit** a pull request
-
-### Component Guidelines
-
-#### Agents (`agents/`)
-
-- One agent per subdirectory
-- Include `agent.yaml` with complete agent definition
-- Provide comprehensive `README.md` with usage examples
-- Test with multiple model providers when possible
-
-#### Teams (`teams/`)
-
-- Document the workflow strategy and use cases
-- Include example inputs and expected outputs
-- Explain when to use this team configuration
-- Test the complete workflow end-to-end
-
-#### Models (`models/`)
-
-- Organize by provider (openai/, anthropic/, etc.)
-- Include provider-specific configurations
-- Document capabilities, limitations, and costs
-- Specify recommended use cases
-
-#### Tools (`tools/`)
-
-- Follow Ark tool specification
-- Include source code and build instructions
-- Provide security considerations
-- Include comprehensive error handling
-
-#### MCP Servers (`mcp-servers/`)
-
-- Follow MCP protocol specifications
-- Document all available tools and resources
-- Include security and monitoring configurations
-- Provide integration examples
-
-#### Queries (`queries/`)
-
-- Make queries parameterizable where possible
-- Document expected inputs and outputs
-- Specify compatible agents and teams
-- Include usage examples
-
-#### Projects (`projects/`)
-
-- Provide complete, self-contained Ark project structures
-- Include comprehensive documentation with architecture overview
-- Specify all required dependencies (models, tools, external services)
-- Provide clear setup and deployment instructions
-- Include working examples and sample data where applicable
-- Document the use case and target scenarios
-- Follow Ark best practices for resource organization
-- Include multiple components working together (agents, teams, tools, etc.)
-
-### Quality Standards
-
-All contributions must meet these standards:
-
-- ✅ **Documentation** - Clear README with setup and usage instructions
-- ✅ **Security** - Follow security best practices
-- ✅ **Compatibility** - Work with latest Ark version
-- ✅ **Examples** - Provide working usage examples
-- ✅ **Validation** - Pass all automated validation checks
-
-### Submission Process
-
-1. **Create** your component following the guidelines above
-2. **Run** validation scripts: `scripts/validate-component.sh <component-path>`
-3. **Test** your component in a real environment
-4. **Submit** pull request with:
-   - Clear description of the component's purpose
-   - Usage examples and test results
-   - Documentation of any dependencies
-   - Screenshots or demos if applicable
-
-### Review Process
-
-1. **Automated Checks** - CI pipeline validates component structure and security
-2. **Community Review** - Other contributors provide feedback
-3. **Maintainer Review** - Core team performs final review
-4. **Approval** - Component is merged and becomes available
-
-## Using Marketplace Components
-
-### Finding Components
-
-- Browse directories by component type
-- Check `README.md` files for detailed descriptions
-- Look for tags and categories in component metadata
-- Use GitHub search to find specific functionality
-
-### Installing Components
-
-1. **Copy** the component files to your project
-2. **Customize** configuration as needed
-3. **Install** any dependencies listed in component README
-4. **Test** the component in your environment
-5. **Deploy** following your project's deployment process
-
-### Component Versioning
-
-Components follow semantic versioning:
-
-- **Major** - Breaking changes requiring migration
-- **Minor** - New features, backward compatible
-- **Patch** - Bug fixes and minor improvements
-
-## Support and Community
-
-### Getting Help
-
-- 📖 **Documentation** - Check `docs/` directory for guides
-- 💬 **Discussions** - Use GitHub Discussions for questions
-- 🐛 **Issues** - Report bugs or request features via GitHub Issues
-- 📧 **Contact** - Reach out to maintainers for urgent matters
-
-### Contributing Beyond Components
-
-We welcome contributions in many forms:
-
-- 📝 **Documentation** improvements
-- 🧪 **Testing** and validation improvements
-- 🔧 **Tooling** and automation enhancements
-- 🎨 **Templates** and examples
-- 🔍 **Reviews** and feedback on submissions
-
-## Governance
-
-### Maintainers
-
-The marketplace is maintained by the core team and trusted community contributors.
-
-### Licensing
-
-All contributions must be compatible with the project license. By contributing, you agree to license your contributions under the same terms.
-
-### Code of Conduct
-
-This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). Please read and follow these guidelines in all interactions.
-
-## Quick Start
-
-Ready to contribute? Start here:
-
-1. **Explore** existing components for inspiration
-2. **Choose** a template from `templates/` directory
-3. **Read** the component-specific guidelines in `docs/`
-4. **Create** your component following the standards
-5. **Submit** your pull request
-
-Thank you for contributing to the {{ .Values.projectName }} Marketplace! 🚀
+See the marketplace repo for structure, contribution guidelines, and available components (executors, services, MCP servers, agents, demos).