init: mostly vibed

1 files changed, 59 insertions, 0 deletions

diff --git a/docs/contessa.md b/docs/contessa.md
new file mode 100644
index 0000000..b1d2e27
--- /dev/null
+++ b/docs/contessa.md
@@ -0,0 +1,59 @@
+# contessa
+
+Recipe suggestion bot. Suggests random recipes by meal type, lists available
+dishes per category, and gives full step-by-step recipes on request.
+
+## Dependencies
+
+No external libraries required.
+
+## Commands
+
+All commands require channel context (`@plugin.require_chanmsg`).
+
+| Command | Description |
+|---------|-------------|
+| `!breakfast [list]` | Random breakfast suggestion, or list all breakfast dishes |
+| `!lunch [list]` | Random lunch suggestion, or list all lunch dishes |
+| `!dinner [list]` | Random dinner suggestion, or list all dinner dishes |
+| `!snack [list]` | Random snack suggestion, or list all snacks |
+| `!recipe <name>` | Full recipe: description, ingredients, steps (3 lines) |
+
+### Admin (owner)
+| Command | Description |
+|---------|-------------|
+| `!join #channel` | Join a channel |
+| `!part [#channel]` | Leave a channel |
+| `!chans` | List channels |
+| `!help` | Show usage (PM) |
+
+## Recipe data
+
+Recipes are loaded from a JSON file at startup. Format:
+
+```json
+{
+  "breakfast": [
+    {
+      "name": "Dish Name",
+      "description": "One-line description.",
+      "ingredients": ["item 1", "item 2"],
+      "steps": ["Step one.", "Step two.", "Step three."]
+    }
+  ],
+  "lunch": [...],
+  "dinner": [...],
+  "snack": [...]
+}
+```
+
+The included `recipes.json` has 24 recipes per category (96 total), covering
+both Egyptian/Middle Eastern and Western/European dishes.
+
+`!recipe` matches by exact name first, then by substring across all categories.
+
+## Config keys
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `[contessa] recipes_path` | `/var/contessa/recipes.json` | Path to recipes JSON file |