Document that HarfBuzz fuzzers run with failing-malloc enabled so
out-of-memory handling remains part of the expected exercised
surface during fuzzing work.
Testing: not run (documentation-only change)
Assisted-by: OpenAI Codex
Extend the local AGENTS.md exception so simple CI-only
changes may also skip the full test suite, provided they do
not affect code, build logic, generated outputs, or test
inputs.
Assisted-by: OpenAI Codex
Clarify the local agent guidance so simple documentation-only
changes may be committed without running the full test suite,
as long as they do not touch code, build logic, generated
outputs, or test inputs.
Assisted-by: OpenAI Codex
Add explicit local guidance for two recurring issues:
use file-backed input for multi-line commit messages, and
prefer HarfBuzz helpers from hb-algs.hh over raw libc memory
routines where those helpers are available. Also state
explicitly that STL containers are not used in library code.
Testing:
- meson test -C build
Assisted-by: OpenAI Codex
Root cause: the guide required descriptive commit messages,
but it did not encode the preferred body width or the
preference to skip irrelevant testing boilerplate.
Update AGENTS.md to recommend wrapping commit message
bodies to about 70 columns and to mention testing only
when it was actually performed or otherwise relevant.
Assisted-by: OpenAI Codex
Root cause: the previous guide had accumulated useful project-specific guidance, but too much detail made the core constraints and workflow harder to scan quickly.
Rewrite AGENTS.md into a shorter structure that keeps the important HarfBuzz-specific rules around API/ABI stability, build and test expectations, feature-guarded builds, generator-driven updates, commit conventions, and project mindset, while removing lower-signal detail. Add back a short Wisdom section to preserve project tone without re-expanding the file.
Testing: not run (documentation-only change).
Assisted-by: OpenAI Codex
Root cause: the repository guide captured broad commit hygiene expectations, but it did not explicitly encode the preferred subject prefix style, issue-linking trailers, or the required Assisted-by trailer.
Update AGENTS.md to require consistent bracketed subsystem prefixes, recommend Fixes: trailers when relevant, and require Assisted-by on commits written through the agent.
Testing: not run (documentation-only change).
Assisted-by: OpenAI Codex
Root cause: the repository guide captured explicit project rules, but it did not yet encode several stable engineering patterns visible across the last 1000 commits.
Update AGENTS.md to reflect recurring HarfBuzz practices: incremental helper extraction over large rewrites, pairing bug fixes with reproducible regressions or fuzz coverage, keeping docs and build/install wiring aligned with feature changes, treating generated data as generator-driven work, and validating simplifications carefully because semantic regressions are often only caught later.
Testing: not run (documentation-only change).
Root cause: the guide had accumulated useful project-specific guidance, but the structure made it harder to scan and apply consistently.
Reorganize AGENTS.md around core rules, build and verification flow, repository layout, change-specific guidance, and working mindset while preserving the existing instructions and recent review-driven additions.
Testing: not run (documentation-only change).
Root cause: the initial repository guide omitted several project-specific expectations raised during review and listed non-installed utilities in the util map.
Update AGENTS.md to reflect HarfBuzz conventions around API/ABI stability, new API documentation with XSince: REPLACEME, warning-free rebuild expectations, OOM and error-handling guidance, root-cause-first debugging, and descriptive commit messages. Also limit the utility list to installed command-line tools.
Testing: not run (documentation-only change).