File size: 2,670 Bytes
b2929fc |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 |
# Immediate Actions Checklist
**Date:** November 27, 2025
**Priority:** Execute in order
---
## Before Starting Implementation
### 1. Close PR #41 (CRITICAL)
```bash
gh pr close 41 --comment "Architecture decision changed. Cherry-picking improvements to preserve both pydantic-ai and Agent Framework capabilities."
```
### 2. Verify HuggingFace Spaces is Safe
```bash
# Should show agent framework files exist
git ls-tree --name-only huggingface-upstream/dev -- src/agents/
git ls-tree --name-only huggingface-upstream/dev -- src/orchestrator_magentic.py
```
Expected output: Files should exist (they do as of this writing).
### 3. Clean Local Environment
```bash
# Switch to main first
git checkout main
# Delete problematic branches
git branch -D refactor/pydantic-unification 2>/dev/null || true
git branch -D feat/pubmed-fulltext 2>/dev/null || true
# Reset local dev to origin/dev
git branch -D dev 2>/dev/null || true
git checkout -b dev origin/dev
# Verify agent framework code exists
ls src/agents/
# Expected: __init__.py, analysis_agent.py, hypothesis_agent.py, judge_agent.py,
# magentic_agents.py, report_agent.py, search_agent.py, state.py, tools.py
ls src/orchestrator_magentic.py
# Expected: file exists
```
### 4. Create Fresh Feature Branch
```bash
git checkout -b feat/dual-mode-architecture origin/dev
```
---
## Decision Points
Before proceeding, confirm:
1. **For hackathon**: Do we need advanced mode, or is simple mode sufficient?
- Simple mode = faster to implement, works today
- Advanced mode = better quality, more work
2. **Timeline**: How much time do we have?
- If < 1 day: Focus on simple mode only
- If > 1 day: Implement dual-mode
3. **Dependencies**: Is `agent-framework-core` available?
- Check: `pip index versions agent-framework-core`
- If not on PyPI, may need to install from GitHub
---
## Quick Start (Simple Mode Only)
If time is limited, implement only simple mode improvements:
```bash
# On feat/dual-mode-architecture branch
# 1. Update judges.py to add HuggingFace support
# 2. Update config.py to add HF settings
# 3. Create free_tier_demo.py
# 4. Run make check
# 5. Create PR to dev
```
This gives you free-tier capability without touching agent framework code.
---
## Quick Start (Full Dual-Mode)
If time permits, implement full dual-mode:
Follow phases 1-6 in `02_IMPLEMENTATION_PHASES.md`
---
## Emergency Rollback
If anything goes wrong:
```bash
# Reset to safe state
git checkout main
git branch -D feat/dual-mode-architecture
git checkout -b feat/dual-mode-architecture origin/dev
```
Origin/dev is the safe fallback - it has agent framework intact.
|