polygon-problems-generator AGENTS.md

Shared agent context

This is the only copy of roster, layout, pipeline, and critical rules.

Specialist agents (.claude/agents/<role>.md) add only their role contract. Do not paste this file into those stubs — tell the model to Read it.

Deep references (read on demand, do not duplicate):

• guidelines.md — full human checklist
• tutorials/polygon-hints.md — Polygon wording and testlib hints
• tutorials/<topic>.md — statement / validator / checker / generator / interactor
• docs/workflow.md — local-first loop and how to prompt a fix

---

Agent roster

Agent	Role
statement-agent	LaTeX statement + editorial (statement.tex, tutorial.tex)
validator-agent	testlib.h input validator (validator.cpp)
checker-agent	Standard checker recommendation or custom checker (checker.cpp)
interactor-agent	testlib.h interactor for interactive problems (interactor.cpp)
solutions-agent	ACC / TLE / WA solutions in C++ and Java
generator-agent	testlib.h test generator + FreeMarker script (generator.cpp)
reviewer-agent	Full review; blocks on any FAIL verdict
orchestrator	Coordinates the pipeline; do not run other agents except through this

---

Problem folder layout

problems/<name>/
├── statement/
│   ├── statement.tex
│   └── tutorial.tex
├── solutions/
│   ├── acc.cpp         ← main ACC (clear, not over-optimized)
│   ├── acc_java.java
│   ├── acc_alt.cpp     ← second ACC, different approach
│   ├── brute.cpp
│   └── wa.cpp
├── generators/
│   └── generator.cpp
├── validator.cpp
├── checker.cpp
└── interactor.cpp      ← interactive only

Create with:

mkdir -p problems/<name>/{statement,solutions,generators,samples,validator_tests}
cp templates/validator.cpp            problems/<name>/validator.cpp
cp templates/checker.cpp              problems/<name>/checker.cpp
cp templates/statement/raw.tex        problems/<name>/statement/raw.tex
cp templates/statement/statement.tex  problems/<name>/statement/statement.tex
cp templates/statement/tutorial.tex   problems/<name>/statement/tutorial.tex
cp templates/generators/generator.cpp problems/<name>/generators/generator.cpp
# interactive only: cp templates/interactor.cpp problems/<name>/interactor.cpp