From ae82ab74ccd217e708ca0dc97ad02dc1fc2fffee Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 4 Mar 2026 16:52:32 +0000
Subject: [PATCH 1/3] Initial plan


From a2869bdd6c5d65c1ab6520defb4bb1be39d60636 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 4 Mar 2026 16:54:48 +0000
Subject: [PATCH 2/3] docs: mention pre-commit in AGENTS.md and CLAUDE.md

Co-authored-by: dgenio <12731907+dgenio@users.noreply.github.com>
---
 AGENTS.md | 3 +++
 CLAUDE.md | 1 +
 2 files changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 0b173a5..0811c9a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -35,6 +35,9 @@ make demo     # python -m contextweaver demo
 make ci       # fmt + lint + type + test
 ```
 
+After cloning, run `pre-commit install` once to activate the git hooks. The hooks
+run `ruff format` and `ruff check --fix` automatically on every `git commit`.
+
 ## Conventions
 - Python ≥ 3.10, zero runtime dependencies
 - All public APIs: type hints + docstrings
diff --git a/CLAUDE.md b/CLAUDE.md
index 92a7e28..4bd94e8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,6 +1,7 @@
 # contextweaver — Claude Guide
 
 ## Do
+- Run `pre-commit install` once after cloning to activate git hooks (ruff format + check run on every commit)
 - Run `make ci` before submitting any change
 - Use `make fmt` to auto-format code
 - Keep each module ≤ 300 lines

From 7c6c28f7666b28446c361e3ca64a3b192ade038c Mon Sep 17 00:00:00 2001
From: dgenio <diogo.ansantos@nos.pt>
Date: Wed, 4 Mar 2026 18:10:04 +0000
Subject: [PATCH 3/3] docs: mention file hygiene checks in AGENTS.md and
 CLAUDE.md

Align pre-commit hook descriptions with CONTRIBUTING.md by noting the standard file hygiene checks (trailing-whitespace, end-of-file-fixer, check-yaml, check-json) alongside the ruff hooks.
---
 AGENTS.md | 3 ++-
 CLAUDE.md | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 0811c9a..f45bc00 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -36,7 +36,8 @@ make ci       # fmt + lint + type + test
 ```
 
 After cloning, run `pre-commit install` once to activate the git hooks. The hooks
-run `ruff format` and `ruff check --fix` automatically on every `git commit`.
+run `ruff format` and `ruff check --fix`, plus standard file hygiene checks,
+automatically on every `git commit`.
 
 ## Conventions
 - Python ≥ 3.10, zero runtime dependencies
diff --git a/CLAUDE.md b/CLAUDE.md
index 4bd94e8..4c07c59 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,7 +1,7 @@
 # contextweaver — Claude Guide
 
 ## Do
-- Run `pre-commit install` once after cloning to activate git hooks (ruff format + check run on every commit)
+- Run `pre-commit install` once after cloning to activate git hooks (ruff format + check, and file hygiene checks, on every commit)
 - Run `make ci` before submitting any change
 - Use `make fmt` to auto-format code
 - Keep each module ≤ 300 lines