1---
2name: aiogram-production-patterns
3description: Use when building or fixing aiogram 3 bots that need aiogram_i18n with Fluent/FTL, topic-aware reply handling, Telegram quote and forward-origin context, and production middleware ordering.
4---
5 
6# Aiogram Production Patterns
7 
8Use this skill for aiogram 3 bot work where Telegram update edge cases matter.
9 
10This bundle is runtime-neutral and focuses on:
11- aiogram_i18n with Fluent/FTL
12- locale managers and runtime setup
13- topic-aware reply handling
14- Telegram quote and forward-origin context for AI features
15- production middleware ordering
16- Context7 lookups for exact aiogram and aiogram_i18n API details
17 
18## When to use
19- A reply behaves differently in forum topics, linked discussion groups, or channel comments.
20- You need a clean `aiogram_i18n` setup with locale persistence and FTL keys.
21- You need to understand locale managers in `aiogram_i18n` instead of inventing your own runtime flow.
22- You want to pass better quote or forward-origin context into AI features.
23- You need a neutral middleware ordering checklist for a production bot.
24 
25## Workflow
261. Read [references/context7-aiogram.md](references/context7-aiogram.md) first to choose the right Context7 library and version before quoting API details.
272. Read [references/i18n-with-aiogram-i18n.md](references/i18n-with-aiogram-i18n.md) for setup, locale files, registration, and runtime behavior.
283. Read [references/i18n-managers.md](references/i18n-managers.md) for `BaseManager`, `ConstManager`, `MemoryManager`, `FSMManager`, and `RedisManager`.
294. Read [references/replies-and-topics.md](references/replies-and-topics.md) if replies or `message_thread_id` are involved.
305. Read [references/ai-context-from-telegram-message.md](references/ai-context-from-telegram-message.md) if the task is about what quote or forward-origin context to pass into AI logic.
316. Read [references/callback-and-command-patterns.md](references/callback-and-command-patterns.md) for typed callback and command handler structure.
327. Read [references/middleware-order.md](references/middleware-order.md) if behavior depends on middleware interactions.
338. Reuse the bundled scripts instead of re-deriving Telegram edge case handling from scratch.
34 
35## Included references
36- [references/context7-aiogram.md](references/context7-aiogram.md)
37- [references/i18n-with-aiogram-i18n.md](references/i18n-with-aiogram-i18n.md)
38- [references/i18n-managers.md](references/i18n-managers.md)
39- [references/replies-and-topics.md](references/replies-and-topics.md)
40- [references/ai-context-from-telegram-message.md](references/ai-context-from-telegram-message.md)
41- [references/callback-and-command-patterns.md](references/callback-and-command-patterns.md)
42- [references/middleware-order.md](references/middleware-order.md)
43 
44## Included scripts
45- `scripts/topic_aware_reply_helpers.py`
46- `scripts/i18n_callback_query.py`
47- `scripts/forward_origin_context.py`
48 
49## Scope
50This skill focuses on Telegram update semantics and aiogram 3 handler patterns.
51 
52It does not try to teach:
53- beginner aiogram setup
54- project-specific wiring frameworks
55- database architecture
56- generic Python basics
57 
58When exact API surface matters, prefer Context7 over memory and pin aiogram lookups to the closest aiogram 3 version that matches the target project.
59