Transitrix ADR SKILL.md skillA

Transitrix ADR from transitrix/methodology is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add transitrix/methodology/Transitrix ADR@git:20260816.66542bc

Pins git:20260816.66542bc in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
transitrix/methodology
Path
transitrix/skills/adr/SKILL.md
Versions recorded
3
Latest version
git:20260816.66542bc, committed Aug 16, 2026
First version recorded
Jul 21, 2026
Size
14,849 bytes
Repository stars
17
License
MIT

Help a user formulate an architecture decision and land it as a valid, gated Architecture Decision Record in the repo's per-repo decision log — the input door to the agent-authored decision flow method/07-decisions.md specifies but ships no workflow for. Runs a Context → Decision → Consequences interview, derives the id from today's date and a slug (no allocation step), validates against scripts/check-adl.mjs, and opens a PR. Never self-accepts a decision and never edits an accepted record's…

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

# Transitrix ADR Skill

Turns "we decided X" into a committed, `scripts/check-adl.mjs`-clean Architecture
Decision Record on a PR — without the user (or the calling agent) hand-writing the
front-matter, numbering the file, or working out the ratification gate themselves.
This is the **entry point** to the agent-authored decision flow
[`method/07-decisions.md`](../../../method/07-decisions.md)
specifies (§4) but ships no workflow for.

This directory is the **`adr` skill** within the `transitrix` plugin (the plugin root
is [`transitrix/`](../../), which carries the shared
[`.claude-plugin/plugin.json`](../../.claude-plugin/plugin.json) manifest, one
`skills/<name>/` directory per skill). Invoked as `/transitrix:adr`. Written for any
coding agent that can read/write files and run shell commands, not only Claude Code —
same portability discipline as every other skill in this plugin.

Mechanism this skill sequences (read before or during first use):
[`method/07-decisions.md`](../../../method/07-decisions.md) §2 (the per-repo record
shape, the `author`/`source` fields) and §4–§7 (the ratification gate, immutability,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add transitrix/methodology/Transitrix ADR@sha256:c1aa0ec51a40c384

The line at the top of this page pins the label git:20260816.66542bc, 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_lqu5xmdlpp7swvnd.svg)](https://markdownregistry.com/a/art_lqu5xmdlpp7swvnd)

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

Versions

The registry has recorded 3 versions of this file, between Jul 21, 2026 and Aug 16, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20260816.66542bc latest2026-08-16 66542bc 14,849 BA view · diff
git:20260728.642e9d32026-07-28 642e9d3 14,793 BA view · diff
git:20260721.dad91d82026-07-21 dad91d8 14,314 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14849 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

transitrix/methodology · 17 stars · license MIT · pushed 2026-10-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lqu5xmdlpp7swvnd
GET https://markdownregistry.com/api/v1/resolve?ref=transitrix/methodology/Transitrix ADR
GET https://markdownregistry.com/api/v1/blob/c1aa0ec51a40c384b6a593b4df8ca1e67a32a212477a856482847d98e9176161

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: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from transitrix/methodology

Transitrix Feedback SKILL.md skill
transitrix/methodology · transitrix/skills/feedback/SKILL.md · Author an upstream methodology-directed finding as a gated, anonymised entry in the repo's own feedback journal…
git:20261007.aa8e844 · audit A · 17 stars
Transitrix Adoption Health Profile SKILL.md skill
transitrix/methodology · transitrix/skills/health-profile/SKILL.md · Collect an informational six-indicator adoption-health snapshot with explicit supported, unavailable and unknown…
git:20261003.c1599c2 · audit A · 17 stars
Transitrix Ingest SKILL.md skill
transitrix/methodology · transitrix/skills/ingest/SKILL.md · Turn raw organisational material (interviews, policies, org charts, spreadsheets, notes) into Transitrix field…
git:20261007.aa8e844 · audit A · 17 stars
Transitrix Knowledge Store SKILL.md skill
transitrix/methodology · transitrix/skills/knowledge-store/SKILL.md · Ingest raw source material into the OKF single-repo MVP knowledge store — assess, archive, route to the OKF track…
git:20261007.aa8e844 · audit A · 17 stars
Transitrix Onboarding SKILL.md skill
transitrix/methodology · transitrix/skills/onboard/SKILL.md · Scaffold a new Transitrix architecture-as-text repository (zoned canon/ + field/ + codex/ layout with assistant-neutral…
git:20261007.aa8e844 · audit A · 17 stars
AGENTS.md@transitrix/skills/onboard/templates AGENTS.md file
transitrix/methodology · transitrix/skills/onboard/templates/AGENTS.md
git:20261007.aa8e844 · audit A · 17 stars
Transitrix Reg-Intel SKILL.md skill
transitrix/methodology · transitrix/skills/reg-intel/SKILL.md · Collect regulatory-source changes in practice — the operational counterpart to the methodology's codex / SEGMENT /…
git:20261007.aa8e844 · audit A · 17 stars
render-dsm-capabilities-html SKILL.md skill
transitrix/methodology · transitrix/skills/render-dsm-capabilities-html/SKILL.md · Render DSM-style business capability maps as portable interactive HTML and native SVG, with dated snapshots…
v6.8.2 · audit A · 17 stars
Transitrix Repo-Check SKILL.md skill
transitrix/methodology · transitrix/skills/repo-check/SKILL.md · Read-only health check ("doctor") for a Transitrix adopter repository. Emits a short, DATA-FREE report — methodology…
git:20260705.0345e6b · audit A · 17 stars
Transitrix Report SKILL.md skill
transitrix/methodology · transitrix/skills/report/SKILL.md · Produce a compliance report (obligation × subject impact matrix, or per-regime coverage metric) from a Transitrix…
git:20260827.a2eb126 · audit A · 17 stars
Transitrix Status SKILL.md skill
transitrix/methodology · transitrix/skills/status/SKILL.md · On-demand view of what is waiting behind every human gate in a Transitrix adopter repository — ADR…
git:20260816.66542bc · audit A · 17 stars

Every file in transitrix/methodology

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