Conversation
Clears the way for migrating Agent capabilities to OpenAI Agents SDK
(see archive/agent-runtime-final on origin for the snapshot of the
removed code; PR2-PR4 will rebuild on the new architecture).
Modules deleted (no internal dependents remain in surviving code):
- quantmind/brain/ (MultiStepAgent / ToolCallingAgent / Memory)
- quantmind/tools/ (custom Tool ABC + validators; replaced by SDK @function_tool)
- quantmind/storage/ (no users; future KnowledgeStore will live in knowledge/)
- quantmind/tagger/ (tagging becomes a flow-level concern)
- quantmind/models/{agent,memory,messages}.py
- quantmind/utils/{agentic_ext,monitoring}.py
Also removed:
- vendored smolagents/ working copy
- LICENSE-APACHE (no Apache-licensed code remains)
- All examples (will be re-added per-flow in later PRs)
- Tests for the deleted modules (tests/{brain,tools,storage,tagger}/ and the
agent/memory/messages model tests)
- Stale dead deps from pyproject.toml: camel-ai, networkx, scikit-learn,
pyvis, plotly
- Stale CLI entrypoint reference (quantmind_cli.py never existed)
Modules retained for now (will be replaced/migrated in PR2-PR4 per the
new architecture):
- quantmind/flow/, llm/, parsers/, sources/, config/
- quantmind/models/{content,paper,analysis}.py
Verification: 192 tests pass.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Rewrites CLAUDE.md so a future Claude session opening this repo can quickly understand the architectural direction (lib on top of OpenAI Agents SDK, NOT a framework), the transitional module map, the conventions to follow, and the explicit anti-patterns to avoid. New sections: - Target Architecture (the 5 future modules + magic.py) - Current Repository State (transitional module table) - Architecture Principles (8 principles distilled from design doc) - Conventions When Editing (schemas / configs / tools / memory / tests / imports) - Things NOT to Do (8 explicit anti-patterns including no CLI, no agent framework rebuild, no batch+memory mixing in MVP) - Reference Material (SDK docs URLs + archive branch) - Roadmap table (PR2-PR6+) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a Communication Conventions section to make explicit that PR descriptions, issue bodies, and commit messages must be in English so external readers (search indexers, future maintainers, contributors) can follow the history. Inline review comments / discussion threads can stay in whichever language fits the participants. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Part of #71 (Migration to OpenAI Agents SDK).
Summary
brain/,tools/,storage/,tagger/, etc.) introduced in PRs feat(tools): introduce tool abstraction and decorator #61/refactor(tools): rearchitect the agent tooling system based on smolagents #65/feat(memory): implement core memory and agentic components #67 to clear the way for the OpenAI Agents SDK migration in PR2-PR4.archive/agent-runtime-finalbranch.What's Deleted
Self-built agent runtime (no internal dependents in surviving code):
quantmind/brain/—MultiStepAgent/ToolCallingAgent/Memoryquantmind/tools/— customToolABC and validators (replaced by SDK@function_tool)quantmind/storage/—LocalStorage(no users; futureKnowledgeStorewill live inknowledge/)quantmind/tagger/— tagging becomes a flow-level concernquantmind/models/{agent,memory,messages}.pyquantmind/utils/{agentic_ext,monitoring}.pyPeripheral cleanup:
smolagents/working copyLICENSE-APACHE(no Apache-licensed code remains)examples/(will be re-added per-flow in later PRs)pyproject.toml:camel-ai,networkx,scikit-learn,pyvis,plotlyquantmind_cli:mainentry point (the file never existed)Also refines:
CLAUDE.mdrewritten with post-pivot guidance (target architecture, conventions, anti-patterns, reference URLs)Communication Conventionssection inCLAUDE.mdrequiring English for PR descriptions, issue bodies, and commit messagesWhat's Retained
The following modules continue to compile and ship in PR1; they will be replaced or migrated in PR2-PR4:
quantmind/flow/,llm/,parsers/,sources/,config/quantmind/models/{content,paper,analysis}.pyquantmind/utils/logger.py(kept long-term)Verification
pytest tests/passes (192 passed; 19 deprecation warnings come from Pydantic v1 patterns and are unrelated to this PR)python -c "import quantmind; from quantmind.flow import BaseFlow; from quantmind.models import Paper; from quantmind import config"succeedsgit grep -E 'quantmind\.(brain|tools|storage|tagger|models\.(agent|memory|messages)|utils\.(agentic_ext|monitoring))'returns zero hits in retained codeRoadmap (subsequent PRs)
See #71 for the umbrella tracking issue. High-level direction:
knowledge/+configs/skeleton (Pydantic schema standard + centralized cfg)preprocess/two-layer structure (fetch + format)flows/+paper_flow+batch_run+magic.py; concurrent removal offlow/andllm/mind/memory/filesystemMVP + trajectory archiveKnowledgeStore🤖 Generated with Claude Code