{"id":50112470,"url":"https://github.com/core-euler/aidd","last_synced_at":"2026-05-23T13:05:44.326Z","repository":{"id":341228040,"uuid":"1150545788","full_name":"core-euler/aidd","owner":"core-euler","description":"AI Driven Development","archived":false,"fork":false,"pushed_at":"2026-05-09T10:02:01.000Z","size":165,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-09T12:09:06.179Z","etag":null,"topics":["ai","documentation","llm","specification"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/core-euler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-05T12:07:28.000Z","updated_at":"2026-05-09T10:02:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/core-euler/aidd","commit_stats":null,"previous_names":["core-euler/aidd"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/core-euler/aidd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/core-euler%2Faidd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/core-euler%2Faidd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/core-euler%2Faidd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/core-euler%2Faidd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/core-euler","download_url":"https://codeload.github.com/core-euler/aidd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/core-euler%2Faidd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33396640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","documentation","llm","specification"],"created_at":"2026-05-23T13:05:43.468Z","updated_at":"2026-05-23T13:05:44.314Z","avatar_url":"https://github.com/core-euler.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# LLM-Driven Development\n\nМетодология разработки программного обеспечения, где главным артефактом является не код, а документация. Код генерируется нейросетью на основе спецификаций.\n\n## Идея\n\n**Традиционный подход:**\n```\nРазработчик → Код → Документация (если повезёт)\n```\n\n**LLM-Driven подход:**\n```\nРазработчик → Документация + Тесты → LLM → Код\n```\n\nКод становится производной от документации. Если код потерян — его можно воспроизвести. Если разработчик ушёл — знания остались.\n\n## Главный принцип\n\n**Контекст — главное оружие.**\n\nLLM имеет ограниченное контекстное окно. Каждый символ на счету. Поэтому:\n- Больше сути, меньше воды\n- Никакого кода в документации\n- Никакого псевдокода\n- Только человеческий язык и схемы\n\n## Для кого\n\nДля инженеров, которые:\n- Понимают архитектуру программных систем\n- Умеют работать с LLM\n- Хотят ускорить разработку в разы\n- Готовы думать на уровне \"что делаем\", а не \"как пишем\"\n\n**Важно:** LLM — усилитель, не замена. Методология требует технического понимания. Человек без навыков не воспроизведёт проект даже с идеальной документацией.\n\n## Что в репозитории\n\n```\n├── method.md               # Методичка LLM‑Driven разработки\n├── spawn.md                # Промпт для репродукции\n├── reproducibility.md      # Концепция воспроизводимости\n├── demo/                   # Демо‑проект (aiogram + PostgreSQL)\n│   ├── docs/               # Полный набор артефактов воспроизводимости\n│   ├── bot/                # Реализация бота\n│   └── docker-compose.yml  # Оркестрация окружения\n└── .claude/                # Локальная инфраструктура промптов/стандартов\n    ├── agents/             # Роли и системные агенты\n    ├── commands/           # Шаблоны команд\n    ├── standards/          # Стандарты и правила\n    ├── PROCESS.md          # Процесс разработки\n    ├── RULES.md            # Правила работы\n    └── README.md           # Описание структуры .claude\n```\n\n## Демо‑проект\n\nВ `demo/` находится реальный проект GameTODO Bot, реализованный на aiogram. Документация в `demo/docs/` позволяет воспроизвести продукт без доступа к коду.\n\nКлючевые артефакты воспроизводимости:\n- `demo/docs/SPEC.md`\n- `demo/docs/DNA.md`\n- `demo/docs/DNA_MAP.md`\n- `demo/docs/TEST_CONTRACT.md`\n- `demo/docs/ANTIPATTERNS.md`\n\nЗапуск демо:\n```\ndocker-compose up\n```\n\n## Быстрый старт\n\n### 1. Создай спецификацию\n\nВозьми ТЗ от заказчика. Загрузи в Claude Opus (или аналог). Потребуй задать уточняющие вопросы. Отвечай подробно. Получи спецификацию.\n\n### 2. Разбей на этапы\n\nКаждый этап должен:\n- Давать видимый результат\n- Быть тестируемым вручную\n- Первый этап — всегда клиентская сторона\n\n### 3. Документируй без кода\n\nОписывай словами: что делает функция, какие данные на входе, какие на выходе, какие ошибки возможны. LLM сам решит, как это написать.\n\n### 4. Пиши тесты до реализации\n\nТесты — второй источник истины после документации. TDD обязателен.\n\n### 5. Фиксируй ошибки\n\n- `issues.md` — проблемы логики и архитектуры\n- `antipatterns.md` — ошибки выполнения с трейсбэками\n\n### 6. Актуализируй документацию\n\nОдна версия. Без spec-v1, spec-v2, spec-v3. Только актуальное состояние + changelog.\n\n## Ключевые правила\n\n| Правило | Почему |\n|---------|--------|\n| Никакого кода в документации | LLM воспринимает код как директиву и слепо следует |\n| Одна версия документации | Множество версий = хаос и рассинхрон |\n| Один чат = одна роль | Чистый контекст, фокус, качество |\n| Не трогать работающий код | LLM любит \"улучшать\" то, что работает |\n| Docker Compose обязателен | Воспроизводимость окружения |\n| Частые коммиты | Git спасает, когда LLM ломает |\n\n## Воспроизводимость\n\nЦель методологии — **полная воспроизводимость**.\n\nПроект считается воспроизводимым, если инженер с навыками LLM может получить работающий продукт из документации за 0-2 итерации.\n\n**Уровни:**\n\n| Уровень | Итерации | Описание |\n|---------|----------|----------|\n| 4 | 0 | Идеал. Работает с первого раза |\n| 3 | 1-2 | Хорошо. Минорные уточнения |\n| 2 | 3-4 | Средне. Есть пробелы |\n| 1 | 5+ | Плохо. Требует автора |\n| 0 | — | Невоспроизводимо |\n\nПодробнее: [reproducibility.md](reproducibility.md)\n\n## .claude\n\nПапка `.claude/` содержит локальные агенты, правила и шаблоны команд для работы с LLM‑инструментами. Актуальная структура и назначение описаны в `.claude/README.md`.\n\n## Роль человека\n\nЧеловек управляет системой. Он обязан понимать:\n- Архитектуру\n- Инфраструктуру\n- Бизнес-логику\n\nЧеловеку НЕ нужно знать:\n- Синтаксис языка\n- Алгоритмы сортировки\n- Как устроены декораторы\n\n**Архитектурное мышление важнее навыков кодинга.**\n\n## Лицензия\n\nMIT\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcore-euler%2Faidd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcore-euler%2Faidd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcore-euler%2Faidd/lists"}