ratatoskr

Debug the LangGraph summarize graph (the sole summarize path) -- node walk, validate/repair retry loop, and the LLM attempt trail. Trigger keywords -- LangGraph, summarize graph, graph node, retry, repair loop, attempt_trigger, attempt_index, graph_node, validation failure, self-correction, summarization agent.

Build, ship, and restart the Ratatoskr container on the Raspberry Pi via cross-platform Docker image streaming. Trigger keywords -- pi deploy, raspi, raspberry pi, pi-deploy, ship to pi, deploy production, build-and-deploy-pi.

Coordinate Ratatoskr backend web integration with the external React + TypeScript + Vite frontend. Trigger keywords -- web, frontend, React, Vite, TypeScript, ratatoskr-web, app/static/web, Frost, UI change.

Quick-reference card for all ponytail modes, skills, and commands. One-shot display, not a persistent mode. Trigger: @ponytail-help, "ponytail help", "what ponytail commands", "how do I use ponytail".

Forces the laziest solution that actually works, simplest, shortest, most minimal. Channels a senior dev who has seen everything: question whether the task needs to exist at all (YAGNI), reach for the standard library before custom code, native platform features before dependencies, one line before fifty. Supports intensity levels: lite, full (default), ultra. Use whenever the user says "ponytail", "be lazy", "lazy mode", "simplest solution", "minimal solution", "yagni", "do less", or "shortest path", and whenever they complain about over-engineering, bloat, boilerplate, or unnecessary dependencies.

Quick-reference card for all ponytail modes, skills, and commands. One-shot display, not a persistent mode. Trigger: /ponytail-help, "ponytail help", "what ponytail commands", "how do I use ponytail".

Test bot functionality locally using CLI runner, message simulation, and workflow validation. Trigger on "test", "CLI runner", "message simulation", "bot testing", "workflow validation", "pytest".

Validate summary JSON contracts against strict schema requirements. Trigger keywords: summary validation, summary contract, JSON schema, character limits, summary fields, validate summary.

Test bot functionality locally using CLI runner, message simulation, and workflow validation. Trigger on "test", "CLI runner", "message simulation", "bot testing", "workflow validation", "pytest".

Validate summary JSON contracts against strict schema requirements. Trigger keywords: summary validation, summary contract, JSON schema, character limits, summary fields, validate summary.

Add a Telegram bot command through TelegramCommandContribution routing. Trigger keywords -- new command, bot command, telegram handler, command_handlers, TelegramCommandContribution, TextCommandRoute, slash command.

Debug Firecrawl and OpenRouter API calls -- request/response inspection, error handling, retry logic. Trigger on "API debug", "Firecrawl errors", "OpenRouter failures", "LLM call errors", "rate limit", "API costs", "crawl failures".

Operate and debug the Taskiq-scheduled Telegram channel digest subsystem and its separate Telethon userbot session. Trigger keywords -- digest, channels, userbot, /init_session, /digest, /subscribe, channel_posts, digest_deliveries, Mini App, OTP, 2FA.

Debug the current 13-provider content scraper chain and persisted attempt telemetry. Trigger keywords -- scraper, scraping failure, Scrapling, Crawl4AI, Defuddle, Firecrawl self-hosted, Playwright, Crawlee, Webwright, crawl_results, attempt_log, winning_provider.

Understand and debug the two-writer vector index sync between Postgres summaries/repositories and the Qdrant vector store. Trigger keywords -- vector, Qdrant, embeddings, reconciler, last_indexed_at, point_ids, semantic search, vector reconcile.

Use when creating, updating, triaging, or completing repository tasks stored as Obsidian Tasks Markdown lines with

Create, review, and apply Alembic migrations for the Ratatoskr Postgres schema. Trigger keywords -- migration, alembic, schema change, new column, new table, ALL_MODELS, migrate_db, autogenerate, downgrade.

Query and inspect the Ratatoskr Postgres database for debugging requests, summaries, crawl results, and LLM calls. Trigger keywords -- correlation IDs, request status, API costs, crawl results, missing summaries, database query, Postgres, debug request.