Skip to content

Commit 3f1d387

Browse files
committed
feat: RAG architecture improvements, Sprint 6 completion, and Sprint 7 initialization
- Add new RAG agents: agentic_rag, simple_rag, development_context_agent, dynamic_graph_composer - Complete Sprint 6 with retrospective and completion summary - Initialize Sprint 7 documentation - Add comprehensive testing guides and Studio HITL documentation - Update RAG architecture documentation with complete design and overview - Enhance prompt management with sync improvements - Add workflow enhancements: thread management, agent status query, agent QA - Update requirements.txt with new dependencies - Add new Studio implementations for various agents - Improve RAG swarm coordinator and query analyst agent
1 parent fc07444 commit 3f1d387

File tree

115 files changed

+32353
-1571
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

115 files changed

+32353
-1571
lines changed

.cursor/rules/core/development_excellence.mdc

Lines changed: 494 additions & 3 deletions
Large diffs are not rendered by default.

.cursor/rules/core/systematic_completion.mdc

Lines changed: 59 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -505,18 +505,37 @@ The following conditions will BLOCK task completion:
505505

506506
### **Documentation Discipline**
507507

508-
**CRITICAL**: Minimize unnecessary documentation overhead:
508+
**CRITICAL**: Documentation is necessary - but track progress in agile artifacts, not status reports.
509+
510+
**Core Philosophy**:
511+
1. **Working Code First** - Implementation over meta-documentation
512+
2. **Agile Artifacts for Progress** - Track work progress in user stories, acceptance criteria, and tasks
513+
3. **Feature Documentation When Needed** - Document features/concepts in proper locations when they provide value
514+
4. **No Status Reports** - Don't create "what I did" reports
509515

510516
```python
511-
# FORBIDDEN: Unsolicited status reports, summaries, or documentation
517+
# FORBIDDEN: Unsolicited status reports about actions taken
512518
def complete_feature():
513519
implement_feature()
514-
# ❌ DON'T create summary documents unless user asks
520+
update_user_story_status() # ✅ Track progress in agile artifacts
521+
# ❌ DON'T create "what I did" reports
515522
# create_status_report() # FORBIDDEN
516523
# create_summary_document() # FORBIDDEN
517-
# create_analysis_document() # FORBIDDEN
524+
# create_bugfix_explanation() # FORBIDDEN
525+
# create_action_report() # FORBIDDEN
526+
527+
# REQUIRED: Create feature/concept documentation when needed
528+
def implement_new_rag_system():
529+
implement_rag_system()
530+
update_user_story() # ✅ Progress in agile artifacts
531+
532+
# ✅ Document the feature/concept in proper location
533+
create_documentation(
534+
path="docs/architecture/rag_system_design.md",
535+
content="RAG system architecture and design decisions"
536+
)
518537

519-
# REQUIRED: Only create documentation when explicitly requested
538+
# REQUIRED: Only create status reports when explicitly requested
520539
def handle_user_request(request):
521540
if "create summary" in request or "document this" in request:
522541
create_documentation() # ✅ User asked for it
@@ -525,17 +544,41 @@ def handle_user_request(request):
525544
```
526545

527546
**Rules**:
528-
- **No Status Reports**: Don't create status/summary documents unless explicitly requested
529-
- **No Analysis Documents**: Don't create analysis files unless user asks
530-
- **No Progress Reports**: Don't create progress documentation unless requested
531-
- **Just Code**: Focus on implementation, not meta-documentation
532-
- **User-Driven**: Only create documentation when user explicitly asks
533-
534-
**Exceptions**:
535-
- **User Stories/Tasks**: Update acceptance criteria and task status as required
536-
- **Code Documentation**: Always document code (docstrings, comments)
537-
- **Technical Docs**: Update architecture/design docs when they become stale
538-
- **Bug Fixes**: Document in commit messages, not separate files
547+
- **Progress in Agile Artifacts**: Track working progress in user stories/tasks, not separate documents
548+
- **No Status Reports**: Don't create "what I did today" reports unless explicitly requested
549+
- **Feature Documentation**: Create docs for features/concepts when they provide value
550+
- **Right Place, Right Directory**: Put documentation in proper directory structure (docs/architecture/, docs/guides/, etc.)
551+
- **No Action Summaries**: Don't document every step taken
552+
- **Value-Driven**: Only create documentation that provides real value
553+
554+
**What to Always Maintain**:
555+
- ✅ **Agile Artifacts**: Update user stories, tasks, acceptance criteria (progress tracking lives here)
556+
- ✅ **Code Documentation**: Always document code (docstrings, comments, type hints)
557+
- ✅ **Architecture Docs**: Document significant design decisions in `docs/architecture/`
558+
- ✅ **API Documentation**: Keep API references current in `docs/reference/`
559+
- ✅ **User Guides**: Create guides for features in `docs/guides/`
560+
561+
**What NOT to Create (Unless Requested)**:
562+
- ❌ **Bug Fix Reports**: Document in commit messages and code comments, NOT in `docs/fixes/`
563+
- ❌ **Progress Summaries**: Track progress in agile artifacts, not summary documents
564+
- ❌ **Implementation Notes**: Don't create "how I fixed it" documents
565+
- ❌ **Status Reports**: Don't document "what I did" unless user asks
566+
- ❌ **Action Logs**: Don't create logs of actions taken
567+
568+
**When to Create Documentation**:
569+
- ✅ User explicitly requests it
570+
- ✅ New feature/concept needs explanation for team
571+
- ✅ Architecture changes require design documentation
572+
- ✅ API changes need reference updates
573+
- ✅ Complex system needs user guide
574+
575+
**Where to Put Documentation**:
576+
- `docs/architecture/` - System design, patterns, architectural decisions
577+
- `docs/guides/` - User guides, how-tos, tutorials
578+
- `docs/reference/` - API references, technical specifications
579+
- `docs/development/` - Development practices, setup guides
580+
- `docs/agile/` - Agile artifacts (user stories, sprints, backlog)
581+
- **NOT** `docs/fixes/`, `docs/status/`, `docs/reports/`
539582

540583
### **TODO List Discipline**
541584

agents/rag/__init__.py

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,44 @@
33
44
Specialized agents for Retrieval Augmented Generation operations.
55
All agents use LangGraph for proper tracing and agent handover.
6+
7+
For Development Agents:
8+
Use DevelopmentContextAgent to get RAG-enhanced context.
9+
This agent delegates to the RAG swarm and returns enriched context.
610
"""
711

12+
# Phase 1 & 2: Official LangChain RAG implementations
13+
from agents.rag.simple_rag import SimpleRAG, create_simple_rag
14+
from agents.rag.agentic_rag import AgenticRAG, create_agentic_rag
15+
16+
# Keep these for reference - may be used as enhancements later
817
from agents.rag.query_analyst_agent import QueryAnalystAgent
918
from agents.rag.retrieval_specialist_agent import RetrievalSpecialistAgent
1019
from agents.rag.re_ranker_agent import ReRankerAgent
1120
from agents.rag.quality_assurance_agent import QualityAssuranceAgent
1221
from agents.rag.writer_agent import WriterAgent
22+
23+
# Keep coordinator for reference only - don't use directly
1324
from agents.rag.rag_swarm_coordinator import RAGSwarmCoordinator
1425

26+
# Development context agent (uses RAG)
27+
from agents.rag.development_context_agent import create_development_context_agent, create_development_context_graph
28+
1529
__all__ = [
30+
# Phase 1 & 2: Official LangChain RAG (ACTIVE)
31+
'SimpleRAG',
32+
'create_simple_rag',
33+
'AgenticRAG',
34+
'create_agentic_rag',
35+
# Reference agents (for future enhancements)
1636
'QueryAnalystAgent',
1737
'RetrievalSpecialistAgent',
1838
'ReRankerAgent',
1939
'QualityAssuranceAgent',
2040
'WriterAgent',
2141
'RAGSwarmCoordinator',
42+
# Development context
43+
'create_development_context_agent',
44+
'create_development_context_graph',
2245
]
2346

0 commit comments

Comments
 (0)