docs: rewrite README with structured overview and quick start guide

Replaces the minimal project description with a comprehensive README
including a component overview table, quick start instructions, common
Ansible operations, and links to detailed documentation. Aligns with
Red Panda Approval™ standards.

ansible/gitea_mcp/remove.yml

@@ -0,0 +1,36 @@
+---
+- name: Remove Gitea MCP Server
+  hosts: ubuntu
+  become: true
+  tasks:
+    - name: Check if host has gitea_mcp service
+      ansible.builtin.set_fact:
+        has_gitea_mcp_service: "{{ 'gitea_mcp' in services | default([]) }}"
+
+    - name: Skip hosts without gitea_mcp service
+      ansible.builtin.meta: end_host
+      when: not has_gitea_mcp_service
+
+    - name: Check if docker-compose.yml exists
+      ansible.builtin.stat:
+        path: "{{gitea_mcp_directory}}/docker-compose.yml"
+      register: compose_file
+
+    - name: Stop and remove Docker containers, volumes, and images
+      community.docker.docker_compose_v2:
+        project_src: "{{gitea_mcp_directory}}"
+        state: absent
+        remove_images: all
+        remove_volumes: true
+      when: compose_file.stat.exists
+
+    - name: Prune Docker images
+      community.docker.docker_prune:
+        images: true
+        images_filters:
+          dangling: false
+
+    - name: Remove Gitea MCP directory
+      ansible.builtin.file:
+        path: "{{gitea_mcp_directory}}"
+        state: absent