stelint beta

stelint 0.3 Rust and Markdown

Lint the docs that your agent writes.

Agents write more comments and docs than you can read. They give one object three names. They use words that have no clear meaning. They write two steps that do not agree.

The next agent reads this text and obeys it.

stelint checks each comment and Markdown file against the terms of your project. A bad sentence fails the check, and the agent writes it again.

These sentences look correct in a diff.

stelint finds errors in each one. The dictionary of these examples has the terms importer, batch and archive folder.

One project, before and after the check.

An agent wrote these four files. Select a file. Put the pointer on an error to see its help text.

stelint
    the dictionaries of this file

    Each diagnostic comes from a run of stelint.

    A rule in CLAUDE.md is a request. A failed check is not.

    a rule

    The agent does not obey it.

    In a long session, the rule is one line of many. No check fails, thus you do not see the error.

    an LLM

    The result changes.

    The same text can pass one time and fail the next time. Each check uses tokens and time.

    a person

    There is too much text.

    An agent writes a hundred lines of comments in one minute. You read the code, not the comments.

    A type checker finds errors in code. stelint finds errors in text. It has no LLM and no network. The same text always gets the same diagnostics, and each diagnostic tells the agent how to correct the text.

    agentWrites a comment.
    stelintFinds the errors.
    agentReads each help text.
    agentWrites the comment again.
    stelintFinds no errors. Commit.

    See one comment go through stelint →

    Dictionaries in layers.

    The project dictionary applies to each file. A module dictionary applies only to its module, and Claude Code reads it when it opens a file there.

    one word in two modules
    
                  
    a term out of its module
    
                  

    Install.

    with Claude Code
    > /plugin marketplace add serejke/stelint > /plugin install stelint@stelint > /stelint:init # stelint, Stanza, writing guides > /stelint:word-list # the STE word list, from its PDF > /stelint:dictionary # the dictionaries of your project > /stelint:correct # agents correct the errors
    in a terminal
    $ gh release download -R serejke/stelint -p install.sh -O - | sh $ stelint model update # Stanza, 1 GB, one time $ stelint init $ stelint

    stelint does not include the STE word list. Without it, stelint does not check the words.