Agent tooling: sharper prose rules, a prose checker, and an `fdk` helper - #5338

Closed

pbrubeck wants to merge 23 commits into

pbrubeck/agents-md-prose-rules

Commits on Aug 9, 2026

Sharpen the prose rules in AGENTS.md

pbrubeck
and
claude
committed
ae9d189
AGENTS.md: shorten an over-long sentence

pbrubeck
and
claude
committed
d721471
Add a hook that checks an edit against the AGENTS.md rules

pbrubeck
and
claude
committed
258609d
Make check-prose.py document and run itself

pbrubeck
and
claude
committed
85fe52b
Add an fdk helper for the work a session repeats

pbrubeck
and
claude
committed
8c0a961
Check a whole branch's prose, and lint as CI does
pbrubeck
committed
814ed06
Let a copy of fdk outside the repo find the source tree
pbrubeck
committed
d17beaf
Keep the agent tools in one directory
pbrubeck
committed
bcc334d
Add fdk subcommands for the work around the code
pbrubeck
committed
59b2ed0
Add an auditing-comments skill, and fdk explain to drive it
pbrubeck
committed
5de35c5
Drop the borrowed review thread from the auditing-comments skill
pbrubeck
committed
f03233d
Point the documentation at the tools' real directory
pbrubeck
committed
c8e5f8f
Say how to run a whole suite, not only one module

pbrubeck
and
claude
committed
248cc12
Read the prose of a Markdown file, not its code

pbrubeck
and
claude
committed
2e0d6a1
Say what the question is, not what it stopped being

pbrubeck
and
claude
committed
c578dff
Split a sentence that ends inside its own emphasis

pbrubeck
and
claude
committed
0d1cc58
Trim AGENTS.md into a lightweight fdk manual

pbrubeck
and
claude
committed
35c839b
fdk: warn on an empty test selection, add testfile; check-prose: whole docstring

pbrubeck
and
claude
committed
837adc7
check-prose: don't flag "used to" naming what something is for

pbrubeck
and
claude
committed
44ee385
Wire fdk in as required, not just documented

pbrubeck
and
claude
committed
dc756e7

Commits on Aug 10, 2026

fdk: clear the kernel caches when the code generators change

pbrubeck
and
claude
committed
497743e
AGENTS.md: say what a stale kernel cache looks like

pbrubeck
and
claude
committed
5cb51a0

Commits on Aug 11, 2026

check-prose: flag Python loops over dof data, and Google headings

pbrubeck
and
claude
committed
f680836