Expand CLAUDE.md with comprehensive AI assistant guide#248
Open
Wei Wang (weiwangdd) wants to merge 2 commits intolangchain-ai:mainfrom
Open
Expand CLAUDE.md with comprehensive AI assistant guide#248Wei Wang (weiwangdd) wants to merge 2 commits intolangchain-ai:mainfrom
Wei Wang (weiwangdd) wants to merge 2 commits intolangchain-ai:mainfrom
Conversation
Rewrites the existing CLAUDE.md with a thorough reference guide covering: - Full graph architecture (3-layer: main graph → supervisor subgraph → researcher subgraph) - All state classes and their fields (AgentState, SupervisorState, ResearcherState, etc.) - Complete Configuration field reference with defaults and descriptions - SearchAPI enum options and provider compatibility notes - All utility functions and tools with descriptions - Environment variable reference - Prompt template inventory with placeholders - Security/auth architecture - Evaluation system overview - Key conventions: async patterns, structured output, token limit recovery, Command routing, MCP auth - Guidelines for common modifications (new search provider, new model, new node) https://claude.ai/code/session_01SQoRgmVTSTSq1YkcnVxpLH
Visual PNG diagram covering: - Layer 1: Main Graph (clarify → brief → supervisor → report) - Layer 2: Supervisor Subgraph (supervisor ⇄ supervisor_tools loop) - Layer 3: Researcher Subgraph (researcher ⇄ tools → compress) - Tool breakdown: Search Tools, MCP Tools, think_tool - State Classes reference (AgentState, SupervisorState, etc.) - Configuration field reference with defaults White background, large font, 150 dpi. https://claude.ai/code/session_01SQoRgmVTSTSq1YkcnVxpLH
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Significantly expanded
CLAUDE.mdfrom a brief project overview into a comprehensive guide for AI assistants working with the codebase. The new documentation provides detailed architectural information, configuration reference, and development patterns to enable effective code modifications and maintenance.Key Changes
override_reducerpatternConfigurationsettings with defaults and descriptions; documentedSearchAPIenum and model string formatutils.py, including API key resolution and token limit handlingsrc/security/auth.pyNotable Details
src/open_deep_research/andtests/should be modified;src/legacy/is deprecatedoverride_reducerpattern for list field updates in stateMODEL_TOKEN_LIMITSdictionary as a key reference point for token limit recoveryGET_API_KEYS_FROM_CONFIGenvironment variable for Open Agent Platform deploymentshttps://claude.ai/code/session_01SQoRgmVTSTSq1YkcnVxpLH