Skip to content

Comment on Linting the Shape of a Repositoryparent

Comments

This is for both manual/human and agentic codebases. Many/most repos already have conventions/rules which are somewhat implicit and only enforced manually via code reviews. In repos that heavily use agents/AI I feel that having some sort of strict and deterministic enforcement is even more useful - AGENTS.md works pretty well, but it is not deterministic or actually enforced in any way - agents can ignore or forget about what AGENTS.md says, and this becomes more and more apparent as a repo grows - the conventions are slowly and incrementally violated, incorrectly placed/named/structured files compound and confuse the agent more and more - the mess keeps growing. alint does integrate and play well with AGENTS.md - it can export the ruleset it defines into AGENTS.md in a agent-friendly/readable way. It can also explain a deterministic rule to an agent and help it figure out how to fix a violation.

AboutSource Built by g1lg1l

Hackerly is an independent reader for Hacker News, built on the public HN API. Not affiliated with Y Combinator.