# Botforge

> Production-grade Telegram bot engineering skill for Gemini CLI. Use when creating, extending, refactoring, reviewing, testing, securing, or deploying Telegram bots in Python with aiogram 3, Bot API 10.0, PostgreSQL, Redis, Docker, payments, Mini Apps, admin panels, or broadcast systems.

- Skill: `zulut30/botforge-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zulut30/botforge-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zulut30/botforge-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Zulut30 (https://skillmd.com/u/zulut30)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zulut30/botforge-3

---


# BotForge v1.8.0 for Gemini CLI

Load the canonical BotForge instructions from `AGENTS.md`. If the task needs the full skill workflow or detailed references, read `.claude/skills/botforge/SKILL.md` and only the specific reference file needed from `.claude/skills/botforge/references/`.

Use the six-stage workflow for new bots: Business brief, ADR, Project tree, Files, Self-review, Deployment. For small fixes, use the Bypass Protocol in `AGENTS.md`.

Hard bans remain active: no secrets in code, no blocking I/O or `requests`, no invented Telegram/aiogram APIs, no ORM outside repositories, no business logic in handlers, no unverified payments/webhooks, no dead Telegram UI.