# SDD MCP — Spec-Driven Development

> Сервис превращает идею в систему через пайплайн specify → analyze → plan →
> tasks → implement, храня артефакты как Markdown-файлы. Доступен и как
> MCP-сервер (для AI-агентов), и как обычные веб-страницы с доступом по токену
> в URL — чтобы LLM, умеющие только открывать ссылки, могли читать и писать .md.

Автор проекта: Марат Зимнуров. По материалам: https://courses.digitable.life/post/blog/advancedprompting-sdd/

Главное:
- MCP-эндпоинт (Streamable HTTP, спец. 2025-11-25): https://sdd.gpu.local-xyz.ru/mcp
- Авторизация: персональный bearer-токен (вид `sdd_...`). Токен = изолированное
  рабочее пространство (workspace). Один токен видит только свои файлы.
- Для LLM без MCP: всё доступно по обычным GET-ссылкам с токеном в пути
  `/t/<token>/...`. Можно читать и писать только Markdown-файлы.

## Документация
- [Как всё устроено (HTML)](https://sdd.gpu.local-xyz.ru/docs): подробное описание архитектуры, MCP и URL-API.
- [То же в Markdown](https://sdd.gpu.local-xyz.ru/docs.md): сырой Markdown для LLM.

## Быстрый старт для веб-LLM (только GET-ссылки)
- [Получить токен](https://sdd.gpu.local-xyz.ru/token/new): открой ссылку — вернётся новый токен `sdd_...`. Сохрани его.
- Список проектов:        GET https://sdd.gpu.local-xyz.ru/t/<token>
- Список файлов проекта:  GET https://sdd.gpu.local-xyz.ru/t/<token>/<project>
- Прочитать файл:         GET https://sdd.gpu.local-xyz.ru/t/<token>/<project>/<file>.md
- Создать/записать файл:   GET https://sdd.gpu.local-xyz.ru/t/<token>/<project>/<file>.md?content=<URL-encoded Markdown>
- Дописать в конец:        GET https://sdd.gpu.local-xyz.ru/t/<token>/<project>/<file>.md?append=<URL-encoded Markdown>
- Дописать в СЕКЦИЮ:        GET https://sdd.gpu.local-xyz.ru/t/<token>/<project>/<file>.md?section=<заголовок>&append=<URL-encoded>
- Заменить секцию:         GET https://sdd.gpu.local-xyz.ru/t/<token>/<project>/<file>.md?section=<заголовок>&content=<URL-encoded>
- Можно только файлы с расширением .md. Проект создаётся автоматически при первой записи.
- Большой документ собирайте несколькими GET-запросами по секциям (?section=...&append=...),
  чтобы не упереться в лимит длины URL.

## Этапы SDD (имена файлов)
- spec.md — спецификация (этап 1)
- analysis.md — анализ (этап 2)
- plan.md — план (этап 3)
- tasks.md — задачи (этап 4)
- progress.md — прогресс (этап 5)

## MCP (для агентов с поддержкой MCP)
- Инструмент без авторизации: get_token → выдаёт токен.
- ВАЖНО: если заголовок Authorization не задан заранее, подставить его в середине
  сессии нельзя — поэтому передавайте токен АРГУМЕНТОМ `token` в каждом вызове
  инструмента (рабочий путь в один проход). Заголовок Authorization: Bearer <token>
  удобен, только если токен уже известен заранее и прописан до подключения.
- Бонус: любой защищённый вызов без токена вернёт в тексте ошибки свежий токен —
  просто повторите вызов, добавив "token": "<выданный токен>".
- Слэш-команды: /get_token, /specify, /analyze, /plan, /tasks, /implement