docs: sync README with latest framework improvements

- Add Decision calibration and Multi-source confirmation to Why it works
- Fix remaining Hermes-only wording in command descriptions
- Add platform.json example in Quick Start
- Expand Directory Layout and References to include all reference docs
- Add Decision calibration, Multi-source confirmation, and Prediction tracking to Safety table

README.md

@@ -28,6 +28,8 @@
 
 - **Portfolio-first rule** — every decision anchors to your real balances, average costs, and exchange state.
 - **Scientific checklist** — 6 mandatory questions (trend, volume, levels, BTC context, opportunity cost, time window) before every trade.
+- **Decision calibration** — every trade decision must output a JSON skeleton with `confidence`, `risk_reward`, `stop_loss`, and `take_profit` before execution. No gut-feeling entries.
+- **Multi-source confirmation** — signals are trusted only when confirmed by 2+ independent data sources (e.g. price action + DEX flow, or CEX rumor + on-chain growth).
 - **Hourly self-review** — the bot critiques its own decisions, flags over-trading / hesitation, and tunes parameters.
 - **Prediction tracking** — every decision writes an auditable prediction to `logs/predictions_YYYYMMDD.jsonl`; the review loop scores accuracy and surfaces systematic bias.
 - **Ultra-low running cost** — a lightweight local **gate** filters noise; the LLM only wakes up when the market actually changes.
@@ -58,7 +60,7 @@ All operations go through the installed `coinhunter` CLI. This skill provides th
 |---------|---------|
 | `coinhunter probe` | Market data fetcher (ccxt + web search) |
 | `coinhunter pre` | **Lightweight gate** — computes adaptive thresholds and decides if analysis is needed |
-| `coinhunter gate` | Optional **system-crontab wrapper** that runs the gate entirely outside Hermes |
+| `coinhunter gate` | Optional **system-crontab wrapper** that runs the gate entirely outside the platform cron |
 | `coinhunter exec` | Order execution layer with idempotency & precision validation |
 | `coinhunter review` | Generate compact review context for the agent |
 | `coinhunter recap` | Hourly quality review & parameter optimization |
@@ -102,6 +104,18 @@ Create your initial `positions.json`:
 }
 ```
 
+*(Optional)* If you use OpenClaw (or another non-Hermes runtime), create `platform.json`:
+
+```json
+{
+  "platform": "openclaw",
+  "scripts_dir": "~/.openclaw/scripts",
+  "env_file": "~/.openclaw/.env",
+  "cron_command": ["openclaw", "trigger"],
+  "delivery": "webhook"
+}
+```
+
 ### 4. Deploy the shims
 
 Copy the unified shim into your platform's scripts directory. It accepts the subcommand as its first argument:
@@ -149,6 +163,8 @@ Put this in your system crontab to run the gate every **5 minutes** without ever
 */5 * * * * /usr/bin/env coinhunter gate >> /home/user/.coinhunter/logs/external_gate.log 2>&1
 ```
 
+> The gate reads `~/.coinhunter/platform.json` to know which command triggers your platform's cron. If the file is absent, it defaults to `hermes cron run`.
+
 ---
 
 ## 🛡️ Safety & Hardening
@@ -164,6 +180,9 @@ Coin Hunter enforces **production-grade safeguards** out of the box:
 | **Fee buffer** | 2%–5% USDT is always left unallocated to prevent "insufficient balance" rejections |
 | **Position sizing limits** | `<$50` → 1 coin only. `$50–$200` → max 2 positions. `>$200` → max 3 positions. |
 | **No leverage for small capital** | Leverage/futures are blocked when total capital < $200 |
+| **Decision calibration** | Every trade requires a JSON skeleton with confidence ≥ 0.55 and explicit stop-loss / take-profit |
+| **Multi-source confirmation** | Signals must be confirmed by 2+ independent sources; single-source narratives are downgraded |
+| **Prediction tracking** | Predictions are logged and scored during hourly review to surface systematic bias |
 
 ---
 
@@ -202,7 +221,11 @@ coinhunter/
     ├── review-template.md
     ├── provider-playbook.md
     ├── user-data-layout.md
-    └── scam-signals.md
+    ├── scam-signals.md
+    ├── auto-trading-guide.md
+    ├── output-templates.md
+    ├── search-workflow.md
+    └── shim-templates.md
 ```
 
 Your **private runtime** lives under `~/.coinhunter/`:
@@ -232,6 +255,10 @@ Your **private runtime** lives under `~/.coinhunter/`:
 - [`references/review-template.md`](./references/review-template.md) — Hourly report format
 - [`references/provider-playbook.md`](./references/provider-playbook.md) — Data source selection
 - [`references/scam-signals.md`](./references/scam-signals.md) — Meme-coin red flags
+- [`references/auto-trading-guide.md`](./references/auto-trading-guide.md) — Binance API auto-trading setup
+- [`references/output-templates.md`](./references/output-templates.md) — Triage and report templates
+- [`references/search-workflow.md`](./references/search-workflow.md) — Proactive discovery workflow
+- [`references/shim-templates.md`](./references/shim-templates.md) — Shim usage guide
 - [`SKILL.md`](./SKILL.md) — Complete architecture & step-by-step gate build guide
 
 ---