the signals and their derived score are provisional and subject to change.
validate manually before sharing.
ac969359f2ca463d0c0540b820cf362dfeb28bf6none
AGENTS.md# Точка входа для агента massCode
Отвечай всегда на русском.
massCode — это приложение на Electron + Vue 3 + TypeScript с TailwindCSS v4 в renderer, API-маршрутами на Elysia в main process, markdown vault как основным хранилищем пользовательского контента в v5 и `store.app` / `store.preferences` для локального UI state и настроек.
## Всегда действую---
name: release-notes
description: Use when generating massCode release notes for a GitHub release. Writes the notes to a gitignored file `docs/releases/<tag>.md` for the user to paste into the GitHub release. Use when summarizing merged PRs of a version into a consistent release notes structure.
---
# Release Notes
## Overview
Этот skill генерирует release notes одного релиза `vX.Y.Z` для вставки в GitHub release. Цель — единая повторяемая с---
name: github-workflow
description: Use when working with massCode issues, branches, commits, pull requests, or merge preparation in GitHub.
---
# github-workflow
## Issue
Если работа идёт по issue, читать его через `gh`:
```bash
gh issue view <number> -R massCodeIO/massCode
```
Если issue описывает bug, не считай его автоматически подтверждённым.
Сначала:
1. понять ожидаемое поведение;
---
name: api-and-typing
description: Use when defining or reviewing massCode renderer types that come from generated API clients or DTOs, especially when deciding whether to reuse existing API shapes, derive narrower local types, or introduce a UI-only model.
---
# API And Typing
## Overview
Для massCode API types считаются generated-first. Если данные пришли из `~/renderer/services/api/generated` или соответствуют DTO из `src/main/api/dto`, сначала---
name: development-workflow
description: Use when following massCode repo workflow rules, especially for scoped lint and test commands, or when changes require required follow-up commands like code generation or locale sync.
---
# Development Workflow
## Overview
В massCode workflow rules считаются частью качества изменений. Для локальной задачи команды должны быть точечными, а изменения source-of-truth файлов---
name: i18n
description: Use when changing massCode localization, adding user-facing strings, creating locale keys, or wiring text through the project's translation system.
---
# I18n
## Overview
В massCode новый пользовательский текст всегда проходит через localization system. Базовым source of truth для новых ключей считается английская локаль.
## Localization Rules
- Поддерживаемые локал---
name: architecture-standards
description: Use when working in massCode and you need repo-wide architecture rules, naming conventions, decomposition boundaries, or guidance on which massCode skill to load next.
---
# Architecture Standards
## Overview
Базовый принцип проекта: **YAGNI и простота прежде всего**. Не усложняй код ради гипотетических сценариев, не строй абстракции без повторяющей---
name: ui-primitives
description: Use when building or refactoring massCode UI components with local Ui primitives or Shadcn, especially for cn, cva, notifications, and rules against reimplementing basic controls.
---
# UI Primitives
## Overview
Базовые UI-элементы в massCode должны собираться из существующих `Ui*` компонентов и Shadcn-паттернов. Этот skill отвечает за component-level usage rules, а не за общую ---
name: electron-api-and-ipc
description: Use when changing massCode API routes, DTOs, IPC handlers, Electron bridges, or any renderer-to-main communication and storage-access boundaries.
---
# Electron API And IPC
## Overview
Все backend-возможности massCode живут в main process. Renderer получает доступ к данным и системным операциям только через Elysia API или IPC channels.
## Renderer Access Rules
- В renderer для да---
name: vue-renderer-standards
description: Use when editing massCode renderer code in Vue 3, especially for script setup patterns, import rules, composables, shared state, and renderer-side conventions.
---
# Vue Renderer Standards
## Overview
Renderer в massCode строится на Vue 3 Composition API с `<script setup lang="ts">`. Здесь важны строгие import rules, composable-first state sharing и запрет на прямой доступ к backend-возможностям.
---
name: ui-foundations
description: Use when defining or reviewing massCode UI foundation rules such as typography, renderer styling consistency, TailwindCSS v4 usage, and when raw markup starts competing with established UI text patterns.
---
# UI Foundations
## Overview
UI в massCode должен оставаться визуально консистентным. Этот skill отвечает за базовые styling decisions: как относиться к typography, когда исполь---
name: documentation-workflow
description: Use when adding or updating massCode documentation, documenting a new feature, changing docs website pages, adding docs assets, updating the VitePress sidebar, or adding README feature mentions.
---
# Documentation Workflow
## Overview
Документация massCode живёт в VitePress сайте в `docs/website/documentation`. README — это общий обзор проекта, а не источник детального описания фич---
name: spaces-architecture
description: Use when working on massCode spaces such as code, notes, math, or tools, especially when changing their state, behavior, synchronization, or spaces IPC channels.
---
# Spaces Architecture
## Overview
massCode использует систему Spaces для разделения функциональных областей. Это не просто UI tabs: у каждого space есть собственное состояние, свои правила обnone