forked from cardosofelipe/fast-next-template
Felipe Cardoso
6bb376a336
Security fixes from deep review: - Add input validation patterns for project_id, agent_id, collection - Add path traversal protection for source_path (reject .., null bytes) - Add error codes (INTERNAL_ERROR) to generic exception handlers - Handle FieldInfo objects in validation for test robustness Performance fixes: - Enable concurrent hybrid search with asyncio.gather Health endpoint improvements: - Check all dependencies (database, Redis, LLM Gateway) - Return degraded/unhealthy status based on dependency health - Updated tests for new health check response structure All 139 tests pass. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Syndarix
Your AI-Powered Software Consulting Agency
An autonomous platform that orchestrates specialized AI agents to deliver complete software solutions with minimal human intervention.
Vision
Syndarix transforms the software development lifecycle by providing a virtual consulting team of AI agents that collaboratively plan, design, implement, test, and deliver complete software solutions.
The Problem: Even with AI coding assistants, developers spend as much time managing AI as doing the work themselves. Context switching, babysitting, and knowledge fragmentation limit productivity.
The Solution: A structured, autonomous agency where specialized AI agents handle different roles (Product Owner, Architect, Engineers, QA, etc.) with proper workflows, reviews, and quality gates.
Key Features
Multi-Agent Orchestration
- Configurable agent types with base model, failover, expertise, and personality
- Spawn multiple instances from the same type (e.g., Dave, Ellis, Kate as Software Developers)
- Agent-to-agent communication and collaboration
- Per-instance customization with domain-specific knowledge
Complete SDLC Support
- Requirements Discovery → Architecture Spike → Implementation Planning
- Sprint Management with automated ceremonies
- Issue Tracking with Epic/Story/Task hierarchy
- Git Integration with proper branch/PR workflows
- CI/CD Pipelines with automated testing
Configurable Autonomy
- From
FULL_CONTROL(approve everything) toAUTONOMOUS(only major milestones) - Client can intervene at any point
- Transparent progress visibility
MCP-First Architecture
- All integrations via Model Context Protocol (MCP) servers
- Unified Knowledge Base with project/agent scoping
- Git providers (Gitea, GitHub, GitLab) via MCP
- Extensible through custom MCP tools
Project Complexity Wizard
- Script → Minimal process, no repo needed
- Simple → Single sprint, basic backlog
- Medium/Complex → Full AGILE workflow with multiple sprints
Technology Stack
Built on PragmaStack:
| Component | Technology |
|---|---|
| Backend | FastAPI 0.115+ (Python 3.11+) |
| Frontend | Next.js 16 (React 19) |
| Database | PostgreSQL 15+ with pgvector |
| ORM | SQLAlchemy 2.0 |
| State Management | Zustand + TanStack Query |
| UI | shadcn/ui + Tailwind 4 |
| Auth | JWT dual-token + OAuth 2.0 |
| Testing | pytest + Jest + Playwright |
Syndarix Extensions
| Component | Technology |
|---|---|
| Task Queue | Celery + Redis |
| Real-time | FastAPI WebSocket / SSE |
| Vector DB | pgvector (PostgreSQL extension) |
| MCP SDK | Anthropic MCP SDK |
Project Status
Phase: Architecture & Planning
See docs/requirements/ for the comprehensive requirements document.
Current Milestones
- Fork PragmaStack as foundation
- Create requirements document
- Execute architecture spikes
- Create ADRs for key decisions
- Begin MVP implementation
Documentation
- Requirements Document
- Architecture Decisions (coming soon)
- Spike Research (coming soon)
- Architecture Overview (coming soon)
Getting Started
Prerequisites
- Docker & Docker Compose
- Node.js 20+
- Python 3.11+
- PostgreSQL 15+ (or use Docker)
Quick Start
# Clone the repository
git clone https://gitea.pragmazest.com/cardosofelipe/syndarix.git
cd syndarix
# Copy environment template
cp .env.template .env
# Start development environment
docker-compose -f docker-compose.dev.yml up -d
# Run database migrations
make migrate
# Start the development servers
make dev
Architecture Overview
+====================================================================+
| SYNDARIX CORE |
+====================================================================+
| +------------------+ +------------------+ +------------------+ |
| | Agent Orchestrator| | Project Manager | | Workflow Engine | |
| +------------------+ +------------------+ +------------------+ |
+====================================================================+
|
v
+====================================================================+
| MCP ORCHESTRATION LAYER |
| All integrations via unified MCP servers with project scoping |
+====================================================================+
|
+------------------------+------------------------+
| | |
+----v----+ +----v----+ +----v----+ +----v----+ +----v----+
| LLM | | Git | |Knowledge| | File | | Code |
| Providers| | MCP | |Base MCP | |Sys. MCP | |Analysis |
+---------+ +---------+ +---------+ +---------+ +---------+
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE for details.
Acknowledgments
- Built on PragmaStack
- Powered by Claude and the Anthropic API