buhuchet

Install

git clone https://github.com/head790/buhuchet.git
cd buhuchet
claude

This is third-party code. Review the repository files before installing.

What it does

The set turns a project folder into bookkeeping for a Russian sole proprietor (IP). Company details, the income and expense journal, counterparties and paid taxes live in YAML and CSV files that the commands read and append to. One group generates invoices, acts and contracts, calculates tax under USN 6% and 15%, patent and NPD, insurance contributions, deadlines and declaration figures. The other group answers personal questions: how much you can spend after the tax reserve, what your margin is, what price to charge and whether cash will last. A regime comparison shows which tax regime is cheaper at current income.

Who it is for. For Russian sole proprietors and self-employed people who keep their own books and want Claude Code to handle taxes and paperwork.

Example request

/ip-налог Q1 2026

Limitations

This is not certified accounting software or tax advice. Rates, limits, deadlines and budget codes are hardcoded for 2025-2026 and must be checked against the tax service site and updated by hand. Balance is estimated from the journal, not a bank statement. It requires Claude Code with a paid plan or API, which does not work from Russia without a VPN. The repository has no license file; the README says MIT.

How to disable. Delete the .claude/skills folder in the cloned repository or stop running Claude Code in that folder.

Security check

• Appends records to local bookkeeping files
• An outdated hardcoded rate or deadline leads to a wrong tax amount

README in short

The README describes 16 Claude Code commands for sole proprietors, split into documents and calculations for the state and a financial picture for the owner. Quick start: clone the repo, fill in your details, clear the samples and run claude in the folder. Each command has sample output, and the data file formats and a 2025-2026 rate table are documented. It ends with a disclaimer and an offer of paid customization.

SKILL.md

Рассчитай налог для ИП.

Аргументы: $ARGUMENTS
Формат: период (опционально). Примеры: "Q1 2025", "2025", "Q3". Без аргументов — текущий квартал.

## Инструкции

1. Прочитай `data/profile.yaml` — определи налоговый режим
2. Прочитай `data/journal.csv` — просуммируй доходы и расходы за период
3. Прочитай `data/payments.yaml` — найди уплаченные авансы и взносы за период

## Определение периода

- Если указан квартал (Q1, Q2, Q3, Q4) — расчёт **нарастающим итогом** с начала года до конца указанного квартала
- Q1: январь-март, Q2: январь-июнь, Q3: январь-сентябрь, Q4: январь-декабрь
- Если указан год — годовой расчёт
- Без аргументов — текущий квартал нарастающим итогом

## Формулы расчёта

### УСН 6% (доходы)

```
налоговая_база = сумма_доходов_нарастающим_итогом
начисленный_налог = налоговая_база × 6%
вычет_взносов = min(уплаченные_взносы_в_периоде, начисленный_налог)
    # 100% вычет для ИП без сотрудников
налог_к_уплате = начисленный_налог − вычет_взносов − уплаченные_авансы
если налог_к_уплате < 0: переплата (зачтётся в следующем периоде)
```

Related