embedded-workbench CLAUDE.md

A project instruction file for Embedded Workbench describes how contributors and coding agents should work in that repository. It covers acknowledgments, pull-request checks, skill formatting, permissions, and continuous-integration workflows.

In plain words
What is it for?
It is for checking markdown, defining new skills, controlling agent tools, and following pull-request and GitHub Actions procedures.
Why use it?
It gives contributors shared rules for making changes that satisfy the project's review and automated-check requirements.

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/amethystluna/embedded-workbench/claude-md
Clone the repo
git clone --depth 1 https://github.com/AmethystLuna/embedded-workbench
Per session 1,240 This file is loaded in full into every session.
When invoked 1,240 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.01240 $0.01240
Opus 5 $0.00620 $0.00620
Sonnet 5 $0.00248 $0.00248
Haiku 4.5 $0.00124 $0.00124

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

Security

Grade A, and why

embedded-workbench 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 · 89 lines

How it starts

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

CLAUDE.md

Contributor guidelines for the Embedded Engineering Workflow plugin.

Acknowledgments

This plugin's agent-compliance architecture (1% Rule, Red Flags, <SUBAGENT-STOP>, instruction priority, skill types, session-start hook injection) is adapted from Superpowers by Jesse Vincent (MIT License). The trigger test framework structure (tests/skill-triggering/) follows Superpowers' testing conventions.

PR Requirements

  • All PRs must pass markdownlint with the project's .markdownlint.json config.
  • New skills must follow the established frontmatter format: name (kebab-case), description ("Use when..." format).
  • Agent changes must maintain the tool allowlist (tools field):
    • Read-only agents (architecture-steward, quality-coordinator) must not gain Write or Edit.
    • Review agents (design-reviewer) may include Bash for read-only verification (grep, markdownlint, build checks) — add explicit "Bash for verification only" guidance in the agent prompt.
    • Implementation agents (execution-worker) require Write + Edit + Bash.
  • Skill content must not hardcode project-specific details (file paths, version numbers, product names).
  • Chinese content should have English equivalents in the bootstrap skill and vice versa.

Before Submitting

  • Run markdownlint on all changed files.
  • Verify plugin.json passes claude plugin validate.
  • Test the plugin locally by installing to ~/.claude/plugins/dev/.
  • Bump the version with the release tool: npm run bump -- <new-version> (syncs every declared manifest — package.json, package-lock.json ×2, all plugin manifests, .version-bump.json — plus DSH-COMPATIBILITY.md; npm run bump -- --check and npm run bump -- --audit must pass).

CI Workflows (GitHub Actions)

  • dsh-bundle — on push/PR touching src/, lib/, cordis.patch.yml, package.json, package-lock.json, docs, or the workflow itself: npm ci --legacy-peer-deps, typecheck, build, committed-lib/ drift guard, and markdownlint on .dsh/**/*.md, READMEs, and RELEASE.md.
  • Plugin Security Scan — on every push/PR: hashgraph-online/ai-plugin-scanner-action on the repo root; fails on high-severity findings.

Read the full file on GitHub · 89 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 · 89 lines · 1,240 tokens per session scan A 1f914834de86

Subscribe to this mod's changes

embedded-workbench CLAUDE.md is an instructions file published in the GitHub repository AmethystLuna/embedded-workbench (5 stars, last pushed yesterday), licensed MIT. It adds 1,240 tokens to every session, about $0.0062 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-31.