Jun 9, 2026, 4:06 PM

2026-06-09 14:06:59 +00:00
parent c36ead5db0
commit bb6ff3a8c6
12 changed files with 454 additions and 0 deletions
@@ -0,0 +1,26 @@
+# Conventions
+
+Coding style, naming, and structural conventions for the Knowledge Base.
+
+## Language Convention
+
+- **Synthesis Layer Content**: Polish (Polski) is used for summaries, index listings, concepts, and log descriptions (matching the current Polish structure of `knowledge/`).
+- **Configuration & Schemas**: English is used for `GEMINI.md`, core repository schemas, and code/script names.
+
+## Formatting & Link Style
+
+- **WikiLinks**: Prefer double brackets `[[knowledge/path/to/page]]` or standard relative link `[[page]]` for connections in the synthesis layer (`knowledge/`).
+- **YAML Frontmatter**: When requested or appropriate, include metadata (tags, dates, source counts) at the top of markdown files.
+- **Kebab Case**: File names in `knowledge/concepts/` and `knowledge/entities/` must be kebab-case (e.g., `human-in-the-loop.md`, `sql-server.md`).
+
+## Log Bookkeeping
+
+- **Log Appends**: Always append new entries to the top of `knowledge/log.md` with format:
+  ```markdown
+  ## [YYYY-MM-DD] Ingest | Source Title
+  - Bulleted details of created or updated pages.
+  ```
+
+## Feynman Problems Alignment
+
+- **Central Alignment**: Every newly ingested raw file must be tested against the 12 Feynman Problems documented in `knowledge/feynman_problems.md`. If the content addresses or helps answer any of those questions, update the respective section in `knowledge/feynman_problems.md` with a direct link and concise insight.