Skip to content

AGENTS.md still says the repo has no lint, test or package setup #998

Closed as not planned

Description

@yakew7

Where: AGENTS.md ("Repo Shape", "Verification", "Practical Gotchas").

Current gap: the file tells agents "This is not a package monorepo", "The only verified automation is .github/workflows/audits.yml" and "There is no repo-level lint, formatter, typecheck, or test config checked in. Do not invent those commands." The repo now has the faircode/ package with a CLI and an MCP server, pyproject.toml with pytest and ruff config, a Makefile (make test, make lint), pre-commit hooks and several workflows (lint.yml, codeql.yml, browser-smoke.yml). An agent following the file would not run the tests or the linter, and would be told not to.

Repro:

$ grep -n "no repo-level lint\|only verified automation" AGENTS.md
$ ls Makefile pyproject.toml .pre-commit-config.yaml tests | head -3

Suggested approach: rewrite the Repo Shape and Verification sections from Makefile, CONTRIBUTING.md and the workflow files (make test-fast, make lint, the audit commands), keep the audit-folder conventions that are still true, and drop the "do not invent" sentence.

Activity

  1. yakew7 commented on Oct 16, 2026

    @yakew7
    OwnerAuthor

    AGENTS.md is listed in .gitignore and is not tracked, so there is nothing in the repository to change; this issue was filed against a local file by mistake. (The local copy was refreshed, but it is not part of the repo.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions