Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Document harness optionality and DB timestamp rules.

debajyoti-truefoundry0fc02dabab74
diff --git a/packages/harness/AGENTS.md b/packages/harness/AGENTS.md
new file mode 100644
index 000000000..56c303fe5
--- /dev/null
+++ b/packages/harness/AGENTS.md
@@ -0,0 +1,2 @@
+- Top-level public package surfaces (`core`, `agent-session`, and other exported entrypoints) MAY use optional (`?`) properties for caller ergonomics.
+- Within this package, records, snapshots, store INPUT types, and other internal contracts MUST NOT use `?`. Absence MUST be an explicit required `| null` or `| undefined` field; prefer `null` for domain absence and `undefined` only when update/patch semantics must distinguish “not provided” from “clear.” Public surfaces adapt by supplying those explicit absences when calling inward. This forces internal object literals to be exhaustive under `tsc`, preventing forgotten fields and silent data loss.
diff --git a/packages/harness/CLAUDE.md b/packages/harness/CLAUDE.md
new file mode 100644
index 000000000..43c994c2d
--- /dev/null
+++ b/packages/harness/CLAUDE.md
@@ -0,0 +1 @@
diff --git a/packages/server/src/db/AGENTS.md b/packages/server/src/db/AGENTS.md
new file mode 100644
index 000000000..f5ac3e081
--- /dev/null
+++ b/packages/server/src/db/AGENTS.md
@@ -0,0 +1,2 @@
+- Temporal columns MUST use `timestamptz` (`timestamp with time zone`). Do not use `timestamp` without time zone.
+- Application timestamps MUST be treated as UTC instants. Serialize with `Date.prototype.toISOString()` (always `...Z` with milliseconds).
diff --git a/packages/server/src/db/CLAUDE.md b/packages/server/src/db/CLAUDE.md
new file mode 100644
index 000000000..43c994c2d
--- /dev/null
+++ b/packages/server/src/db/CLAUDE.md
@@ -0,0 +1 @@