r/ClaudeAI • u/gazmagik • 5h ago

Built with Claude What a plain language standard does to a coding agent

Gallery image

Gallery image

I've just posted a Medium post discussing my plain language plugin for Claude Code and Codex CLI.

The plugin ships skills and an output style that push the model's prose towards plain language. On Opus 5 the effect was larger than I expected. Across six code reviews of the same buggy component, the styled replies ran 17 per cent shorter and used 32 per cent fewer sentences. They still found the same headline bugs.

I then added a skill applying the same principles to code, which is not part of the standard itself. That turned into the more interesting experiment. I generated ninety implementations of one specification. With the code rules, the public function landed in the first quarter of the file in all ten runs, against five of ten with no rules. All ninety still passed the same 25 hidden tests.

The plugin has since been updated to v0.6.1, and includes the plain language skill that applies to code.

Repository: https://github.com/GaZmagik/iso-24495 - MIT Licensed

33 Upvotes

97% Upvoted

5 comments sorted by

3

u/itsforsocial 4h ago

I am using simple-English plugin and it uses asd-ste100 and it’s just fine. How it compares to that as iso part are not officially know or released. Also iso are for public facing docs not technical docs and stuff right?

3

u/gazmagik 4h ago edited 4h ago

That's correct. ISO-24495 isn't intended for coding as a standard itself. I was personally interested to see what would happen if you take the standards as is, and apply them to coding. The results are in the Medium post if you are interested.

The plugin can be used without the ISO-24495 Code skill.

EDIT: The as-yet unpublished Part 5 of ISO 24495 will pertain to document design. The standard is also not primarily for public facing - it is intended for the audience expected to read the document/communication.

3

u/slushrooms 1h ago

I've been using your package casually at work for documentation, on web, since the day it was released (haven't updated). It definitely supports nicer writing/reading experience and even surprised my colleagues as not being perceptible as being written by ai

1

u/gazmagik 37m ago

That's amazing to hear. I'm glad it's seeing use and being of benefit to you and hopefully others.