frankfurter: Skill for Claude Code

Pegs Policy

The bar for entries in db/seeds/pegs/. The file is small, load-bearing, and easy to corrupt with well-meaning additions. This skill defines what qualifies and what doesn't.

The Bar

A currency belongs in pegs.json only if all of the following are true:

1. Officially asserted by an issuing authority (central bank, monetary authority, currency board, or government).
2. Currently in force — not historical. If a peg ended, remove the entry; don't keep it with a sunset date.
3. A specific rate is asserted, not a band, target, or "managed float."
4. A primary source exists: the issuing authority's own page, a treaty, or legislation. Wikipedia is acceptable as a fallback for long-standing colonial / dependency pegs (FKP, SHP, GGP, IMP, JEP, BMD, BTN, MOP, CVE, ANG, QAR, OMR) where the authority doesn't publish a dedicated peg page, but a central-bank URL is preferred whenever available.

If any one of these fails, the currency does not belong in the file.

What Does Not Qualify

• De facto pegs: stable in practice but never officially declared. Example: AZN/USD has been flat at 1.7 since May 2017, but CBAR has not asserted a peg. Adding it makes us responsible if it breaks.
• Crawling pegs / managed floats: the rate moves within a band (e.g., CNY) or is "managed" without a fixed target.
• Currency boards with derived rates: if the rate is mechanically derived from another (e.g., dollarization), the currency is its base — no peg row needed unless there's a non-1 multiplier.
• Historical pegs: if a peg has ended, it does not belong here. Look up the current regime.
• Forecasts or expectations: "expected to peg" or "will likely peg." Wait until it's official.

Schema

Each entry in db/seeds/pegs/:

{
  "quote": "AED",
  "base": "USD",
  "rate": 3.6725,
  "since": "1997-11-02",
  "authority": "Central Bank of the UAE",
  "source": "https://www.centralbank.ae/en/our-operations/currency-operations/exchange-rates"
}