Commit Graph
14 Commits
Author SHA1 Message Date
Behdad Esfahbod 7e7a7085a8 [docs] Note failing-malloc in fuzzing guidance
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
2026-03-19 09:41:46 -06:00
Behdad Esfahbod e948ac9a3a [docs] Allow CI-only commits without tests
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
2026-03-11 16:55:58 -03:00
Behdad Esfahbod 1e9084874f [docs] Allow docs-only commits without tests
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
2026-03-11 16:55:44 -03:00
Behdad Esfahbod 17e40091c7 [docs] Clarify local agent rules
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
2026-03-11 15:59:20 -03:00
Behdad Esfahbod 4569a56e29 [docs] Require full test run before commits
Require running the full Meson test suite before creating any commit.

Testing: meson test -C build

Assisted-by: OpenAI Codex
2026-03-11 12:34:38 -03:00
Behdad Esfahbod a87b8897e0 [AGENTS.md] Refine commit message guidance
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
2026-03-10 02:16:36 -03:00
Behdad Esfahbod 248dd7e56e [AGENTS.md] Tighten repository guide
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
2026-03-10 02:15:06 -03:00
Behdad Esfahbod 41768116ec [AGENTS.md] Encode commit message conventions
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
2026-03-10 02:10:50 -03:00
Behdad Esfahbod dc0f366567 AGENTS.md: add guidance from recent commit history
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).
2026-03-10 02:07:12 -03:00
Behdad Esfahbod 238001d1bc AGENTS.md: reorganize repository guide
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).
2026-03-10 02:01:57 -03:00
Behdad Esfahbod 577f7097ff AGENTS.md: address PR review feedback
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).
2026-03-10 01:59:17 -03:00
Behdad EsfahbodandClaude Opus 4.6 39c1b71f84 [AGENTS.md] Expand repo map, debug flags, options, and change-specific advice
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-10 01:53:57 -03:00
Behdad Esfahbod e9b7083a06 [AGENTS.md]
Add gemini wisdom.
2026-03-10 01:53:57 -03:00
Behdad Esfahbod 0b3b9fdbdc Add repository AGENTS guide
Codex intitial writeup.
2026-03-10 01:53:57 -03:00