SDD MCP — Spec-Driven Development

MCP 2025-11-25 Elixir / Bandit llms.txt · этот документ в Markdown

Идея → система, которую понимают и люди, и ИИ. Пайплайн specify → analyze → plan → tasks → implement; артефакты — Markdown-файлы.

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

Два способа подключения

1. MCP — для AI-агентов

Эндпоинт Streamable HTTP: https://sdd.gpu.local-xyz.ru/mcp

Инструмент get_token (без авторизации) выдаёт персональный токен sdd_….
Передача токена: если заголовок Authorization не задан до подключения, подставить его в середине сессии нельзя — передавайте токен аргументом token в каждом вызове (путь в один проход). Заголовок Authorization: Bearer <token> — только если токен известен заранее.
Онбординг в один шаг: защищённый вызов без токена вернёт свежий токен прямо в тексте ошибки — повторите вызов с "token": "<выданный>".
Инструменты: get_token, whoami, create_project, list_projects, specify, analyze, plan, tasks, implement, read_artifact, project_status.
Слэш-команды: /get_token /specify /analyze /plan /tasks /implement.

{
  "mcpServers": {
    "sdd": {
      "type": "http",
      "url": "https://sdd.gpu.local-xyz.ru/mcp",
      "headers": { "Authorization": "Bearer sdd_ВАШ_ТОКЕН" }
    }
  }
}

2. Token-in-URL — для LLM, умеющих только открывать ссылки

Только Markdown-файлы. Токен в пути URL.

Действие	Запрос
Получить токен	`GET /token/new`
Список проектов	`GET /t/<token>`
Список файлов проекта	`GET /t/<token>/<project>`
Прочитать файл	`GET /t/<token>/<project>/<file>.md`
Записать файл	`GET /t/<token>/<project>/<file>.md?content=…`
Дописать в конец	`GET /t/<token>/<project>/<file>.md?append=…`
Дописать в секцию	`GET …/<file>.md?section=<заголовок>&append=…`
Заменить секцию	`GET …/<file>.md?section=<заголовок>&content=…`

Также работают PUT/POST с телом запроса (для больших файлов). Имя файла — только [A-Za-z0-9_.-]+.md. Проект создаётся автоматически при записи.

Частичная сборка по секциям: большой документ можно собрать несколькими небольшими GET-запросами — по одному на секцию (?section=Заголовок&append=кусок), чтобы не упираться в лимит длины URL. Секция ищется по тексту заголовка; если её нет — создаётся.

curl "https://sdd.gpu.local-xyz.ru/token/new"
curl "https://sdd.gpu.local-xyz.ru/t/sdd_XXX/pohudenie/spec.md?content=%23%20Spec%0AЦель"
curl "https://sdd.gpu.local-xyz.ru/t/sdd_XXX/pohudenie/spec.md"

Этапы и файлы

Этап	Файл
1. specify	`spec.md`
2. analyze	`analysis.md`
3. plan	`plan.md`
4. tasks	`tasks.md`
5. implement	`progress.md`

Изоляция и безопасность

Токен = изолированный workspace; чужие файлы недоступны, разрешены только *.md.
Токен в URL удобен для веб-LLM, но URL попадают в логи — не для чувствительных данных; при утечке заведите новый (/token/new).

Авторство

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

Полное описание: /docs.md · индекс для LLM: /llms.txt