primitives CLAUDE.md

A project instruction document for Radix NG Primitives, an Angular library of unstyled building blocks for user interfaces, organised as a monorepo—a repository containing multiple related packages.

In plain words
What is it for?
Use it when adding or changing primitives, directives, APIs, tests, Storybook examples, documentation, or release-related project files.
Why use it?
It points agents to the authoritative project notes and summarises the library's architecture, naming rules, testing practices, and component conventions.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/radix-ng/primitives/claude-md
Clone the repo
git clone --depth 1 https://github.com/radix-ng/primitives
Per session 9,681 This file is loaded in full into every session.
When invoked 9,681 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.09681 $0.09681
Opus 5 $0.04841 $0.04841
Sonnet 5 $0.01936 $0.01936
Haiku 4.5 $0.00968 $0.00968

Measured yesterday against content hash ecea02e07370, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

primitives CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 406 lines

How it starts

The opening of the file, as written. The whole thing — 406 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Radix NG Primitives — Claude Guide

Project knowledge

Detailed documentation lives in .claude/skills/project-knowledge/references/:

  • project.md — what the library is, audience, available primitives
  • architecture.md — tech stack, monorepo layout, composition primitives, DI context, CDK migration
  • patterns.md — naming, new primitive checklist, signals conventions, testing, story patterns
  • deployment.md — CI/CD, release process, Storybook/docs builds
  • ux-guidelines.md — demo styling system, semantic tokens, animation patterns

Read the relevant file before starting any non-trivial task. The sections below in this file are a quick-reference summary; the references/ files are the authoritative source.

Project overview

Angular port of headless UI primitives. This is a signals-first, headless component library — directives carry no styles; state is exposed via data-* attributes for consumers to style.

Reference priority: Base UI is the primary reference we align to — match its component APIs, naming, and behavior when designing or updating primitives. Radix UI was the original foundation of this library and remains a valid secondary reference to consult, especially for patterns Base UI doesn't cover.

  • Monorepo: Nx 22, pnpm workspaces
  • Angular: 21 / 22 (peer range ^21.0.0 || ^22.0.0; signals API: input(), model(), computed(), signal(), linkedSignal())
  • TypeScript: 5.9
  • Testing: Vitest + AnalogJS Angular Vite plugin + @testing-library/angular
  • Storybook: 10 (@storybook/angular + AnalogJS vite plugin)
  • Styling in stories: Tailwind v4 (see "Stories & Storybook")
  • Prefix: rdx (selectors and exportAs)
  • Class prefix: Rdx

Monorepo structure

packages/
  primitives/          ← main Angular library (ng-packagr secondary entries)
    <name>/
      index.ts         ← barrel exports + optional NgModule
      ng-package.json  ← secondary entry point {"lib":{"entryFile":"index.ts"}}
      src/
        <name>-root.directive.ts
        <name>-<role>.directive.ts   (or .ts without "directive" suffix for newer style)
      __tests__/
        <name>-root.directive.spec.ts
      stories/
        <name>.stories.ts
        <name>.ts                    ← standalone story components
apps/
  radix-storybook/     ← Storybook docs/examples; also the public site on radix-ng.com
  radix-playground/    ← Angular playground app
  radix-ssr-testing/   ← SSR smoke-test app
  radix-perf-testing/  ← performance benchmark app
  visual-regression/   ← Playwright visual and behavior specs
skills/                ← LLM consumer Agent Skills (generated from Storybook docs)
tools/
  scripts/             ← build helpers (incl. skills bundle generator)

Read the full file on GitHub · 406 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 406 lines · 9,681 tokens per session scan A ecea02e07370

Subscribe to this mod's changes

primitives CLAUDE.md is an instructions file published in the GitHub repository radix-ng/primitives (269 stars, last pushed 7d ago), licensed MIT. It adds 9,681 tokens to every session, about $0.0484 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

core-web copilot-instructions.md

Copilot instructions for db-ux-design-system/core-web: All development instructions, build commands, validation steps, coding rules, and the pull request workflow are maintained in AGENTS.md at the repository root. Read that file first before starting any task.

db-ux-design-system/core-web · 90 tokens

core-web AGENTS.md

AGENTS.md instructions for db-ux-design-system/core-web, covering db ux design system v3 core web, working effectively, required prerequisites, bootstrap and setup and build and test.

db-ux-design-system/core-web · 6,996 tokens

ark CLAUDE.md

Instructions for chakra-ui/ark, covering ark ui - claude development guide, documentation structure, quick start, common commands and install dependencies.

chakra-ui/ark · 647 tokens

fundamental-ngx AGENTS.md

Instructions for SAP/fundamental-ngx, covering angular 22+ development guidelines, persona, quick reference, essential commands and build/lint/test specific library.

SAP/fundamental-ngx · 3,066 tokens

fundamental-ngx CLAUDE.md

Instructions for SAP/fundamental-ngx, covering fundamental ngx, architecture, commands, build / lint / test a library and affected only (prefer this for validation).

SAP/fundamental-ngx · 2,765 tokens

openbridge-webcomponents watch-radial-instruments.instructions.md

Instructions for Ocean-Industries-Concept-Lab/openbridge-webcomponents, covering watch & radial instruments, architecture overview, key principle: logic in watch.ts, instruments stay thin, shared sibling modules and layering & stacking pattern.

Ocean-Industries-Concept-Lab/openbridge-webcomponents · 10,138 tokens