convez.ai
SkillFinanceiroAvançado
solidx86

Intraday Trade Mentor

solidx86/intraday-trade

Coach IA para trading intraday com journal schema-versionado e validação determinística

Ver no GitHub
InicialPluginScore · de 0 a 100

Suite de coaching multimodal com três skills Claude coordenadas para trading intraday. Integra pesquisa pré-mercado, crítica baseada em visão de screenshots gráficos e revisão semanal, com dados organizados em journal versionado com validação em CI.

Instalação

$npx convez-ai solidx86/intraday-trade

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise pré-mercado e briefing antes da sessão de trading
  • Crítica estruturada de trades via visão computacional de gráficos
  • Rastreamento semanal de lições e padrões de erro repetitivo

Veredito

Projeto bem arquitetado que demonstra design robusto de skills: contrato de dados claro entre componentes, validação determinística em CI, e foco em processo sobre resultados. Relevante para traders que buscam rigor operacional, mas requer compreensão técnica avançada do ecossistema Claude.

README

A tradução para o português deste README ainda está na fila.

Intraday Trade Mentor

— multimodal LLM coaching suite

CI

I trade US equities intraday from Malaysia. The work that actually compounds — pre-market research every evening, an honest post-mortem of every trade, a weekly look at the mistakes I keep repeating — is exactly the work that's easiest to skip after a losing day. So I built the coach that doesn't skip: three coordinated Claude skills that brief me before the session, grade every trade I take (from chart screenshots, via vision), and hold me accountable week over week. The interesting part isn't any single prompt — it's the data contract: the skills coordinate through a schema-versioned markdown journal, with one-way ownership rules and a deterministic validator suite enforcing the schema in CI.

How it flows

flowchart LR
    subgraph "before the session"
        PB["premarket-briefing\n(WebSearch + WebFetch + browser tape)"]
    end
    subgraph "after each trade"
        TM["intraday-trade-mentor\n(vision critique of chart screenshots)"]
    end
    subgraph "journal (data layer)"
        PM["daily/<date>/premarket.md"]
        TJ["daily/<date>/TICKER_dir_outcome.md"]
        IX["INDEX.md"]
        LL["LESSONS.md\n(lessons ledger)"]
    end
    subgraph "end of week"
        WR["weekly-trade-review\n(read-only aggregation)"]
        WK["weekly/YYYY-Www_weekly.md"]
    end
    PB -->|writes| PM
    TM -->|writes| TJ
    TM -->|appends| IX
    TM -->|proposes, user confirms| LL
    PM -.->|context| TM
    TJ -->|reads| WR
    IX -->|reads| WR
    LL -->|reads| WR
    WR -->|writes| WK

What's inside

  • Three production skills (*-skill/ directories): each a SKILL.md behavior spec plus references/ (rule books loaded at runtime), templates/, and evals/.
  • A journal schema designed for machine + human readers: per-trade files named TICKER_<L|S|NT>_<W|L|BE|SKIP>.md, co-located with that day's pre-market briefing so context and execution live in one folder.
  • A 9-point grading rubric (intraday-trade-mentor-skill/references/checklist.md): letter grades A–F derived from pass/fail checks, grading process, never P&L — a clean loss grades A, a sloppy win grades C.
  • A schema-versioned lessons ledger (references/lessons-ledger-spec.md): every lesson is a state machine (active → internalized / retired) whose transitions only the user can trigger — the LLM proposes, the human confirms. Design rationale: docs/lessons-ledger.md.
  • One-way data ownership across skills: the mentor writes the journal and owns the theme-tag canon; the weekly review is read-only and consumes a mirrored canon. A CI test fails if the mirror drifts from the source.
  • Anti-confabulation date logic (premarket-briefing-skill/references/trading-day-logic.md): the US trading day is computed from Malaysia local time (MYT→ET), never assumed.
  • Eval suites per skill (evals/evals.json) consumed by an external eval runner, plus the deterministic validator tests in tests/.
  • A public engineering backlog (docs/tasks.md): tracked follow-up improvements — process notes, not the shipped behavior spec.

Sample output

Rendered from the synthetic sample journal in examples/sample-journal/ — never a real trade.

Per-trade critique journalWeekly review
Sample trade critiqueSample weekly review

The eval layer

The skills emit markdown, so the test suite is a deterministic validator harness over tracked outputs (tests/, pytest, stdlib-only):

  • per-trade journals: filename grammar, all 12 template sections in order, checklist row count, grades within rubric bounds, theme tags ⊆ canon
  • INDEX.md ↔ per-trade files: every row resolves to a file, grades agree both ways
  • lessons ledger: frontmatter counters match the body, IDs unique and monotonic, statuses legal
  • premarket briefings: validated by the skill's own structural validator (7 sections in order, risk verdict, impact-labeled calendar, required global indices)
  • cross-skill drift: the weekly-review tag-canon mirror must match the mentor's canon exactly

CI runs the suite on every push.

Testing splits in two by design: CI validates outputs (deterministic, free, runs on every push), while generation quality — does the mentor grade a chase as a chase, does it refuse a critique with missing inputs — is covered by each skill's evals/evals.json, run against a live model via an external eval runner (skill-creator's iteration loop). LLM-in-the-loop evals are non-deterministic and cost tokens, so they gate skill iterations, not commits.

Stack at a glance

Claude Skills (markdown spec-driven agent design) · Claude vision (chart-screenshot critique) · WebSearch/WebFetch (live news harvest) · Playwright headless browser (bot-walled structured-data capture — CNBC tape, calendars) · Python + pytest (validator harness) · GitHub Actions (CI).

Data files & provenance

PathWhat it isWritten byRead byProvenance
examples/sample-journal/daily/*/premarket.mdPre-market briefingspremarket-briefingtrader, mentorSynthetic
examples/sample-journal/daily/*/TICKER_*.mdPer-trade critique journalsintraday-trade-mentorweekly-trade-reviewSynthetic
examples/sample-journal/INDEX.mdOne-row-per-trade indexintraday-trade-mentorweekly-trade-reviewSynthetic
examples/sample-journal/LESSONS.mdLessons ledger (state machine)intraday-trade-mentorboth skillsSynthetic
examples/sample-journal/weekly/*.mdWeekly review reportsweekly-trade-reviewtraderSynthetic
weekly-trade-review-skill/evals/fixtures/Eval fixture journalshand-authoredeval runner, testsSynthetic
intraday-trade-mentor-skill/evals/assets/Chart screenshots for evalsTradingView captureseval runnerReal charts, no account data
data/trade-journal/The real journal (same schema as the sample)premarket-briefing, intraday-trade-mentormentor, weekly-trade-review, traderPrivate repo journal/ mount, gitignored — absent on a fresh clone
data/framework/Full-parameter methodologytrader (by hand, private)mentorPrivate repo framework/ mount, gitignored — absent on a fresh clone

The real trade journal — actual trades, psychology notes — and the full-parameter methodology are deliberately not published; both are mounted from a private repo (see Public / private split below). The synthetic sample week exists so the schema, and the validators over it, are fully reviewable.

Public / private split

This public repo ships the engineering: the three skills, the journal schema, the lessons-ledger state machine, and the validator suite. Two things stay private and are mounted in via gitignored symlinks:

  • The trade journal (data/trade-journal/) — real trades and psychology notes, personal data.
  • The methodology (data/framework/) — the full-parameter grading rules. The public reference files are token-only; the operative parameters, pattern definitions, and breakout tell-set load from here when present, and the skill degrades gracefully when absent.

A fresh clone therefore runs the architecture but not the proprietary grading — the working showcase is the synthetic corpus in examples/sample-journal/. Both private pieces live in one private repo split into journal/ and framework/.

First-time setup (the private repo URL is fine to show — it's inaccessible to others):

git clone git@github.com:solidx86/intraday-trade.git         ~/Code/intraday-trade
git clone git@github.com:solidx86/intraday-trade-private.git ~/Code/intraday-trade-private

# two mounts into the private repo (both gitignored)
ln -s ~/Code/intraday-trade-private/journal   ~/Code/intraday-trade/data/trade-journal
ln -s ~/Code/intraday-trade-private/framework ~/Code/intraday-trade/data/framework

# skills live via ~/.claude/skills symlinks
ln -s ~/Code/intraday-trade/intraday-trade-mentor-skill ~/.claude/skills/intraday-trade-mentor
ln -s ~/Code/intraday-trade/premarket-briefing-skill    ~/.claude/skills/premarket-briefing
ln -s ~/Code/intraday-trade/weekly-trade-review-skill   ~/.claude/skills/weekly-trade-review

License & reuse

Source-available for portfolio review. All rights reserved — no open-source license is granted; please don't republish or reuse the skill content without permission. The trading methodology the mentor grades against derives from proprietary third-party training material. The public reference files are token-only by design: they carry the grading structure and opaque pattern labels (P1/P2/P3, grade letters) but no operative definitions, parameters, breakout tell-set, or source citations — those live only in a private supplement (see Public / private split above). No third-party material is included.

Disclaimer: personal tooling, shared as an engineering showcase. Nothing here is trading or financial advice.

Ver o original no GitHub

Bom para

Relacionados