Imported from HyunjunJeon/Deepagent-research-context-engineering (AGENTS.md). Install upstream with npx skills add HyunjunJeon/Deepagent-research-context-engineering. Copyright stays with the author.

PROJECT KNOWLEDGE BASE

Generated: 2026-01-13

OVERVIEW

Multi-agent research system demonstrating FileSystem-based Context Engineering using LangChain's DeepAgents framework. Includes Python orchestrator, Rust port via Rig framework, and Next.js chat UI.

STRUCTURE

/
  research_agent/          # Python DeepAgent orchestrator (see AGENTS.md)
  context_engineering_research_agent/  # Extended agent with 5 strategies
  deep-agents-ui/          # Next.js React frontend (see AGENTS.md)
  rust-research-agent/     # Rust implementation (see AGENTS.md)
    rig-deepagents/        # Pregel-based middleware runtime
    rig-rlm/               # Recursive Language Model agent
  tests/                   # pytest test suite (see AGENTS.md)
  skills/                  # Project-level skills (SKILL.md per skill)
  research_workspace/      # Agent output directory (ephemeral)
  deepagents_sourcecode/   # Vendor: upstream library reference

WHERE TO LOOK

CONVENTIONS

Deviations from Standard Patterns

• Backend factory pattern: Always use backend_factory(rt: ToolRuntime) - middleware depends on this signature
• SubAgent naming: Use researcher, explorer, synthesizer - hardcoded in prompts
• File paths: Paths starting with "/" route to research_workspace/; others are in-memory
• Korean comments: Docstrings and some comments in Korean (bilingual codebase)

ANTI-PATTERNS

• DO NOT commit .env files (contains API keys)
• DO NOT instantiate researcher directly - use get_researcher_subagent()
• DO NOT skip think_tool() between searches - explicit reflection required
• NEVER write raw JSON to user - always format responses (see deepagents_cli/tools.py)
• NEVER lie to exit early - complete TODO items fully (see researcher/runner.py)

COMMANDS

Python Development

uv sync                           # Install dependencies
langgraph dev                     # Start backend (port 2024)
uv run ruff format .              # Format code
uv run ruff check .               # Lint
uv run mypy .                     # Type check
uv run pytest tests/              # Run tests

Frontend Development

cd deep-agents-ui
yarn install && yarn dev          # Dev server (port 3000)
yarn build                        # Production build
yarn lint && yarn format          # Lint + format

Rust Development

cd rust-research-agent/rig-deepagents
cargo test                        # Run tests (159)
cargo clippy -- -D warnings       # Lint (strict)
cargo build --features checkpointer-sqlite  # Build with features

ENVIRONMENT VARIABLES

Copy env.example to .env:

SUBDIRECTORY KNOWLEDGE

See AGENTS.md files in:

• research_agent/AGENTS.md - Orchestrator details
• context_engineering_research_agent/AGENTS.md - Context strategies
• deep-agents-ui/AGENTS.md - Frontend architecture
• tests/AGENTS.md - Test organization
• rust-research-agent/AGENTS.md - Rust overview (3 tiers)
• rust-research-agent/rig-deepagents/AGENTS.md - Middleware architecture
• rust-research-agent/rig-rlm/AGENTS.md - Recursive LLM pattern