Перейти к основному содержимому

О проекте SafeVibe Knowledge Base

SafeVibe — это база знаний вайб-кодеров: гайды, обзоры инструментов, рабочие процессы и мини-аппы, которые помогают собирать и использовать знания сообщества.

На этой странице — обзор структуры базы и первый ориентир, куда идти дальше.

Основные разделы базы​

Вся документация структурирована по доменам (подробнее см. meta/taxonomy):

  • Concepts — базовые идеи и философия вайб-кодинга.

    • Что такое вайб-кодер.
    • Принципы работы с базой знаний и мини-аппами.

  • Tools — инструменты и сервисы.

    • IDE, плагины, AI-инструменты (включая агентов и LLM).
    • Обзоры, сравнения, best practices по настройке.

  • Workflows — рабочие процессы и чек-листы.

    • Как запускать типовые сценарии (playbooks).
    • Конвейеры: от идеи до мини-аппы или статьи.

  • Apps — мини-аппы SafeVibe.

    • Документация и гайды по мини-аппам.
    • TagExplorer, планировщики, визуализации и другие интерактивы.

  • Community — сообщество и форматы.

    • Как присоединиться к чатам и каналам.
    • Правила и договорённости внутри сообщества.

  • Meta — архитектура и правила.

    • Как устроен этот репозиторий.
    • Таксономия, стиль контента, роли агентов.

Типы заметок и теги​

Каждая заметка имеет тип и теги (описаны подробнее в meta/taxonomy и .rules/content):

  • Типы (type):

    • guide — пошаговый гайд.
    • reference — справочная информация.
    • review — обзор инструмента или ресурса.
    • pattern — паттерн/практика.
    • playbook — сценарий с шагами.

  • Теги (tags) помогают фильтровать контент:

    • Тематика: ai, automation, frontend, backend, obsidian, docusaurus, shadcn, tools, productivity.
    • Уровень: beginner, intermediate, advanced.
    • Статус: draft, stable, needs-review.

Рекомендация: у каждой заметки минимум один тематический и один типовой тег.

Как пользоваться базой​

  1. Старт для чтения

    • Начни с раздела Concepts, чтобы понять философию.
    • Перейди к Tools и Workflows, чтобы подобрать стек и рабочие сценарии.

  2. Поиск по тегам

    • Используй встроенный поиск Docusaurus.
    • Ориентируйся по тегам и структуре сайдбара.

  3. Мини-аппы

    • Раздел Apps собирает интерактивные штуки поверх базы.
    • Со временем здесь появятся TagExplorer, планировщики стеков и др.

Как контрибьютить​

Если ты хочешь добавить или улучшить заметку:

  1. Ознакомься с разделами:

    • meta/contributing — процесс контрибьюции.
    • meta/content-style — стиль и структура статей.
    • .rules/content — строгие правила по фронтматтеру и именованию файлов.

  2. Выбери подходящий шаблон из meta/templates (guide/review/pattern/playbook).

  3. Создай новую заметку в нужной папке (concepts, tools, workflows, apps, community, meta).

  4. Открой Pull Request с коротким описанием, какие проблемы решает твоя заметка.

Дальше​

  • Посмотри раздел Meta, чтобы лучше понять архитектуру SafeVibe.
  • Загляни в Tools и Workflows, чтобы собрать свой стартовый стек вайб-кодинга.
  • Подпишись на каналы сообщества (ссылки будут в разделе Community).