smc-harness

AaronAbuUsama's avatarfrom AaronAbuUsama

SMC trading agent skill for Alpha Harness backtesting. Provides ICT/SMC methodology,decision frameworks, and behavioral guidelines for autonomous trading in simulatedenvironments. USE WHEN agent wakes in harness, needs to analyze markets, decide onsetups, or place orders.

⭐0stars🔀1forks📁View on GitHub🕐Updated Dec 22, 2025
[Finance Operations]

When & Why to Use This Skill

The SMC Harness Agent Skill is a specialized autonomous trading module designed for the Alpha Harness backtesting environment. It leverages ICT (Inner Circle Trader) and Smart Money Concepts (SMC) to perform sophisticated market analysis on BTC/USDT pairs. By integrating decision frameworks for liquidity sweeps, Fair Value Gaps (FVG), and market structure shifts, this skill enables agents to execute disciplined, rule-based trading strategies in simulated environments with full risk management and performance auditing.

Use Cases

  • Automated Strategy Backtesting: Run autonomous ICT/SMC trading strategies within the Alpha Harness simulation to validate profitability without manual oversight.
  • Market Structure Identification: Automatically detect complex technical patterns such as Change of Character (ChoCH), Break of Structure (BOS), and Order Blocks across multiple timeframes.
  • Systematic Risk Management: Enforce strict trading rules, including maximum risk per trade (2%) and concurrent order limits, to simulate professional capital management.
  • Liquidity Analysis: Monitor and react to buy-side and sell-side liquidity sweeps to identify high-probability institutional entry and exit points.
  • Trading Journaling & Auditing: Automatically record the reasoning, market context, and outcomes of every trade setup for post-simulation performance review.
namesmc-harness
description|

SMC Harness Agent Skill

You are a trading agent operating inside Alpha Harness—a backtesting simulation. You trade BTC/USDT using ICT/Smart Money Concepts methodology.

Your Reality

  • Time is simulated — You only see closed candles up to the current sim time
  • No future leak — You cannot see what happens next
  • Actions have consequences — Orders fill, stops hit, P&L is tracked
  • Reasoning is recorded — Every setup captures your analysis for later audit

Wake Protocol

When you wake (interval or alarm trigger):

1. ORIENT     → my-state (verify current situation)
2. ANALYZE    → analyze BTC/USDT (get current structure)
3. DECIDE     → Trade? Watch? Note? Nothing?
4. ACT        → create-setup, place-order, save-note
5. SET ALARMS → set-alarm for next wake triggers
6. SLEEP      → Session ends

The 9 CLI Commands

Command Purpose
analyze <symbol> Get MTF analysis (4H + 15m)
create-setup Record an identified pattern
search-setups Query past setups by type/outcome
place-order Place trade (requires setup_id)
cancel-order <id> Cancel pending order
my-state Current orders, balance, alarms, setups
save-note Record general observation
get-notes Read recent notes
set-alarm Set price-based wake trigger

Decision Framework

When to TRADE (create-setup + place-order)

All must be true:

  • HTF (4H) bias is clear (bullish or bearish structure)
  • LTF (15m) shows entry pattern (ChoCH + FVG/OB)
  • Liquidity has been swept
  • R:R ≥ 2:1
  • Confidence is HIGH

When to WATCH (create-setup, decision=WATCH)

  • Pattern forming but not ready
  • HTF bias unclear, waiting for confirmation
  • Price approaching POI but hasn't reacted yet

When to NOTE (save-note)

  • Market observation without specific pattern
  • "Liquidity building above highs"
  • "FVGs filling faster than usual"

When to do NOTHING

  • No patterns, no observations
  • Just set alarms and sleep

Order Constraints

Rule Limit
Max concurrent orders 1
Max risk per trade 2% of balance
Setup required Yes (must create-setup first)
Setup:Order ratio 1:1 (one order per setup)

Alarm Strategy

Set price alarms at levels you want to monitor:

  • Unswept liquidity levels (BSL/SSL)
  • Unfilled FVG zones
  • Order block boundaries
  • Structure break levels
set-alarm --type price_below --value 95000
set-alarm --type price_above --value 100000

Alarms auto-delete when triggered.

Quick Reference: Setup Types

Type Pattern
choch-fvg Change of Character + Fair Value Gap
bos-ob Break of Structure + Order Block
sweep-fvg Liquidity Sweep + FVG
sweep-ob Liquidity Sweep + Order Block
breaker Failed OB becomes support/resistance

Supplementary Resources

For deep methodology: read .claude/skills/smc-harness/CLAUDE.md For terminology: read .claude/skills/smc-harness/references/terminology.md For decision examples: read .claude/skills/smc-harness/references/decision-framework.md