From 7a51e3e6ffefe7a77ba44836558f668d6dccb87b Mon Sep 17 00:00:00 2001
From: Ilya Glazunov <lead@pyserve.org>
Date: Thu, 11 Dec 2025 22:33:36 +0000
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..48da5a2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+# Aegis Foundation
+
+Reliable infrastructure tooling for your servers.
+
+---
+
+## Projects
+
+### Konduktor
+
+> Golang re-imagining of the original PyServe idea.
+
+- High-performance web server and reverse proxy.
+- Declarative configuration via YAML/JSON.
+- Multiple services, routes, and hosts in a single config.
+- Suitable for both side projects and small/medium production setups.
+
+👉 Repository: `konduktor`      
+👉 Documentation: _to be added_
+
+---
+
+### PyServe (legacy)
+
+Original Python implementation.
+
+- Built on top of Starlette / Uvicorn.
+- Used as a reference implementation and playground for fast experiments.
+- Many concepts were later refined and moved into Konduktor.
+
+👉 Repository: [`pyserve`](https://git.pyserve.org/aegis/pyserveX)  
+👉 Documentation: [`LINK`](https://docs.pyserve.org/)
+
+---
+
+## For Contributors
+
+Contributions are welcome — but we value clarity and predictability.
+
+### Workflow
+
+1. Find or open an issue with a clear problem statement.
+2. Fork the repository.
+3. Create a branch: `feature/...` or `fix/...`.
+4. Open a pull request with a concise description of the change.
+
+### Principles
+
+- Prefer **simple and explicit** solutions over clever “magic”.
+- Keep configuration and behavior **transparent**.
+- When public behavior changes, **update tests and documentation**.
+
+---
+
+## Stack & Philosophy
+
+- **Languages:** Go, Python (legacy parts), some TypeScript/JS for docs and tooling, LUA (We hope...).
+- **Philosophy:**
+  - configuration over hidden logic;
+  - explicit contracts between services;
+
+---
+
+## License
+
+By default, Aegis Foundation projects use the **MIT License**, unless stated otherwise.  
+Check the `LICENSE` file in each repository for details.
+
+---
+
+## Contact
+
+- Gitea: `https://git.pyserve.org/`
+- For questions and proposals: [`lead@pyserve.org`](mailto:lead@pyserve.org).
+
+---
+
+> Aegis Foundation — the part of your infrastructure that just quietly does its job.
\ No newline at end of file