brvm-trader

📈 BRVM Trader — Plugin Claude Code

Expert financier IA spécialisé sur la BRVM (Bourse Régionale des Valeurs Mobilières, Zone UEMOA). 4 agents spécialisés · 5 commandes slash · 13 modules de formation · Données live sikafinance.com

---

⚡ Installation

1. Ajouter le marketplace dans Claude Code (~/.claude/settings.json) :

{
  "extraKnownMarketplaces": {
    "brvm-trader": {
      "source": { "source": "github", "repo": "elysee15/financial-analyst" }
    }
  }
}

2. Installer le plugin :

claude plugin marketplace add brvm-trader@brvm-trader

3. Lancer :

/brvm-trader

Hooks recommandés (optionnels, dans ~/.claude/settings.json)

Ces hooks améliorent l'expérience mais ne sont pas obligatoires :

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "test -f \"$HOME/.claude/courses/progress.md\" && echo '{\"systemMessage\": \"📊 Progression BRVM chargée\"}' || echo '{\"systemMessage\": \"👋 Lance /brvm-trader pour démarrer ta formation BRVM\"}'",
        "timeout": 5
      }]
    }],
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.file_path // empty' | grep -q 'progress\\.md' && echo '{\"systemMessage\": \"✅ Progression sauvegardée\"}' || true",
        "timeout": 5
      }]
    }]
  }
}

---

🗺️ Architecture

financial-analyst/
│
├── agents/                         ← 4 agents spécialisés
│   ├── marche.md                   ← Données live sikafinance.com
│   ├── stratege.md                 ← Score /10 + verdict + stratégie
│   ├── formateur.md                ← Formation interactive + progression
│   └── portefeuille.md             ← Positions + stop-loss + alertes
│
├── commands/                       ← 5 commandes slash
│   ├── analyse.md                  ← /analyse [TICKER]
│   ├── marche.md                   ← /marche
│   ├── formation.md                ← /formation [module]
│   ├── portefeuille.md             ← /portefeuille
│   └── dividendes.md               ← /dividendes
│
├── skills/
│   └── brvm-trader/
│       ├── SKILL.md                ← Orchestrateur principal
│       ├── courses/
│       │   ├── niveau1/            ← 5 modules .mdc (initiation)
│       │   ├── niveau2/            ← 4 modules .mdc (analyse)
│       │   └── niveau3/            ← 4 modules .mdc (stratégies)
│       └── data/
│           ├── valeurs_brvm.md     ← Tickers + profils fondamentaux
│           ├── strategies_avancees.md ← Patterns trading avancés
│           ├── news_et_communiques.md ← Actualités et alertes
│           ├── watch_list.md       ← Template positions (ignoré git)
│           ├── market_snapshot.md  ← Dernière valeur connue entre sessions
│           ├── data_freshness.json ← Timestamps des derniers fetches
│           └── cache/              ← Cache daté YYYY-MM-DD_[source].md
│
├── .claude/
│   └── settings.json               ← Hooks SessionStart + PostToolUse
│
├── .claude-plugin/
│   ├── marketplace.json            ← Listing marketplace
│   └── plugin.json                 ← Agents + Skills + Commands
│
└── README.md

---

🤖 Les 4 agents

brvm-marche — Données Live

Source unique de données de marché. Fetche sikafinance.com et retourne des structures normalisées consommables par les autres agents.

• Cotation individuelle : cours, RSI, Beta, volumes, perfs, dividende, PER
• Palmarès du jour : top hausses/baisses/volumes + indices
• Dividendes : calendrier complet avec yields
• Actualités : news et alertes CREPMF
• Cache daté : vérifie skills/brvm-trader/data/cache/YYYY-MM-DD_[source].md avant tout fetch — réutilise si disponible, sauvegarde après fetch réussi

brvm-stratege — Analyse Stratégique

Transforme les données brutes en décisions d'investissement structurées.

• Score technique /5 (RSI, Beta, momentum, volume, trend YTD)
• Score fondamental /5 (yield, bénéfices, capitalisation, backing, PER)
• Verdict ACHAT FORT 🟢 / ACHAT PARTIEL 🟡 / PASSER 🔴
• Sélection de stratégie adaptée (DCA, Buy&Hold, Momentum, Capture dividende, Contrarian)
• Niveaux opérationnels : entrée, stop-loss -15%, objectifs 3m et 12m
• Checklist pré-achat 15 critères

brvm-formateur — Formation Interactive

Gère intégralement le parcours pédagogique sans aucune ligne de commande.