Imported from joe7hu/market (
AGENTS.md). Install upstream withnpx skills add joe7hu/market. Copyright stays with the author.
Market Project Instructions
Market is an active implementation project under /Users/joehu/proj/market.
Brain Wiring
Joe's durable brain is at /Volumes/agent/brain, backed by the Synology NAS.
Market should consume Arco artifacts through this NAS brain path directly,
not through the legacy /Users/joehu/brain symlink.
Before changing Market strategy, data model direction, Arco/Birdclaw integration, investment workflow, or durable project assumptions, read:
brain contextbrain project marketbrain project arcobrain project birdclawbrain skill project-session
Implementation changes happen in this repo. Durable decisions, summaries, timelines, and cross-project lessons should be written back to the brain.
Project Boundary
- Do not move source code into the brain.
- Do not copy secrets, brokerage credentials, local databases, browser/session data, or paid-provider keys into the brain.
- Consume Arco evidence from
/Volumes/agent/brain/raw/sources/arco. - Link to files and docs from the brain instead of duplicating large content.
Local App Run Preference
When Joe asks to start or run the Market app, bind both the API and frontend to all interfaces so the app can be browsed from another local device:
- API:
uv run uvicorn investment_panel.api.main:app --reload --host 0.0.0.0 --port 8010 - Frontend:
npm --prefix frontend run dev
Navigation and checks
- Architecture:
ARCHITECTURE.mdandscripts/architecture_inventory.py. - Factors:
src/investment_panel/domain/factors/; signals:domain/signals/; strategy calculations:domain/strategies/implementations.py; bindings and definitions:domain/strategies/catalog.py. - Strategy sequencing and replay:
workflows/strategies.py; PostgreSQL resolution/evidence:infrastructure/postgres/strategy_factory.py. - Run the affected focused test first, then
make guards,make check, and the finalmake release-gatefor an integrated candidate.