docs/brainstorming/magentic-pydantic/03_IMMEDIATE_ACTIONS.md

Immediate Actions Checklist

Date: November 27, 2025 Priority: Execute in order

---

Before Starting Implementation

1. Close PR #41 (CRITICAL)

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

# 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

# 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

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:

# 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:

# 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.