Skip to content

AGENTS.md

Latest commit

 

History

History
53 lines (34 loc) · 2.15 KB

AGENTS.md

File metadata and controls

53 lines (34 loc) · 2.15 KB
Raw

uri

A URI parsing, manipulation, and template-expansion library for Pony.

Contributing with an AI assistant

This is a Pony project. The ponylang org maintains a set of LLM coding skills. Get set up with them before contributing:

  • Not set up yet? Install them once:

    git clone https://github.com/ponylang/llm-skills.git
cd llm-skills
python install.py

  • Already set up? Make sure you're on the latest. If you installed with the script above, git pull in the directory where you cloned llm-skills and the symlinked skills update automatically — if you set them up another way, refresh them however that setup expects.

See the llm-skills README for details and other harnesses.

When you start working on this project, load the pony-skills skill — it tells your assistant which Pony skill to use for each task.

Read CONTRIBUTING.md.

Prose model

If you are running on an Anthropic model, use claude-opus-4-6 for writing comments, documentation, and other prose. Prose quality from Anthropic models dropped starting with Opus 4.7 and has gotten worse with each subsequent release.

Linting

Run make lint before considering any work done. Fix all issues it reports. make lint runs pony-lint, which checks for style and correctness problems in Pony source files. A clean lint run is part of "done" — don't open a PR or report completion with lint issues outstanding.

Building and testing

make                     # build tests + examples (release; test is the default)
make test                # same as make
make test-one t=TestName # run a single test by name
make examples            # examples only
make config=debug        # debug build
make clean               # clean build artifacts + corral cache

Architecture

Two independent packages: uri for parsing and manipulation, uri/template for template expansion. Neither imports the other — keep them independent.

Conventions

  • Register new tests in uri/_test.pony, which delegates to uri/template's runner.
  • \nodoc\ on test classes.