goldfxgraph: Instructions file for Codex

AGENTS.md

1. Project Identity

This repository is GoldFXGraph.

GoldFXGraph is a full-stack gold research project for XAUUSD daily and near-real-time analysis.

The system should:

• read real XAUUSD market data
• fetch current/latest gold data when required
• compute deterministic technical indicators
• run explicit LangGraph multi-agent analysis
• produce structured forecast results
• persist research runs and forecasts
• display the forecast result in a Vue 3 + Tailwind frontend

This project is for research and decision support only.

Do not implement automatic trading, broker integration, real order execution, MCP, n8n, multi-model routing, full evaluation jobs, scorecards, or complex observability unless explicitly requested.

---

2. Repository Layout

Use a professional full-stack layout.

Expected structure:

goldfxgraph/
├── AGENTS.md
├── README.md
├── pyproject.toml
├── docker-compose.yml
├── .env.example
├── openspec/
├── data/
│   └── raw/
├── src/
│   └── goldfxgraph/
├── tests/
└── apps/
    └── web/
        ├── package.json
        ├── index.html
        ├── vite.config.ts
        ├── tailwind.config.ts
        ├── postcss.config.js
        └── src/
            ├── main.ts
            ├── App.vue
            ├── router/
            │   └── index.ts
            ├── styles/
            │   └── main.css
            ├── pages/
            │   └── GoldForecastDashboard.vue
            ├── components/
            ├── services/
            ├── types/
            └── constants/

Backend application code must live under:

src/goldfxgraph/

Backend tests must live under:

tests/

Frontend application code must live under:

apps/web/src/

Frontend global CSS must live under:

apps/web/src/styles/main.css

OpenSpec files must live under:

openspec/

Do not invent a different package structure unless the user explicitly approves it.

---

3. OpenSpec Rules

This project uses OpenSpec for non-trivial changes.