From 8c6286a95be39d47a2942ccb0673a948d5b82f8c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Filip=20St=C4=99pie=C5=84?= <filip.stepien30@gmail.com>
Date: Thu, 20 Aug 2026 20:57:49 +0200
Subject: [PATCH] docs: update architecture docs and mention docs in AGENTS.md

---
 AGENTS.md               | 4 ++++
 docs/02_architecture.md | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index b272741..d2c3383 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,9 @@
 # AGENTS.md
 
+## Dokumentacja
+
+- Przed rozpoczęciem pracy przejrzyj `docs/` - opisuje koncept gry i architekturę projektu.
+
 ## Commity
 
 - Format: [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `chore:`, `refactor:`, itd.)
diff --git a/docs/02_architecture.md b/docs/02_architecture.md
index 23f16bf..25ad324 100644
--- a/docs/02_architecture.md
+++ b/docs/02_architecture.md
@@ -79,6 +79,8 @@ public sealed class Health
 }
 ```
 
+Nazewnictwo feature to zazwyczaj encja w liczbie mnogiej (`Players`, `Enemies` itd.). Gdy liczba mnoga nie brzmi naturalnie, nadajemy klasie nazwę opisującą jej rolę zamiast powtarzać nazwę feature'a - np. feature `Terminal` trzyma klasę `Report`, (zamiast `Terminal.Terminal`).
+
 ---
 
 ### 3.2 `Application`