deep-code-agent: Instructions file for Codex

AGENTS.md - Deep Code Agent

Project Overview

Deep Code Agent is an AI-powered coding assistant built on the DeepAgents framework. It provides a multi-agent system with specialized subagents for various software development tasks.

Architecture

src/deep_code_agent/
├── __init__.py          # Package exports and entry point
├── __main__.py          # Module execution entry point
├── cli.py               # Command-line interface implementation
├── config.py            # Configuration constants and defaults
├── prompts.py           # System prompts and subagent configurations
├── code_agent.py        # Main agent creation and orchestration
├── models/
│   └── llms/
│       └── langchain_chat.py  # LLM integration layer
├── tools/
│   ├── __init__.py
│   └── terminal.py      # Terminal command execution tool
└── tui/                 # Terminal User Interface
    ├── __init__.py
    ├── app.py            # Main TUI application
    ├── bridge/            # Agent-bridge layer
    │   ├── __init__.py
    │   ├── agent_bridge.py
    │   └── stream_handler.py
    ├── screens/           # TUI screens
    │   ├── __init__.py
    │   ├── main_screen.py
    │   └── approval_modal.py
    ├── widgets/           # Reusable widgets
    │   ├── __init__.py
    │   ├── chat_log.py
    │   ├── input_box.py
    │   ├── message_bubble.py
    │   ├── side_panel.py
    │   ├── status_bar.py
    │   └── tool_call_view.py
    ├── styles/            # TUI styles
    │   ├── __init__.py
    │   └── main.tcss
    └── utils/
        └── __init__.py

Key Components

1. Config (config.py)

Centralized configuration for:

• Timeout settings (MAX_TIMEOUT=300, DEFAULT_TIMEOUT=30)
• Human-in-the-loop defaults (DEFAULT_INTERRUPT_ON)

2. Prompts (prompts.py)

Defines system prompt templates and subagent configurations:

• get_system_prompt(): Main agent system prompt
• create_subagent_configurations(): Creates 5 specialized subagents:
  • code_reviewer: Code review and quality analysis
  • test_writer: Test generation and TDD
  • documenter: Documentation creation
  • debugger: Debugging and error resolution
  • refactorer: Code refactoring and optimization