Add AGENTS.md

Author: asfernandes

.gitignore

@@ -1 +1,3 @@
 build/
+temp/
+.env

AGENTS.md

@@ -0,0 +1,25 @@
+## fb-cpp Agent Guide
+
+### Code style
+- Classes names uses PascalCase.
+- Method names uses camelCase.
+- Variable names uses camelCase.
+- When using statements like `if`, `for`, `while`, etc, if the condition plus the sub-statement takes more than two
+  lines, then the sub-statement should use braces. Otherwise, braces should be avoided.
+- A C++ source file should be formatted with `clang-format`.
+- Documentation uses doxygen with  `///` comments. Empty lines with only `///` should be used before and after the
+  documentation.
+- When scopes are introduced for RAII purposes, they should be commented as such:
+  ```cpp
+  {  // scope
+  }
+  ```
+
+### Build
+- If .cpp files are added, it's necessary to run `./gen-linux-debug.sh` (non-Windows) or `gen-windows.bat` (Windows) from the repo root.
+- Use `cmake --build build/Debug/` (non-Windows) or `cmake --build build --config Debug` (Windows) from the repo root.
+
+### Tests
+- Test code can use Boost.Multiprecision without conditional compilation.
+- Run the Boost.Test suite with `./run-tests.sh` (non-Windows) or `run-tests.bat` (Windows).
+  Boost.Test options can be used (for example, `./run-tests.sh --log_level=all` or `run-tests.bat --log_level=all`).

run-tests.bat

@@ -0,0 +1,2 @@
+@echo off
+build\out\bin\Debug\fb-cpp-test.exe %*

run-tests.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+set -a
+env_file="$(dirname "$0")/.env"
+if [ -f "$env_file" ]; then
+  source "$env_file"
+fi
+set +a
+
+mkdir -p $(dirname "$0")/temp/lock
+export FIREBIRD_LOCK=$(dirname "$0")/temp/lock
+
+./build/Debug/out/bin/fb-cpp-test "$@"