From ee2adc9fda6ce319422e5fe89143b9a1584d690f Mon Sep 17 00:00:00 2001
From: Sergey Krylov <ksv741@mail.ru>
Date: Sat, 12 Sep 2026 14:54:38 +0300
Subject: [PATCH] initial commit

---
 .gitignore | 43 +++++++++++++++++++++++++++++++++++++++++++
 AGENTS.md  | 22 ++++++++++++++++++++++
 2 files changed, 65 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 AGENTS.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..8ac319c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,43 @@
+# OS
+.DS_Store
+
+# IDE / local environment
+.idea
+.vscode/
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.pid.lock
+*.seed
+
+# Node / frontend / backend artifacts
+node_modules
+dist
+dist-ssr
+build
+coverage
+/.nyc_output
+
+# Local and generated env/runtime files
+.env
+.env.*
+!.env.example
+
+# Generated and temporary
+.tmp
+.temp
+
+# Tooling metadata
+.opencode
+.playwright-mcp
+graphify-out
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..a28fdf1
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# WealthLedger
+
+## Workspace
+
+`frontend`, `backend`, `docs` и `specs` — независимые Git-репозитории.
+Root не является Git-репозиторием; команды Git выполняй из нужного repo.
+`references/**`, dated audits и архивы — read-only источники.
+
+## Работа
+
+1. Начинай с задачи пользователя, ожидаемого результата и affected areas. Работай напрямую: OpenSpec/SDD artifacts, approvals и archive не являются prerequisite. Используй прежний SDD workflow только по явному запросу.
+2. Прочитай local `AGENTS.md` affected repo. Для frontend/backend прочитай его `.ai/CONVENTIONS.md` и `.ai/SOURCES.md`, затем только темы, которые активируют задача, пути или обнаруженная граница.
+3. До выбора реализации проследи поведение и инварианты, найди ближайший существующий owner и 1–3 подходящих примера. Код показывает реализацию; документированный контракт не выводится из случайного аналога.
+4. Выбирай простейшее полное решение у ответственного владельца. Новая abstraction или dependency требует текущей потребности; посторонний рефакторинг оставляй отдельно.
+5. Выбирай тип знания по задаче через [вход docs](docs/README.md): новая функция или межрепозиторное поведение → соответствующая область, спецификации, нужные ADR, затем реализация; ошибка с неясным ожиданием → спецификация, docs, код и тесты; архитектурное изменение → архитектура/ADR, затронутые спецификации и код. Локальная ошибка сборки, линтера или очевидный implementation bug → инструкции и код нужного repo; документация → docs/AGENTS.md и CONTRIBUTING.md. Расширяй контекст по конкретному пробелу; missing required source или конфликт требований сообщи до зависимого решения.
+6. При новой границе и перед завершением повтори routing по actual staged, unstaged и новым файлам. Сохраняй чужие изменения; уточнение контекста не расширяет задачу.
+7. Проверь результат по задаче, рискованным случаям и local gates. Сохрани краткие команды/результаты; сообщи оставшиеся ограничения. Успех lint/tests не заменяет semantic review.
+
+Перед Node-командой активируй `.nvmrc` affected repo через `nvm use --silent`.
+Полные [общие правила](docs/development/engineering-governance.md) читай по их
+triggers; [context discipline](docs/development/agent-token-efficiency.md) — при
+вопросе о routing, recovery или проверке эффективности инструкций.