From 369f14d5b26df5a53afa67901e21e658df47e633 Mon Sep 17 00:00:00 2001
From: Aster Seker <git.electroyar@gmail.com>
Date: Sat, 13 Sep 2025 08:17:15 +0300
Subject: [PATCH 1/3] Refine LogRecord dependencies

---
 AGENTS.md                                   | 9 +++++++++
 include/logit_cpp/logit/utils.hpp           | 2 ++
 include/logit_cpp/logit/utils/LogRecord.hpp | 4 ++++
 3 files changed, 15 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..de3232a
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,9 @@
+# AGENTS
+
+## Header inclusion
+This project provides dedicated entry-point headers that include internal dependencies in the correct order. Use these headers instead of forward-declaring library types.
+
+* `include/logit_cpp/LogIt.hpp` – main entry for the entire library.
+* `include/logit_cpp/logit/utils.hpp` – aggregates the utilities module.
+
+Including through these headers ensures dependencies are resolved without manual forward declarations.
diff --git a/include/logit_cpp/logit/utils.hpp b/include/logit_cpp/logit/utils.hpp
index 0d65770..783555c 100644
--- a/include/logit_cpp/logit/utils.hpp
+++ b/include/logit_cpp/logit/utils.hpp
@@ -9,6 +9,8 @@
 /// encoding utilities, path utilities, and log record management. Including this header
 /// provides a single point of access to common utility functions and types.
 
+#include "LogItConfig.hpp"
+#include "enums.hpp"
 #include "utils/format.hpp"
 #include "utils/VariableValue.hpp"
 #include "utils/argument_utils.hpp"
diff --git a/include/logit_cpp/logit/utils/LogRecord.hpp b/include/logit_cpp/logit/utils/LogRecord.hpp
index 33ce586..dda556b 100644
--- a/include/logit_cpp/logit/utils/LogRecord.hpp
+++ b/include/logit_cpp/logit/utils/LogRecord.hpp
@@ -5,7 +5,11 @@
 /// \file LogRecord.hpp
 /// \brief Contains the definition of the LogRecord structure for storing log data.
 
+#include <string>
+#include <vector>
+#include <cstdint>
 #include <thread>
+#include "logit/enums.hpp"
 
 namespace logit {
 

From 514c3a2df85e7d29b64150c201883dfcdd3d7c7f Mon Sep 17 00:00:00 2001
From: Aster Seker <git.electroyar@gmail.com>
Date: Sat, 13 Sep 2025 08:19:53 +0300
Subject: [PATCH 2/3] refactor: update utils.hpp

---
 include/logit_cpp/logit/utils.hpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/include/logit_cpp/logit/utils.hpp b/include/logit_cpp/logit/utils.hpp
index 783555c..830cae5 100644
--- a/include/logit_cpp/logit/utils.hpp
+++ b/include/logit_cpp/logit/utils.hpp
@@ -9,7 +9,6 @@
 /// encoding utilities, path utilities, and log record management. Including this header
 /// provides a single point of access to common utility functions and types.
 
-#include "LogItConfig.hpp"
 #include "enums.hpp"
 #include "utils/format.hpp"
 #include "utils/VariableValue.hpp"

From 1fe46eb9b11c2db16ba1f287537062ce9c47a354 Mon Sep 17 00:00:00 2001
From: Aster Seker <git.electroyar@gmail.com>
Date: Sat, 13 Sep 2025 08:20:23 +0300
Subject: [PATCH 3/3] refactor: update LogRecord.hpp

---
 include/logit_cpp/logit/utils/LogRecord.hpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/include/logit_cpp/logit/utils/LogRecord.hpp b/include/logit_cpp/logit/utils/LogRecord.hpp
index dda556b..0f70331 100644
--- a/include/logit_cpp/logit/utils/LogRecord.hpp
+++ b/include/logit_cpp/logit/utils/LogRecord.hpp
@@ -9,7 +9,6 @@
 #include <vector>
 #include <cstdint>
 #include <thread>
-#include "logit/enums.hpp"
 
 namespace logit {