docs: add project architecture and planning documents

2026-06-09 17:12:31 +01:00
commit 56fb7417ea
10 changed files with 1054 additions and 0 deletions
@@ -0,0 +1,24 @@
+# MCP Design Principles
+
+Tools should be focused.
+
+Prefer:
+
+- One question
+- One answer
+- Explicit context
+
+Avoid:
+
+- Automatically sending entire repositories
+- Automatically sending secrets
+- Large uncontrolled context windows
+
+All tools should support:
+
+- Question
+- Context
+- Constraints
+- Expected output format
+
+Responses should be concise and actionable.