arkaos 2.15.0 → 2.16.0

package/departments/kb/skills/knowledge/scripts/kb-worker.sh

@@ -0,0 +1,217 @@
+#!/bin/bash
+# ============================================================================
+# ARKA OS — KB Background Worker
+# Handles one job: download audio → transcribe → mark ready
+# Launched by kb-queue.sh via nohup
+#
+# Usage: kb-worker.sh <job-id> <url> <output-dir> <transcription-method>
+# ============================================================================
+
+JOB_ID="$1"
+URL="$2"
+OUTPUT_DIR="$3"
+TRANSCRIPTION_METHOD="${4:-none}"
+
+ARKA_DIR="$HOME/.arka-os"
+JOBS_FILE="$ARKA_DIR/kb-jobs.json"
+LOCK_FILE="$ARKA_DIR/kb-jobs.lock"
+WORKER_LOG="$OUTPUT_DIR/worker.log"
+
+# Redirect all output to worker log
+exec > "$WORKER_LOG" 2>&1
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Worker started for job $JOB_ID"
+echo "  URL: $URL"
+echo "  Output: $OUTPUT_DIR"
+echo "  Transcription: $TRANSCRIPTION_METHOD"
+
+# Load env for API keys
+[ -f "$ARKA_DIR/.env" ] && source "$ARKA_DIR/.env"
+
+# ─── State update helper ────────────────────────────────────────────────────
+
+update_job() {
+    local field="$1"
+    local value="$2"
+    (
+        flock -x 200
+        if command -v jq &>/dev/null && [ -f "$JOBS_FILE" ]; then
+            local tmp="$JOBS_FILE.tmp.$$"
+            jq --arg id "$JOB_ID" --arg val "$value" \
+                '(.jobs[] | select(.id == $id)).'$field' = $val' \
+                "$JOBS_FILE" > "$tmp" && mv "$tmp" "$JOBS_FILE"
+        fi
+    ) 200>"$LOCK_FILE"
+}
+
+update_job_status() {
+    local status="$1"
+    local now
+    now=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+    (
+        flock -x 200
+        if command -v jq &>/dev/null && [ -f "$JOBS_FILE" ]; then
+            local tmp="$JOBS_FILE.tmp.$$"
+            jq --arg id "$JOB_ID" --arg s "$status" --arg t "$now" \
+                '(.jobs[] | select(.id == $id)) |= (.status = $s | .updated_at = $t)' \
+                "$JOBS_FILE" > "$tmp" && mv "$tmp" "$JOBS_FILE"
+        fi
+    ) 200>"$LOCK_FILE"
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Status → $status"
+}
+
+fail_job() {
+    local error_msg="$1"
+    (
+        flock -x 200
+        if command -v jq &>/dev/null && [ -f "$JOBS_FILE" ]; then
+            local tmp="$JOBS_FILE.tmp.$$"
+            local now
+            now=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+            jq --arg id "$JOB_ID" --arg err "$error_msg" --arg t "$now" \
+                '(.jobs[] | select(.id == $id)) |= (.status = "failed" | .error = $err | .updated_at = $t)' \
+                "$JOBS_FILE" > "$tmp" && mv "$tmp" "$JOBS_FILE"
+        fi
+    ) 200>"$LOCK_FILE"
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] FAILED: $error_msg"
+    exit 1
+}
+
+# ─── Step 1: Download ───────────────────────────────────────────────────────
+
+update_job_status "downloading"
+
+if ! command -v yt-dlp &>/dev/null; then
+    fail_job "yt-dlp not found. Install with: brew install yt-dlp"
+fi
+
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Downloading audio..."
+
+# Download audio + metadata
+yt-dlp -x --audio-format wav --audio-quality 0 \
+    --write-info-json \
+    -o "$OUTPUT_DIR/audio.%(ext)s" \
+    "$URL" > "$OUTPUT_DIR/download.log" 2>&1
+
+if [ $? -ne 0 ]; then
+    fail_job "yt-dlp download failed. Check $OUTPUT_DIR/download.log"
+fi
+
+# Find the audio file (yt-dlp may produce different extensions during conversion)
+AUDIO_FILE="$OUTPUT_DIR/audio.wav"
+if [ ! -f "$AUDIO_FILE" ]; then
+    # Try to find any audio file produced
+    AUDIO_FILE=$(find "$OUTPUT_DIR" -name "audio.*" -not -name "*.json" -not -name "*.log" | head -1)
+    if [ -z "$AUDIO_FILE" ] || [ ! -f "$AUDIO_FILE" ]; then
+        fail_job "Audio file not found after download"
+    fi
+fi
+
+# Extract metadata from yt-dlp JSON
+INFO_JSON=$(find "$OUTPUT_DIR" -name "*.info.json" | head -1)
+if [ -n "$INFO_JSON" ] && [ -f "$INFO_JSON" ]; then
+    jq '{title: .title, duration: .duration, duration_string: .duration_string, channel: .channel, upload_date: .upload_date, thumbnail: .thumbnail, description: (.description // "" | .[0:500])}' \
+        "$INFO_JSON" > "$OUTPUT_DIR/metadata.json" 2>/dev/null || true
+
+    # Update job with title
+    TITLE=$(jq -r '.title // "Unknown"' "$OUTPUT_DIR/metadata.json" 2>/dev/null || echo "Unknown")
+    update_job "title" "$TITLE"
+
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Title: $TITLE"
+fi
+
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Download complete: $AUDIO_FILE"
+
+# ─── Step 2: Transcribe ─────────────────────────────────────────────────────
+
+update_job_status "transcribing"
+
+case "$TRANSCRIPTION_METHOD" in
+    local_whisper)
+        echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Transcribing with local Whisper..."
+        whisper "$AUDIO_FILE" \
+            --model medium \
+            --language auto \
+            --output_format txt \
+            --output_dir "$OUTPUT_DIR" \
+            > "$OUTPUT_DIR/transcribe.log" 2>&1
+
+        if [ $? -ne 0 ]; then
+            fail_job "Whisper transcription failed. Check $OUTPUT_DIR/transcribe.log"
+        fi
+
+        # Whisper outputs as <filename>.txt — find it
+        TRANSCRIPT=$(find "$OUTPUT_DIR" -name "*.txt" -not -name "transcribe.log" -not -name "download.log" -not -name "worker.log" | head -1)
+        if [ -n "$TRANSCRIPT" ] && [ -f "$TRANSCRIPT" ]; then
+            cp "$TRANSCRIPT" "$OUTPUT_DIR/audio.txt" 2>/dev/null || true
+        fi
+        ;;
+
+    openai_api)
+        echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Transcribing with OpenAI Whisper API..."
+
+        if [ -z "${OPENAI_API_KEY:-}" ]; then
+            fail_job "OPENAI_API_KEY not set. Run: bash env-setup.sh"
+        fi
+
+        # Check file size — OpenAI limit is 25MB
+        FILE_SIZE=$(stat -f%z "$AUDIO_FILE" 2>/dev/null || stat -c%s "$AUDIO_FILE" 2>/dev/null || echo "0")
+        if [ "$FILE_SIZE" -gt 26214400 ]; then
+            echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] File too large for API ($FILE_SIZE bytes). Compressing..."
+            if command -v ffmpeg &>/dev/null; then
+                ffmpeg -i "$AUDIO_FILE" -ac 1 -ar 16000 -b:a 32k "$OUTPUT_DIR/audio_compressed.mp3" \
+                    >> "$OUTPUT_DIR/transcribe.log" 2>&1
+                AUDIO_FILE="$OUTPUT_DIR/audio_compressed.mp3"
+            else
+                fail_job "Audio file too large and ffmpeg not available for compression"
+            fi
+        fi
+
+        # Call OpenAI API
+        RESPONSE=$(curl -s -X POST "https://api.openai.com/v1/audio/transcriptions" \
+            -H "Authorization: Bearer $OPENAI_API_KEY" \
+            -F "file=@$AUDIO_FILE" \
+            -F "model=whisper-1" \
+            -F "response_format=text" \
+            2>> "$OUTPUT_DIR/transcribe.log")
+
+        if [ -z "$RESPONSE" ]; then
+            fail_job "OpenAI API returned empty response. Check $OUTPUT_DIR/transcribe.log"
+        fi
+
+        # Check for API error
+        if echo "$RESPONSE" | jq -e '.error' &>/dev/null 2>&1; then
+            ERROR_MSG=$(echo "$RESPONSE" | jq -r '.error.message // "Unknown API error"')
+            fail_job "OpenAI API error: $ERROR_MSG"
+        fi
+
+        echo "$RESPONSE" > "$OUTPUT_DIR/audio.txt"
+        ;;
+
+    none)
+        echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] No transcription method available. Download-only mode."
+        echo "[Download-only mode — no transcription available]" > "$OUTPUT_DIR/audio.txt"
+        update_job_status "ready"
+        echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Worker finished (download-only)"
+        exit 0
+        ;;
+
+    *)
+        fail_job "Unknown transcription method: $TRANSCRIPTION_METHOD"
+        ;;
+esac
+
+# Verify transcript exists
+if [ ! -f "$OUTPUT_DIR/audio.txt" ] || [ ! -s "$OUTPUT_DIR/audio.txt" ]; then
+    fail_job "Transcription produced no output"
+fi
+
+WORD_COUNT=$(wc -w < "$OUTPUT_DIR/audio.txt" | tr -d ' ')
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Transcription complete: $WORD_COUNT words"
+
+# Update word count in job
+update_job "word_count" "$WORD_COUNT"
+
+# ─── Done — mark ready for processing ───────────────────────────────────────
+
+update_job_status "ready"
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Worker finished. Job $JOB_ID is ready for processing."

package/departments/kb/workflows/learn.yaml

@@ -41,6 +41,7 @@ phases:
     type: auto
 - id: quality-gate
   name: Quality Gate
+  model_override: opus
   agents:
   - agent_id: cqo-marta
     role: Orchestrate

package/departments/landing/SKILL.md

@@ -63,3 +63,16 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 | ResearchXL | Peep Laja (CXL) | CRO methodology |
 | 6 Principles of Persuasion | Robert Cialdini | Persuasion elements |
 | StoryBrand SB7 | Donald Miller | Messaging framework |
+
+## Model Selection
+
+When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
+
+- Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
+- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Default to `sonnet` if the agent YAML has no `model` field
+- Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
+
+Example Task tool call:
+
+    Task(description="...", subagent_type="general-purpose", model="sonnet", prompt="...")

package/departments/landing/agents/affiliate-manager.yaml

@@ -3,6 +3,7 @@ name: Sergio
 role: Affiliate & Partnerships Manager
 department: landing
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/landing/agents/conversion-strategist.yaml

@@ -3,6 +3,7 @@ name: Ines
 role: Conversion Strategist
 department: landing
 tier: 1
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/landing/agents/cro-specialist.yaml

@@ -3,6 +3,7 @@ name: Hugo
 role: CRO Specialist
 department: landing
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/landing/agents/sales-copywriter.yaml

@@ -3,6 +3,7 @@ name: Teresa
 role: Sales Copywriter
 department: landing
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/landing/workflows/launch.yaml

@@ -47,6 +47,7 @@ phases:
     type: auto
 - id: quality-gate
   name: Quality Gate
+  model_override: opus
   agents:
   - agent_id: cqo-marta
     role: Orchestrate

package/departments/landing/workflows/offer.yaml

@@ -33,6 +33,7 @@ phases:
 
   - id: offer-build
     name: Offer Architecture
+    model_override: opus
     description: Build the Grand Slam Offer using Hormozi Value Equation
     agents:
       - agent_id: conversion-strategist-ines
@@ -57,6 +58,7 @@ phases:
 
   - id: funnel
     name: Funnel Architecture
+    model_override: opus
     description: Design the Value Ladder and funnel flow
     agents:
       - agent_id: conversion-strategist-ines
@@ -70,6 +72,7 @@ phases:
 
   - id: quality-gate
     name: Quality Gate
+    model_override: opus
     description: Review offer, copy, and funnel quality
     agents:
       - agent_id: cqo-marta

package/departments/leadership/SKILL.md

@@ -33,3 +33,16 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 | **Paula** | 2 | S+I | Performance coaching, feedback, conflict mediation |
 
 ## Frameworks: Five Dysfunctions (Lencioni), Radical Candor (Scott), OKRs (Doerr), Netflix Culture (Hastings), Who Method (hiring), DISC Adaptation, Keeper Test
+
+## Model Selection
+
+When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
+
+- Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
+- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Default to `sonnet` if the agent YAML has no `model` field
+- Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
+
+Example Task tool call:
+
+    Task(description="...", subagent_type="general-purpose", model="sonnet", prompt="...")

package/departments/leadership/agents/culture-coach.yaml

@@ -3,6 +3,7 @@ name: Paula
 role: Culture & Performance Coach
 department: leadership
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/leadership/agents/hr-specialist.yaml

@@ -3,6 +3,7 @@ name: Diana R.
 role: HR & Talent Specialist
 department: leadership
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/leadership/agents/leadership-director.yaml

@@ -3,6 +3,7 @@ name: Rodrigo
 role: Leadership & People Director
 department: leadership
 tier: 1
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/leadership/workflows/team-build.yaml

@@ -33,6 +33,7 @@ phases:
     description: User approves improvement plan
 - id: quality-gate
   name: Quality Gate
+  model_override: opus
   agents:
   - agent_id: cqo-marta
     role: Orchestrate

package/departments/marketing/SKILL.md

@@ -59,3 +59,16 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 4. Growth loop identified — Strategy has sustainable loop, not just funnel?
 5. Unit economics viable — CAC recoverable? Channel scalable?
 6. Brand consistency — Aligned with brand voice and sacred lexicon?
+
+## Model Selection
+
+When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
+
+- Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
+- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Default to `sonnet` if the agent YAML has no `model` field
+- Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
+
+Example Task tool call:
+
+    Task(description="...", subagent_type="general-purpose", model="sonnet", prompt="...")

package/departments/marketing/agents/content-marketer.yaml

@@ -3,6 +3,7 @@ name: Mariana
 role: Content Marketing Specialist
 department: marketing
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/marketing/agents/marketing-director.yaml

@@ -3,6 +3,7 @@ name: Luna
 role: Marketing Director
 department: marketing
 tier: 1
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/marketing/agents/paid-specialist.yaml

@@ -3,6 +3,7 @@ name: Pedro
 role: Performance Marketing Specialist
 department: marketing
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/marketing/agents/seo-specialist.yaml

@@ -3,6 +3,7 @@ name: Ana
 role: SEO Specialist
 department: marketing
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/marketing/workflows/campaign.yaml

@@ -83,6 +83,7 @@ phases:
 
   - id: quality-gate
     name: Quality Gate
+    model_override: opus
     description: Mandatory quality review before delivery
     agents:
       - agent_id: cqo-marta

package/departments/marketing/workflows/social.yaml

@@ -30,6 +30,7 @@ phases:
 
   - id: quality-gate
     name: Quality Gate
+    model_override: opus
     description: Review content quality
     agents:
       - agent_id: cqo-marta

package/departments/ops/SKILL.md

@@ -35,3 +35,16 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 | **Tomas A.** | 2 | D+C | n8n, Zapier, Make, API integrations |
 
 ## Frameworks: Lean/TPS (Ohno), Theory of Constraints (Goldratt), GTD (Allen), PARA (Forte), PDCA (Deming), EOS (Wickman), Automation Patterns, n8n/Zapier/Make
+
+## Model Selection
+
+When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
+
+- Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
+- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Default to `sonnet` if the agent YAML has no `model` field
+- Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
+
+Example Task tool call:
+
+    Task(description="...", subagent_type="general-purpose", model="sonnet", prompt="...")

package/departments/ops/agents/automation-engineer.yaml

@@ -3,6 +3,7 @@ name: Tomas A.
 role: Automation Engineer
 department: ops
 tier: 2
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/ops/agents/doc-writer.yaml

@@ -3,6 +3,7 @@ name: Isabel
 role: Documentation Writer
 department: ops
 tier: 3
+model: haiku
 
 behavioral_dna:
   disc:

package/departments/ops/agents/ops-lead.yaml

@@ -3,6 +3,7 @@ name: Daniel
 role: Operations Lead
 department: ops
 tier: 1
+model: sonnet
 
 behavioral_dna:
   disc:

package/departments/ops/skills/operations/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: arka-operations
+description: >
+  Operations department. Task management via ClickUp, email drafting via Gmail, calendar
+  management via Google Calendar, meeting scheduling and agenda preparation, invoice generation,
+  process automation with SOP creation, operational reports, client onboarding checklists,
+  daily standups, and multi-platform messaging (Slack, Discord, WhatsApp, Teams). Manages
+  notification channels and broadcasts. All output saved to Obsidian vault.
+  Use when user says "ops", "tasks", "email", "calendar", "automate", "invoice", "meeting",
+  "workflow", "process", "schedule", "channel", "notify", "broadcast", "onboard client",
+  "standup", "slack", "discord", "whatsapp", "teams", or any operational task.
+---
+
+# Operations Department — ARKA OS
+
+Company operations, automations, and routine process management.
+
+## Squad (Compact)
+
+- **Sofia (COO)** — Orchestrator, planning, execution, delivery
+- **Lucas (Analyst)** — Challenge & research, best practices
+- **Marco (CTO) / Helena (CFO)** — Supervision (tech / financial)
+- **Marta (CQO) + Eduardo + Francisca** — Quality Gate (absolute veto)
+
+## Universal Workflow (7 phases, NON-NEGOTIABLE)
+
+0. BRIEF (Sofia) — clarify, check ClickUp/Calendar, save to Obsidian, gate
+1. CHALLENGE & RESEARCH (Lucas) — best practices, gate
+2. PLANNING (Sofia) — steps, TaskCreate, success criteria
+3. EXECUTION (Sofia) — ClickUp/Gmail/Calendar, one-at-a-time validation
+4. SELF-CRITIQUE (Sofia)
+5. SUPERVISION (Marco or Helena) — gate
+6. QUALITY GATE (Marta → Eduardo + Francisca) — APPROVED/REJECTED. No output without APPROVED
+7. DELIVERY (Sofia) — Obsidian save, confirm
+
+Every phase transition announced to the user.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/ops tasks` | View and manage tasks (ClickUp MCP) |
+| `/ops email <type>` | Send/draft emails (Gmail MCP) |
+| `/ops calendar` | View schedule (Google Calendar MCP) |
+| `/ops meeting <topic>` | Schedule and prepare meeting |
+| `/ops invoice <client>` | Generate invoice (InvoiceExpress MCP) |
+| `/ops automate <process>` | Create automation for routine process |
+| `/ops report <type>` | Operational reports (weekly, monthly) |
+| `/ops onboard-client <name>` | New client onboarding checklist |
+| `/ops standup` | Daily standup summary |
+| `/ops channel add <platform> <channel-id>` | Add messaging channel |
+| `/ops channel list` | List configured messaging channels |
+| `/ops channel remove <platform>` | Remove a messaging channel |
+| `/ops notify <message>` | Send to default notification channel |
+| `/ops broadcast <message>` | Send to all configured channels |
+
+## Obsidian Output
+
+Vault root: `/Users/andreagroferreira/Documents/Personal`
+
+| Content | Path |
+|---------|------|
+| Processes | `WizardingCode/Operations/Processes/<name>.md` |
+| Automations | `WizardingCode/Operations/Automations/<name>.md` |
+| Client onboarding | `WizardingCode/Operations/Clients/<name>/Onboarding.md` |
+| Meetings | `WizardingCode/Operations/Meetings/<date> <topic>.md` |
+| Reports | `WizardingCode/Operations/Reports/<date> <type>.md` |
+
+Frontmatter: `type`, `department: operations`, `title`, `date_created`, `tags[]`. Wikilinks `[[]]`, kebab-case tags.
+
+## MCP Integrations
+
+ClickUp, Gmail, Google Calendar, InvoiceExpress, Google Drive, Slack, Discord, WhatsApp, Teams.
+
+## References
+
+Read only when executing the relevant command:
+
+- `references/clickup-ops.md` — ClickUp task workflows: `/ops tasks`, `/ops onboard-client`, `/ops standup`, `/ops automate`, channel management (`add`/`list`/`remove`/`notify`/`broadcast`).
+- `references/calendar-email.md` — Gmail + Google Calendar flows: `/ops meeting`, `/ops email`, `/ops calendar`.
+
+---
+*All output: `WizardingCode/Operations/` — Part of the [[WizardingCode MOC]]*

package/departments/ops/skills/operations/references/calendar-email.md

@@ -0,0 +1,73 @@
+# arka-operations — Calendar & Email
+
+Referenced from SKILL.md. Read only when needed.
+
+## /ops meeting <topic>
+
+**Step 1: Check Calendar**
+- Use Google Calendar MCP to check availability for the next 3 business days
+- Identify possible time slots
+
+**Step 2: Prepare Agenda**
+- Ask user for meeting participants, duration, and key discussion points
+- Draft a structured agenda with time allocations per topic
+
+**Step 3: Create Meeting Note in Obsidian**
+
+**File:** `WizardingCode/Operations/Meetings/<YYYY-MM-DD> <topic>.md`
+```markdown
+---
+type: meeting
+department: operations
+title: "<topic>"
+date_created: <YYYY-MM-DD>
+participants:
+  - "<name>"
+tags:
+  - "meeting"
+  - "<topic-kebab-case>"
+---
+
+# <topic>
+
+## Agenda
+1. [Topic] — [time allocation]
+2. [Topic] — [time allocation]
+
+## Notes
+[To be filled during/after meeting]
+
+## Action Items
+- [ ] [Action] — Owner: [name] — Due: [date]
+
+## Decisions Made
+- [Decision and rationale]
+
+---
+*Part of the [[WizardingCode MOC]]*
+```
+
+**Step 4: Report**
+```
+═══ ARKA OPS — Meeting Prepared ═══
+Topic:       <topic>
+Date:        <suggested date/time>
+Participants: <list>
+Obsidian:    WizardingCode/Operations/Meetings/<date> <topic>.md
+════════════════════════════════════
+```
+
+## /ops email <type>
+
+Use Gmail MCP to draft/send emails. Common types: welcome, kickoff, follow-up, invoice-reminder, proposal.
+
+Flow:
+1. Clarify type, recipient(s), subject, context
+2. Draft via Gmail MCP (professional tone, Eduardo-reviewed copy)
+3. Self-critique: accuracy, tone, errors
+4. Quality Gate review before send
+5. Send or save as draft per user preference
+
+## /ops calendar
+
+Use Google Calendar MCP to display schedule. Default view: today + next 3 business days. Highlight conflicts and free slots.