DeepCritical / docs /index.md
VibecoderMcSwaggins's picture
feat(docs): update implementation roadmap and add specs for Phases 9-11
3fcd8e7
|
raw
history blame
3.25 kB
# DeepCritical Documentation
## Medical Drug Repurposing Research Agent
AI-powered deep research system for accelerating drug repurposing discovery.
---
## Quick Links
### Architecture
- **[Overview](architecture/overview.md)** - Project overview, use case, architecture, timeline
- **[Design Patterns](architecture/design-patterns.md)** - 17 technical patterns, reference repos, judge prompts, data models
### Implementation (Start Here!)
- **[Roadmap](implementation/roadmap.md)** - Phased execution plan with TDD
- **[Phase 1: Foundation](implementation/01_phase_foundation.md)** βœ… - Tooling, config, first tests
- **[Phase 2: Search](implementation/02_phase_search.md)** βœ… - PubMed search
- **[Phase 3: Judge](implementation/03_phase_judge.md)** βœ… - LLM evidence assessment
- **[Phase 4: UI](implementation/04_phase_ui.md)** βœ… - Orchestrator + Gradio
- **[Phase 5: Magentic](implementation/05_phase_magentic.md)** βœ… - Multi-agent orchestration
- **[Phase 6: Embeddings](implementation/06_phase_embeddings.md)** βœ… - Semantic search + dedup
- **[Phase 7: Hypothesis](implementation/07_phase_hypothesis.md)** βœ… - Mechanistic reasoning
- **[Phase 8: Report](implementation/08_phase_report.md)** βœ… - Structured scientific reports
- **[Phase 9: Source Cleanup](implementation/09_phase_source_cleanup.md)** πŸ“ - Remove DuckDuckGo
- **[Phase 10: ClinicalTrials](implementation/10_phase_clinicaltrials.md)** πŸ“ - Clinical trials API
- **[Phase 11: bioRxiv](implementation/11_phase_biorxiv.md)** πŸ“ - Preprint search
### Guides
- [Setup Guide](guides/setup.md) (coming soon)
- **[Deployment Guide](guides/deployment.md)** - Gradio, MCP, and Modal launch steps
### Development
- **[Testing Strategy](development/testing.md)** - Unit, Integration, and E2E testing patterns
- [Contributing](development/contributing.md) (coming soon)
---
## What We're Building
**One-liner**: AI agent that searches medical literature to find existing drugs that might treat new diseases.
**Example Query**:
> "What existing drugs might help treat long COVID fatigue?"
**Output**: Research report with drug candidates, mechanisms, evidence quality, and citations.
---
## Architecture Summary
```
User Question β†’ Research Agent (Orchestrator)
↓
Search Loop:
β†’ Tools (PubMed, Web Search)
β†’ Judge (Quality + Budget)
β†’ Repeat or Synthesize
↓
Research Report with Citations
```
---
## Hackathon Tracks
| Track | Status | Key Feature |
|-------|--------|-------------|
| **Gradio** | βœ… Planned | Streaming UI with progress |
| **MCP** | βœ… Planned | PubMed as MCP server |
| **Modal** | πŸ”„ Stretch | GPU inference option |
---
## Team
- Physician (medical domain expert) βœ…
- Software engineers βœ…
- AI architecture validated by multiple agents βœ…
---
## Status
| Phase | Status |
|-------|--------|
| Phases 1-8 | βœ… COMPLETE |
| Phase 9: Remove DuckDuckGo | πŸ“ SPEC READY |
| Phase 10: ClinicalTrials.gov | πŸ“ SPEC READY |
| Phase 11: bioRxiv | πŸ“ SPEC READY |
**Architecture Review**: PASSED (98-99/100)
**Phases 1-8**: COMPLETE
**Next**: Phases 9-11 (Multi-Source Enhancement)