# prompt-alchemist-code
Turns vague ideas into perfect AI specifications in 5 minutes
# 🔮 Промпт-Алхимик Кода

> **Превращает размытые идеи в идеальные технические задания для ИИ за 5 минут**

[![Live Demo](https://img.shields.io/badge/demo-live-success)](https://totiks2012.github.io/prompt-alchemist-code/)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Vanilla JS](https://img.shields.io/badge/vanilla-JS-yellow)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)

---

## 🎯 Проблема

**Разработчики тратят 80% времени на итерации с ИИ из-за плохо сформулированных промптов:**

```
❌ Обычный путь:
Идея → Промпт → Плохой код → Уточнение → Новый код → 
Еще уточнение → Еще код → Наконец работает

⏱️ Время: 2-3 часа на простую задачу
```

---

## ✨ Решение

**Промпт-Алхимик проводит структурированное интервью и генерирует идеальное ТЗ:**

```
✅ С Алхимиком:
Идея → Интервью 5 мин → Структурированное ТЗ → 
Работающий код С ПЕРВОГО РАЗА + 2-3 уточняющие

⏱️ Время: 15-20 минут TOTAL
📊 Экономия: 87%
```

---

## 🚀 Возможности

### 🎯 **Библиотеки готовых пресетов:**
- **Проблемы и решения** — типовые задачи автоматизации, обработки данных, веб-разработки
- **Технологии** — языки, фреймворки, базы данных, облачные платформы
- **Целевая аудитория** — от новичков до enterprise
- **Функциональность** — от базовых до продвинутых возможностей

### 🏗️ **3D-Конструкт программы:**
Структурированные шаблоны с элементами:
- Основная проблема
- Целевое решение
- Ключевые функции
- Технический стек
- Пользовательский сценарий
- Уникальное преимущество

### 💬 **Два режима работы:**

#### 1. Режим интервью (по умолчанию)
ИИ задает уточняющие вопросы и формирует идеальное ТЗ пошагово

#### 2. Стандартный режим
Быстрая генерация ТЗ из готовых компонентов

---

## 📖 Как использовать

### Шаг 1: Опишите идею
Кликните **💡 Идея проекта** и напишите что хотите создать

### Шаг 2: Выберите параметры (опционально)
Раскомментируйте нужные строки в секциях:
- 🎯 Проблемы & Решения
- ⚙️ Технологии
- 👥 Целевая аудитория
- 🚀 Функциональность
- 🏗️ 3D-Конструкт

### Шаг 3: Сгенерируйте промпт
Кликните **🔮 Сгенерировать промпт**

### Шаг 4: Скопируйте и используйте
Отправьте промпт в ChatGPT, Claude, или другой ИИ

---

## 💎 Реальный пример

### Результат использования:
**Задача:** Создать менеджер задач  
**Время интервью:** 5-10 минут  
**Результат:** [Работающее приложение](https://github.com/totiks2012/ai-todo-manager-demo) с первой итерации

**ТЗ которое создал Алхимик →**

Пример ТЗ:

ТЕХНИЧЕСКОЕ ЗАДАНИЕ: "Персональный ассистент для планирования дня"

1. ЦЕЛЬ И КОНТЕКСТ ИСПОЛЬЗОВАНИЯ

Решаемая проблема: Создание простого, кроссплатформенного и интуитивного инструмента для планирования дня, интегрированного непосредственно в рабочий процесс в браузере на компьютере.

Ключевое преимущество: Минимизация переключения контекста за счёт работы в закреплённой вкладке браузера. Полная независимость от операционной системы (Windows, macOS, Linux).

Целевая аудитория: Обычные пользователи, работающие за компьютером, ценящие простоту и минимализм.

2. ФУНКЦИОНАЛЬНЫЕ ТРЕБОВАНИЯ

2.1. Управление задачами:

Создание нескольких напоминаний на одну дату.

Поля для ввода: текст напоминания, время срабатывания.

Выбор приоритета из трёх предустановленных цветов (красный — очень важно, жёлтый — необходимо, зелёный — не очень важно).

Редактирование и удаление существующих задач по двойному клику на них.

Возможность отметить задачу как "завершённая" (визуально — зачёркивание текста задачи).

2.2. Календарь и интерфейс:

Главный экран: календарь текущего месяца с автоматической сменой при изменении месяца.

Отображение в ячейке даты счётчика количества задач на этот день.

При наведении курсора на ячейку — всплывающая подсказка (tooltip) со списком задач и их приоритетами.

При клике на число календаря справа открывается панель для ввода/просмотра задач на выбранную дату.

Наличие "рычажка" для ручного переключения между тёмной и светлой темой. Состояние темы должно сохраняться.

2.3. Система уведомлений:

Использование нативных браузерных уведомлений (всплывают в ОС).

Визуальное оповещение в браузере: мигание заголовка вкладки (favicon) или её подсветка.

Звуковое уведомление. Пользователь должен иметь возможность один раз загрузить свой MP3-файл, который будет сохранён в localStorage и использоваться для всех уведомлений.

2.4. Управление данными и архивация:

Все данные (задачи, настройки темы, звук) хранятся в localStorage браузера.

Автоматический перенос задач: При первом открытии приложения в новом месяце все незавершённые задачи из предыдущего месяца переносятся на те же числа нового месяца. Пользователю показывается соответствующее уведомление.

Экспорт/Импорт: Функция для скачивания резервной копии всех данных в один JSON-файл и его последующего восстановления.

Архивация: Кнопка для ручной очистки localStorage от архивных данных (всех данных, кроме задач за текущий месяц).

3. ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ

Стек технологий: Vanilla JavaScript, HTML5, CSS3. Вся логика должна быть реализована в рамках одного HTML-файла.

Хранение данных: localStorage браузера.

Кроссплатформенность: Веб-приложение должно корректно работать в современных браузерах (Chrome, Firefox, Safari, Edge) на разных ОС.

Адаптивный дизайн: Интерфейс должен корректно отображаться на экранах разных размеров.

---------

** Сгенерированый код работает с первого раза!** потребуются 1 итерация + 2-3 уточняющие

можете сами попробовать скопировав это ТЗ и вставив его в ИИ.
---

## 🛠️ Технологии

- **Vanilla JavaScript** — никаких зависимостей
- **HTML5 + CSS3** — современный интерфейс
- **LocalStorage** — сохранение данных
- **Адаптивный дизайн** — работает на всех устройствах

---

## 📦 Установка



```bash
git clone https://github.com/totiks2012/prompt-alchemist-code.git
cd prompt-alchemist-code
# Откройте index.html в браузере
```
или просто скачайте raw файл с https://github.com/totiks2012/prompt-alchemist-code/tree/main и запустите index.html и запустите в любом браузере

---

## 🎨 Возможности

- ✅ **Темная и светлая темы**
- ✅ **Автосохранение в LocalStorage**
- ✅ **Экспорт/импорт конфигураций**
- ✅ **Библиотека готовых шаблонов**
- ✅ **Режим интервью для детализации**
- ✅ **Один HTML файл — работает везде**

---

## 📚 Документация

### Структура промпта в режиме интервью:
```
1. Исходные данные пользователя
2. 3D-конструкт (если заполнен)
3. Инструкции для ИИ-интервьюера
4. Структура технического задания
5. Пошаговые вопросы
```

### Структура промпта в стандартном режиме:
```
ИНСТРУКЦИЯ ДВИЖКУ: СОЗДАТЬ ТЕХНИЧЕСКОЕ ЗАДАНИЕ

ОСНОВНАЯ ИДЕЯ: [...]
ПРОБЛЕМЫ ДЛЯ РЕШЕНИЯ: [...]
ТЕХНОЛОГИЧЕСКИЙ СТЕК: [...]
ЦЕЛЕВАЯ АУДИТОРИЯ: [...]
ФУНКЦИОНАЛЬНЫЕ ТРЕБОВАНИЯ: [...]
3D-КОНСТРУКТ: [...]

СОЗДАЙ:
1. Детальное техническое задание
2. Архитектуру системы
3. Пользовательские сценарии
4. API спецификации
5. План разработки
```

---

## 🤝 Вклад в проект

Приветствуются:
- 🐛 Сообщения об ошибках
- 💡 Идеи новых функций
- 📝 Дополнения к библиотекам пресетов
- 🎨 Улучшения интерфейса

---

## 📄 Лицензия

**GNU General Public License v3.0**

Этот проект распространяется под лицензией GPL-3.0. Вы можете свободно использовать, изменять и распространять этот код, при условии что производные работы также будут распространяться под GPL-3.0.

См. файл [LICENSE](LICENSE) для подробностей.

---

## 👨‍💻 Автор

**[@totiks2012](https://github.com/totiks2012)**

Создано с целью решить проблему неэффективной работы с ИИ при разработке программного обеспечения.

---

## ⭐ Если проект полезен

Поставьте звезду ⭐ и поделитесь с коллегами!