Форматы контента

export WORKSPACE=/opt/claude-workspace    # КОД (git)
export DATASPACE=/mnt/beget-s3            # ДАННЫЕ (S3)
export MEDIASPACE=$DATASPACE/media        # МЕДИА (S3)

.jpg → ТОЛЬКО $MEDIASPACE (NO EXCEPTIONS)
.png → $WORKSPACE если < 50KB, иначе $MEDIASPACE
.svg → ТОЛЬКО $WORKSPACE (векторная графика)

CODE:   .py .js .ts .tsx .jsx .php .go .c .cpp .h .sh .bat .ps1
DOCS:   .md .ai.md .txt .rst
CONFIG: .yaml .yml .json .toml .ini .conf .xml .env.example
WEB:    .html .css .less .scss .svg .woff2 .ttf
TPL:    .twig .tpl .j2
SQL:    .sql
IMAGES: .svg (любой), .png (<50KB), .ico (<20KB)
MISC:   .gitignore .gitkeep .editorconfig Dockerfile Makefile LICENSE

IMAGES:  .jpg .jpeg .gif .webp .png (>50KB)
MEDIA:   .mp4 .avi .mov .mp3 .wav
DOCS:    .pdf .docx .doc .rtf
DATA:    .xlsx .xls .ods .csv (>100KB)
DB:      .db .sqlite
CREDS:   .env .key .pem (приватные)
TEMP:    .pyc .log .tmp .cache
DEPS:    venv/ node_modules/ __pycache__/ .so .exe

# Зависимости
venv/
node_modules/
__pycache__/

# Компиляция
*.pyc
*.pyo
*.so
*.exe

# Базы данных
*.db
*.sqlite
*.sqlite3

# Credentials
.env
*.key
*.pem
.credentials.md

# Временные
*.log
*.tmp
*.cache
.DS_Store

# Изображения (массовые)
*.jpg
*.jpeg
*.gif
*.webp

# Данные
*.xlsx
*.xls
*.ods

# Медиа
*.mp4
*.avi
*.mov
*.mp3
*.wav

# Документы
*.pdf
*.docx
*.doc

# Архивы данных
*.zip
*.tar.gz

# IDE
.idea/
.vscode/
*.swp

# Исключения
!*.svg
!favicon.png
!logo.png

# Найти запрещенные файлы
git ls-files | grep -E '\.(jpg|jpeg|xlsx|mp4|db)$'

# Найти файлы > 1MB
git ls-files | while read file; do
  size=$(git cat-file -s $(git ls-tree HEAD "$file" | awk '{print $3}') 2>/dev/null)
  if [ $size -gt 1048576 ]; then
    echo "$file: $size bytes"
  fi
done

# 1. Стандартная библиотека
import os
import sys

# 2. Сторонние библиотеки
import requests
from flask import Flask

# 3. Локальные модули
from library.connectors.api.ozon import OzonClient

from typing import List, Dict, Optional

def get_users(limit: int = 10) -> List[Dict[str, str]]:
    """Получить список пользователей."""
    return []

def sync_orders(api_key: str, date_from: str, limit: int = 100) -> Dict[str, int]:
    """
    Синхронизировать заказы из OZON API.

    Args:
        api_key: API ключ OZON
        date_from: Дата начала в формате YYYY-MM-DD
        limit: Максимальное количество заказов

    Returns:
        Словарь со статистикой синхронизации

    Raises:
        OrderSyncError: При ошибке синхронизации
    """

function getUsers(limit: number = 10): User[] {
  return [];
}

// Интерфейсы вместо типов (где возможно)
interface User {
  id: number;
  name: string;
}

// type — только для union/intersection
type Status = 'pending' | 'active' | 'completed';

set -euo pipefail  # остановиться при ошибке, неопред. переменной, pipefail

# Всегда кавычки для переменных
echo "User: $user_name"
cp "$source_file" "$dest_file"

# [[ ]] вместо [ ]
if [[ -f "$file" ]]; then
  echo "File exists"
fi

# local в функциях
function backup_database() {
  local db_name=$1
  local backup_dir=$2
  # ...
}

#!/bin/bash
#
# backup.sh -- резервное копирование базы данных
#
# Использование:
#   ./backup.sh DATABASE_NAME BACKUP_DIR

#!/bin/bash
set -e
echo "Running code checks..."

black --check .
ruff check .
prettier --check .
eslint .
find . -name "*.sh" -exec shellcheck {} \;

echo "All checks passed"

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  host: prod.example.com

python3 -c "import yaml; yaml.safe_load(open('file.yaml'))"

jq empty file.json
python3 -m json.tool file.json

import csv

with open('data.csv', 'r', encoding='utf-8') as f:
    reader = csv.DictReader(f)
    for row in reader:
        print(row['name'], row['price'])

import pandas as pd

df = pd.read_excel('data.xlsx', sheet_name=0)
df.to_csv('output.csv', index=False, encoding='utf-8')

created_at: 2026-02-19T10:30:00Z          # UTC
updated_at: 2026-02-19T13:30:00+03:00     # Moscow time

# YAML -> JSON
python3 -c "import yaml,json; json.dump(yaml.safe_load(open('f.yaml')),open('f.json','w'),indent=2,ensure_ascii=False)"

# CSV -> JSON
python3 -c "import csv,json; json.dump(list(csv.DictReader(open('f.csv'))),open('f.json','w'),indent=2,ensure_ascii=False)"

# Excel -> CSV
python3 -c "import pandas as pd; pd.read_excel('f.xlsx').to_csv('f.csv', index=False)"

project-name/
├── INDEX.md              ← Оглавление
├── CONCEPT.md            ← 1. Концепция и идея
├── ANALYSIS.md           ← 2. Анализ рынка
├── BUSINESS_MODEL.md     ← 3. Бизнес-модель
├── IMPLEMENTATION.md     ← 4. План реализации
├── PROJECT.md            ← Полное описание (сводка)
└── CLAUDE.md             ← Контекст для Claude

project-name/
├── INDEX.md           ← Оглавление проекта (обязательно)
├── PROJECT.md         ← Полное описание
├── CLAUDE.md          ← Контекст для Claude
└── README.md          ← Для пользователей (опционально)

# Project Name -- Оглавление

**Тип:** {business|saas|infrastructure}
**Статус:** {design|development|production}

[<- Назад к Parent Project](../INDEX.md)

## ОСНОВНЫЕ ДОКУМЕНТЫ

| Документ | Описание |
|----------|----------|
| [PROJECT.md](PROJECT.md) | Полное описание |

## О ПРОЕКТЕ

{1-2 абзаца}

## СВЯЗИ

- **Родительский:** [Parent](../INDEX.md)

[<- Назад к Parent Project](../INDEX.md)

http://docs.0kt.ru/projects/{parent}/{sub}/INDEX.md

test -f INDEX.md && echo "INDEX.md OK" || echo "INDEX.md missing"
test -f PROJECT.md && echo "PROJECT.md OK" || echo "PROJECT.md missing"
test -f CLAUDE.md && echo "CLAUDE.md OK" || echo "CLAUDE.md missing"
grep -q "Назад" INDEX.md && echo "Navigation OK" || echo "No navigation"

1. Предложить: "Предлагаю добавить в глоссарий: [термин] -- [определение]. Ок?"
2. После подтверждения -- добавить в GLOSSARY_STANDARD.md
3. Если платформенный -- также обновить глоссарий платформы

### [Термин]
**Canonical:** единственное эталонное название
**Code:** машинный код в файлах/системах
**Synonyms:** варианты, SEO-формы, разговорные названия
**Docs:** ссылки на документы
**Note:** уточнение, контекст, примеры

**Глоссарий:** [GLOSSARY_STANDARD.md](GLOSSARY_STANDARD.md)

[ТИП]: [краткое описание]

[детали если нужны]

[действие если нужно]

NEW_PROJECT: Интернет-магазин пиротехники

Клиент: Иван Петров
Бюджет: 150 000 руб
Срок: 2 месяца

/accept -- принять

TASK_DONE: PROJ-005 Сверстать главную

Исполнитель: @designer
Результат: [ссылка]

/review -- проверить

<Вопрос>?
  1) <Вариант 1>
  2) <Вариант 2>
  3) <Вариант 3>
  0) Отмена / Выход

Выбор [номер]:

echo "Что восстановить?"
echo ""
echo "  1) Полное восстановление"
echo "  2) Только workspace"
echo "  3) Только критические данные"
echo "  0) Отмена"
echo ""
read -p "Выбор: " choice

case $choice in
    1) restore_full ;;
    2) restore_workspace ;;
    3) restore_critical ;;
    0) exit 0 ;;
    *) echo "Неверный выбор" ;;
esac

# Найти все y/n вопросы
grep -r "read -p.*y/n" --include="*.sh"

# Найти все read без case
grep -A5 "read -p" *.sh | grep -v "case"