Skip to content

Repository files navigation

CALM Tutorial

validate License GitHub stars Last commit Open issues

A FINOS CALM primer for architects in regulated financial environments.

CALM Tutorial hero — the Common Architecture Language Model

About

Introduces the FINOS Common Architecture Language Model (CALM) for architects working in regulated industries — banking, payments, and capital markets. Ships as a single self-contained index.html file with no build step, no framework, and no server. Covers the core primitives (nodes, interfaces, relationships, controls, flows), regulatory evidence mapping (DORA, PCI DSS, MAS TRM, APRA CPS 234, HKMA TM-G-1, OSFI B-13, SWIFT CSCF), an Ubuntu 26.04 install guide, the official conference-signup tutorial with a self-hosted CALM Hub, and a glossary. Commands, versions, and clause citations were verified against primary sources as of July 2026 (spec release 1.2, CLI 1.47).

Usage

# open directly
xdg-open index.html        # Linux
open index.html            # macOS

# or serve over HTTP
python3 -m http.server 8080

Project Structure

.
├── .claude/           # Stop hook — blocks "done" until the page validates
├── .github/           # CI — runs the style-guide validator on push and PR
├── CLAUDE.md          # project rules: single-file constraint, verify loop, accuracy bar
├── index.html         # the entire site
├── presentation.html  # 16:9 slide deck generated from index.html
├── screenshot.mjs     # Playwright capture harness (mobile / tablet / desktop)
├── scripts/           # one-shot helpers (e.g. capture-hero.mjs)
├── assets/            # committed images referenced from the README
└── package.json       # one dependency: playwright

Development

npm run validate      # style-guide rules on both HTML files
npm run screenshots   # capture mobile / tablet / desktop into screenshots/

validate resolves the checker from a local skill-style-guide checkout; set STYLE_GUIDE=/path/to/skill-style-guide if yours lives somewhere other than ~/.claude/skills/skill-style-guide. CI checks the skill out automatically, so a pull request is validated whether or not you have it installed.

Contributing

Issues and pull requests welcome. Please open an issue first to discuss substantial changes.

License

MIT © 2026 James Buckett

Releases

Packages

Contributors

Languages