agentleFS
anatoly-techanatoly-tech/obsidian-skills/AI workspace/CLAUDE.md

obsidian-skills / AI workspace

CLAUDE.md9 starsChanged 4 months agoMITView on GitHub

Локальный файл инструкций для работы внутри AI workspace/. Может обновляться самим Claude. Концептуальные конвенции по заметкам (типы, frontmatter, теги, ссылки, провенанс) — в [[Как я веду заметки]]. Имена файлов (символы, длина, Unicode-нормализация) — в корневом CLAUDE.md секция «Имена файлов». Шаблоны — в Templates/. Перед работой с заметками прочитать [[Как я веду заметки]] и этот файл. AI workspace/ — git-репозиторий. История операций ведётся через commit'ы, отдельный журнал не используется. Когда коммитить. После того как вся задача завершена и пользователь подтвердил результат…

The file

Files
CLAUDE.md

AI workspace — инструкции для Claude

Локальный файл инструкций для работы внутри AI workspace/. Может обновляться самим Claude.

Концептуальные конвенции по заметкам (типы, frontmatter, теги, ссылки, провенанс) — в [[Как я веду заметки]]. Имена файлов (символы, длина, Unicode-нормализация) — в корневом CLAUDE.md секция «Имена файлов». Шаблоны — в Templates/. Перед работой с заметками прочитать [[Как я веду заметки]] и этот файл.

Структура директории

AI workspace/
  .git/              — git-репозиторий (история изменений)
  CLAUDE.md          — этот файл
  Люди/              — заметки о людях
  Проекты/           — заметки об активных проектах
  drafts/            — черновики и исправления
  *.md               — definition notes, evergreen idea notes, MOC (00 Topic.md)

Версионирование (git)

AI workspace/ — git-репозиторий. История операций ведётся через commit'ы, отдельный журнал не используется.

Когда коммитить. После того как вся задача завершена и пользователь подтвердил результат — один коммит. Промежуточные правки внутри задачи (итерации формулировок, ревью пользователя, откаты, уточнения) не коммитить — это раздувает историю и засоряет её отменёнными промежутками.

Что считается одной задачей:

  • compile источника от начала до финального чеклиста — один коммит, даже если пользователь делал замечания и просил переделать части.
  • deep-audit пакета (обычно 5 заметок) → один коммит.
  • vault-health-check → один коммит, если были правки; если правок нет — без коммита.
  • Заметка, созданная вне скиллов (evergreen после ответа пользователю) → коммит после того, как пользователь подтвердил, что доволен формулировкой.
  • Серия связанных правок конвенции/драфтов/шаблонов/скиллов в рамках одного обсуждения с пользователем → один коммит в конце.

Незакоммиченные файлы в git status после завершения задачи — сигнал, что синтез не сохранён. Если работа ещё идёт — норма.

Формат сообщения. Заголовок: <op>: <краткая суть>, ориентир ~50 символов, потолок 72. Префиксы (op): compile, audit, vault-health, create, fix. Тело — свободная краткая сводка того, что изменилось (заметки, MOC, источник). Не повторять чеклист из ответа в чате дословно — достаточно сути для будущего git log. Пример:

compile: Measuring an engineering organization → 3+5 заметок

Источник: inbox/Measuring an engineering organization.md
Наполнены 3 стаба, создано 5 новых заметок,
обновлены MOC «Управление и лидерство», «DevEx».

Безопасные символы. Использовать git commit -m '...' (одинарные кавычки). В сообщении запрещён только апостроф '; всё остальное (кавычки, $, `, переносы строк, кириллица, скобки [[…]]) — литерально. Если имя заметки содержит ' — переформулировать в коммите (например, O'Reilly → O Reilly); сам файл при этом не переименовывать.

Поиск истории.

  • git log --oneline — хронология коммитов.
  • git log --grep="<подстрока>" — поиск по сообщениям.
  • git log --since="2 weeks ago" — недавняя активность.
  • git log -p -- "<имя файла>" — история конкретной заметки.
  • git log --diff-filter=A --name-only — когда какая заметка появилась.

Proposals: предложения по улучшению Base/

Файл AI workspace/proposals.md — бэклог улучшений для заметок в Base/.

  • Когда proposals vs создание заметки сразу: проблема с существующей заметкой Base/ (неполнота, устаревший факт, противоречие) → proposals.md. Новая идея/тезис/концепт, для которого нет соответствующей заметки в Base/ → создать сразу в AI workspace/, без записи в proposals.
  • Во время compile и audit: если замечаешь, что заметка в Base/ неполная или устарела — добавляй запись в proposals.md (формат: имя файла, status: pending, список конкретных улучшений, источники)
  • Никогда не редактировать Base/ напрямую
  • По команде пользователя (approved) — создавать черновик в drafts/<имя> — draft.md. После проверки пользователь сам мержит draft в Base/ и удаляет черновик.

Inbox: что делать после обработки

Конвенция inbox (файл сохраняется как источник, не удаляется и не перемещается) — в [[Как я веду заметки]] раздел Inbox. Workspace-правило: факт обработки фиксируется git-коммитом compile: ... и полем ai-compiled-at в frontmatter inbox-файла.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.