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/caliban/agent_s_env.j2

@@ -0,0 +1,32 @@
+# Agent S Environment Configuration
+# Source this file to activate the Agent S environment
+# Usage: source ~/.agent_s_env
+
+# Activate Python virtual environment
+if [ -f "{{ agent_s_venv }}/bin/activate" ]; then
+    source "{{ agent_s_venv }}/bin/activate"
+    echo "✓ Agent S Python environment activated"
+fi
+
+# Set Agent S paths
+export AGENT_S_HOME="{{ agent_s_repo }}"
+export PATH="{{ agent_s_venv }}/bin:$PATH"
+
+# Display setup
+export DISPLAY=:10.0
+
+# Required API Key Vars:
+export HF_TOKEN=0000
+export OPENAI_API_KEY=0000
+
+# Helpful aliases
+alias agent_s_cd='cd {{ agent_s_repo }}'
+alias agent_s_start='cd {{ agent_s_repo }} && source {{ agent_s_venv }}/bin/activate'
+
+echo "Agent S Environment Ready"
+echo "  Virtual Env: {{ agent_s_venv }}"
+echo "  Repository:  {{ agent_s_repo }}"
+echo ""
+echo "Quick commands:"
+echo "  agent_s_cd       - Change to Agent S directory"
+echo "  agent_s_start    - Activate environment and change to repo"