DESIGN.md@strategies/craneA

DESIGN.md@strategies/crane from senpi-ai/senpi-skills is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add senpi-ai/senpi-skills/strategies/crane/DESIGN.md@git:20260713.753da36

Pins git:20260713.753da36 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
senpi-ai/senpi-skills
Path
strategies/crane/DESIGN.md
Versions recorded
1
Latest version
git:20260713.753da36, committed Jul 13, 2026
Size
4,737 bytes
Repository stars
144
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Crane — Managed Pairs / Stat-Arb (BLOCKED on a runtime capability)

**Status: engine complete + unit-tested; NOT deployable.** Crane needs coordinated
multi-leg close, which the current Runtime 3.0 scanner contract does not expose.
This doc records the design, the exact gap, and how to wire it when the capability
lands. The scanner ships **disarmed** (`inputs.armed: false`) so it can never open a
pair it cannot manage.

## What it does
Market-neutral. For a correlated pair `(A, B)` it tracks the log price spread
`ln(A/B)`, z-scores it over a rolling window, and trades the **spread**:
- `|z| ≥ entryZ` → short the rich leg, long the cheap leg (equal notional).
- `|z| ≤ exitZ` → revert: close both legs.
- `|z| ≥ stopZ` → blowout: close both legs.
- The two legs are **one position** — they open together and close together.

The alpha is in `main/scanners/scoring.py` (pure, `test_engine.py` green): spread,
z-score (guards a full window + non-zero dispersion), the pair state machine, entry
directions, z-scaled sizing.

## The safety core — why DSL-only cannot do this
A pair with only one leg left is a **naked directional bet**. If the two legs exit
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add senpi-ai/senpi-skills/strategies/crane/DESIGN.md@sha256:d4971b21bd50b338

The line at the top of this page pins the label git:20260713.753da36, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_maj645fmhsz5kier.svg)](https://markdownregistry.com/a/art_maj645fmhsz5kier)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 13, 2026.

versioncommittedcommitsizeaudit
git:20260713.753da36 latest2026-07-13 753da36 4,737 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (4737 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

senpi-ai/senpi-skills · 144 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_maj645fmhsz5kier
GET https://markdownregistry.com/api/v1/resolve?ref=senpi-ai/senpi-skills/strategies/crane/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/d4971b21bd50b3389ac20ae01ce1e258dbc1467717e56f0b1ed402ff7ffa79c8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what DESIGN.md is and how agents use it · which agent file does what.

More from senpi-ai/senpi-skills

CLAUDE.md CLAUDE.md file
senpi-ai/senpi-skills · CLAUDE.md
git:20260814.c81aa03 · audit A · 144 stars
quant-desk SKILL.md skill
senpi-ai/senpi-skills · quant-desk/SKILL.md · **Quant Desk** — the desk your **AI Quant** produces. Users reach it by either name, spaced or hyphenated: "run AI…
v1.49.3 · audit A · 144 stars
senpi-account-status SKILL.md skill
senpi-ai/senpi-skills · senpi-account-status/SKILL.md · Show the user's standing across Senpi programs — points and rank, the Senpi trading fee (none on a paid plan), referral…
v1.10.0 · audit A · 144 stars
senpi-deposit-withdraw-transfer SKILL.md skill
senpi-ai/senpi-skills · senpi-deposit-withdraw-transfer/SKILL.md · Handle ANY money-movement request — deposit, add funds, fund my account, "buy USDC", "pay with a card", withdraw, cash…
v1.6.2 · audit A · 144 stars
senpi-improve-trades SKILL.md skill
senpi-ai/senpi-skills · senpi-improve-trades/SKILL.md · Retrospective trade review + improvement coaching for the user's Senpi trading. Answers "did I sell too early or late"…
v1.24.5 · audit A · 144 stars
senpi-market-pulse SKILL.md skill
senpi-ai/senpi-skills · senpi-market-pulse/SKILL.md · Answer "what's happening in the markets today?" with structured cross-asset analysis, not just "BTC is up." Use for…
v1.10.0 · audit A · 144 stars
senpi-portfolio SKILL.md skill
senpi-ai/senpi-skills · senpi-portfolio/SKILL.md · Analyze the user's portfolio, strategies, positions, and trades across all wallets — main embedded wallet, strategy…
v1.36.5 · audit A · 144 stars
senpi-signals SKILL.md skill
senpi-ai/senpi-skills · senpi-signals/SKILL.md · Senpi Signals: the non-obvious reads on Hyperliquid that a price screen can't show — the proven cohort against the 4h…
v2.11.0 · audit A · 144 stars
senpi-smart-money SKILL.md skill
senpi-ai/senpi-skills · senpi-smart-money/SKILL.md · Answer "where is smart money moving?" — show where the most-profitable Hyperliquid wallets are positioned, where they…
v1.7.0 · audit A · 144 stars
senpi-strategy-author SKILL.md skill
senpi-ai/senpi-skills · senpi-strategy-author/SKILL.md · Build or edit a Senpi trading strategy — interactively, ONE decision at a time. There is no paper-trading mode: a…
v3.14.14 · audit A · 144 stars
senpi-strategy-discover SKILL.md skill
senpi-ai/senpi-skills · senpi-strategy-discover/SKILL.md · Help a user choose a Senpi trading strategy to deploy — a conversational, analyst-style picker. Use when the user asks…
v2.52.0 · audit A · 144 stars
senpi-strategy-ops SKILL.md skill
senpi-ai/senpi-skills · senpi-strategy-ops/SKILL.md · Deploy / monitor / close a NAMED Senpi trading strategy. Monitoring is on demand: never an agent-turn cron to watch a…
v3.29.4 · audit A · 144 stars

Every file in senpi-ai/senpi-skills

Browse by kind, by grade A, or by owner.