DevCrew_s: Specifications for AI-Powered Multi-Agent Development

🎯 Overview

DevCrew_s is the specification repository for the DevCrew multi-agent framework. This repository contains all agent specifications, protocol definitions, and architectural documentation that define how autonomous AI agents collaborate to perform complex development tasks across various domains.

Note: This is a specification-only repository. For actual implementations, see the DevCrew_i repository.

🚀 Why DevCrew?

The Human-AI Partnership Model

AI agents augment, not replace, human expertise. Our framework embodies the principle that AI and humans excel in different areas:

• Humans excel at: Creativity, ethical judgment, strategic vision, and emotional intelligence (EPOCH Framework)
• AI agents excel at: Pattern recognition, repetitive tasks, 24/7 availability, and processing vast amounts of data

Research shows AI agents can boost team productivity by 60% while humans maintain control over strategic decisions. Learn more about AI augmentation vs. replacement →

Background

• 79% of companies are already adopting AI agents
• 96% of organizations plan to expand AI usage in 2025
• Early adopters achieve 30-50% cost reductions while improving quality

Explore the full business case →

Agent Architecture

• Specialized Roles: Each agent has focused expertise
• Protocol-Driven: Standardized workflows ensure consistency
• Human Oversight: Strategic decisions remain with humans

Protocol Design

• Reusable: One protocol serves multiple agents
• Composable: Protocols can invoke other protocols
• Auditable: Clear success criteria and failure handling

Governance Model

• Quality Gates: Automated validation checkpoints
• Architecture Fitness: Continuous compliance verification
• Privacy by Design: Built-in data protection

🤖 Current Official Agents

🔄 Core Protocols

DevCrew agents collaborate through 48 standardized protocols across 8 categories:

Featured Protocols

• P-TDD: Test-Driven Development enforcement
• GH-1: GitHub Issue Triage workflow
• P-RECOVERY: Failure recovery and rollback
• ADR Creation: Architecture decision records
• P-DEVSECOPS: Integrated security pipeline

Explore all protocols →

🚦 Getting Started

Implementation Platforms

DevCrew specifications can be implemented using various platforms:

• AWS Strands - Enterprise-scale AWS implementation
• Claude Code - Anthropic's AI coding assistant
• CrewAI - Open-source multi-agent framework

Quick Start with Specifications

1. Clone the specifications repository

   git clone <repository-url>
   cd devCrew_s
   

2. Study the core agent specifications

   • agent-ADR-Writer-vDEC25.md - Architecture documentation
   • agent-ASR-Writer-vDEC25.md - Requirements analysis
   • agent-Backend-Engineer-vDEC25.md - Server-side development with TDD
   • agent-Blueprint-Writer-vDEC25.md - Implementation planning
   • agent-Business-Analyst-vDEC25.md - Data-driven insights
   • agent-Cloud-Architect-vDEC25.md - Cloud infrastructure design
   • agent-Context-Manager-vDEC25.md - Memory management and knowledge graph maintenance
   • agent-Debugger-vDEC25.md - Root cause analysis and bug investigation
   • agent-DevOps-Engineer-vDEC25.md - CI/CD automation
   • agent-Frontend-Engineer-vDEC25.md - Client-side development
   • agent-Orchestrator-vDEC25.md - Central coordination and multi-agent workflow management
   • agent-Performance-Engineer-vDEC25.md - Performance optimization
   • agent-Project-Manager-vDEC25.md - Project coordination
   • agent-QA-Tester-vDEC25.md - Test automation and quality assurance
   • agent-Security-Auditor-vDEC25.md - Security assessment
   • agent-SRE-vDEC25.md - Site reliability engineering
   • agent-System-Architect-vDEC25.md - Architecture governance with ML-enhanced ASR identification
   • agent-UX-UI-Designer-vDEC25.md - User experience design

3. Understand the protocol structure

   • Begin with GH-1 GitHub Issue Triage
   • Study P-TDD Test-Driven Development
   • Review all available protocols

4. Choose your implementation approach

   • Review the implementation guides for your platform
   • Fork the DevCrew_i repository for implementation
   • Follow platform-specific setup instructions

5. Contribute improvements

   • Propose new agents via agent proposals
   • Submit protocol enhancements
   • Share implementation experiences

🤝 Contributing

Your contributions make DevCrew better for everyone! Whether you're fixing a typo, proposing a new protocol, or designing an innovative agent, every contribution matters.

🌟 Why Contribute?

• Shape the Future: Help define how AI agents collaborate in development workflows
• Learn & Grow: Gain expertise in AI agent architecture and protocols
• Community Impact: Your improvements benefit thousands of developers
• Recognition: Contributors are credited in our releases and documentation

📝 Ways to Contribute

Quick Wins (< 1 hour)

• 🐛 Report Issues: Found a bug or inconsistency? Open an issue
• 📝 Fix Documentation: Improve clarity, fix typos, add examples
• 💡 Suggest Ideas: Propose enhancements via issues

Medium Contributions (1-5 hours)

• 🔄 Improve Protocols: Enhance error handling, add edge cases
• 🤖 Review Agent Specs: Validate proposed agents, suggest improvements
• 📚 Write Guides: Share implementation experiences and best practices

Major Contributions (5+ hours)

• 🆕 Create New Protocols: Design reusable workflows for common tasks
• 🤖 Propose New Agents: Use our AI Agent Specification Template
• 🏗️ Architectural Improvements: Propose system-level enhancements

📚 Resources

• AI Agent Adoption Guide - Comprehensive business case

• Protocol Registry - Complete protocol documentation

• Implementation Guides - Platform-specific tutorials

  • AWS Strands Guide
  • Claude Code Guide
  • CrewAI Guide

• SECURITY.md - Security policy and vulnerability reporting

• 📖 Documentation: Start with our implementation guides

• 🐛 Bug Reports: Report issues

• 💡 Feature Requests: Suggest improvements

• 📧 Contact: Reach out through issue tracker or pull requests

⚖️ License

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

---

Ready to contribute? Start with a good first issue or create an issue with your ideas. Whether you're from software, product, operations, or any other domain, your expertise can help shape the future of AI-assisted development.