CARL badges are SVG images served from carl.wentzel.ai that display a
repository's most recent CARL level. They update automatically when a new report
is published for that repository (cached for one hour on the Cloudflare edge
with appropriate cache-bust on new reports).
Usage
Once the badge service is live, drop the badge into your README:
[](https://carl.wentzel.ai/report/<owner>/<repo>)
Replace <owner>/<repo> with your repository's GitHub identifier. The badge
links back to the most recent published report.
Example badge (mock)
A CARL L3 badge will render with the L3 accent colour (#52c5a0), the text
CARL L3, and a small CARL mark. An unassessed repo renders as "CARL: Not
Assessed" with a link to the hosted app to start an assessment.
Rules of use
- Badges displayed on a README MUST correspond to a real published report. Displaying a level that isn't backed by a report is a prohibited conformance claim.
- Badge usage is permitted without asking — see
/governance/trademark/. Modifications to the SVG (recoloring, text changes) are not covered by this permission. - The badge endpoint is rate-limited on origin; cache behavior is tuned for README use.
When this ships
The badge service is coupled to milestone 8's sharing feature set. Track progress on GitHub; once the Cloudflare Worker is deployed and the URL pattern is live, this page will be updated with live examples and the full URL scheme.
Related
- Conformance claims — what can honestly be published as a CARL level.
- Trademark — permitted and restricted use of the CARL marks.