diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..0fefdb5
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,5 @@
+# Project Instructions
+
+## MANDATORY: Keep README in sync
+
+When adding, removing, or renaming any file in this repository, **update README.md** to reflect the change. The README serves as the index of all repository contents — every document must be listed there with a short description. Also update the "Last updated" date in README.md to the current date.
diff --git a/README.md b/README.md
index 99b5ce3..c86585f 100644
--- a/README.md
+++ b/README.md
@@ -1,40 +1,14 @@
# Claude Code Facts
-A collection of interesting and useful facts, tips, and tools for working with Claude and Claude Code — including plugins, MCP servers, and practical usage patterns.
+> Last updated: 2026-03-23
-## MCP Servers
+A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code.
-MCP (Model Context Protocol) servers are external processes that provide tools to Claude Code via a standardized protocol. They run alongside your session and extend Claude's capabilities.
+## Contents
-### Context7
+### [Claude Code Tools & Extensions](claude-code-tools.md)
-Up-to-date documentation and code examples for any library, available directly in your Claude Code session.
-
-- **Website:**
-- **Setup:**
-
- ```bash
- claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: "
- ```
-
-- **Note:** API key can be created for free after signing in at [context7.com](https://context7.com/)
-
-## Skills (Slash Commands)
-
-Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via `/skill-name` commands directly within Claude Code — no external server required.
-
-### AST Index
-
-Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing.
-
-- **Repository:**
-- **Usage:** Invoke with `/ast-index` or related commands like "find class", "search for symbol", etc.
-
-## Guides
-
-### [Everything Claude Code (ECC) — Setup Guide](ecc-setup-guide.md)
-
-Step-by-step instructions for setting up [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) on a new machine — a comprehensive collection of skills, rules, agents, and hooks for Claude Code.
+MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs) and AST Index (fast code search).
### [CI/CD for Python Apps on Gitea](gitea-python-ci-cd.md)
diff --git a/claude-code-tools.md b/claude-code-tools.md
new file mode 100644
index 0000000..32da995
--- /dev/null
+++ b/claude-code-tools.md
@@ -0,0 +1,40 @@
+# Claude Code Tools & Extensions
+
+Useful tools, plugins, and extensions for Claude Code.
+
+## MCP Servers
+
+MCP (Model Context Protocol) servers are external processes that provide tools to Claude Code via a standardized protocol. They run alongside your session and extend Claude's capabilities.
+
+### Context7
+
+Up-to-date documentation and code examples for any library, available directly in your Claude Code session.
+
+- **Website:**
+- **Setup:**
+
+ ```bash
+ claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: "
+ ```
+
+- **Note:** API key can be created for free after signing in at [context7.com](https://context7.com/)
+
+## Skills (Slash Commands)
+
+Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via `/skill-name` commands directly within Claude Code — no external server required.
+
+### AST Index
+
+Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing.
+
+- **Repository:**
+- **Usage:** Invoke with `/ast-index` or related commands like "find class", "search for symbol", etc.
+
+## Toolkits
+
+### Everything Claude Code (ECC)
+
+A comprehensive collection of skills, rules, agents, and hooks for Claude Code.
+
+- **Repository:**
+- **Setup guide:** [ecc-setup-guide.md](ecc-setup-guide.md)