docs: start-here guide for non-technical users + auto-release

.github/workflows/auto-release.yml

@@ -0,0 +1,40 @@
+name: auto-release
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Bump version
+        id: ver
+        run: |
+          latest=$(git tag --list 'v*' --sort=-v:refname | head -1 || true)
+          if [ -z "$latest" ]; then
+            echo "version=v0.1.0"
+          else
+            base=$(echo "$latest" | sed -E 's/^(v[0-9]+\.[0-9]+\.)[0-9]+$/\1/')
+            patch=$(echo "$latest" | sed -E 's/^v[0-9]+\.[0-9]+\.([0-9]+)$/\1/')
+            echo "version=${base}$((patch + 1))"
+          fi
+
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "v${{ steps.ver.outputs.version }}" \
+            --title "Axiara v${{ steps.ver.outputs.version }}" \
+            --notes "Automated release from main (${{ github.sha }})
+
+GitHub automatically attaches source archives (zip / tar.gz) to this release."

AGENTS.md

@@ -16,6 +16,7 @@ You are operating in **Axiara**, a multi-agent valuation workspace: a costing en
 | Do | Don't |
 | --- | --- |
 | Read `data/main/` as the authoritative baseline | Never write or overwrite `data/main/` — human-only |
+| Ensure `.data/` is initialized (ask the user per `docs/init.md`, then run `scripts/init-data.sh` with their answers) before any business operation | Never start quoting / querying before initialization is complete |
 | Detect official-baseline changes (checksum manifest + git status); recover from git/snapshots; audit in `ledger/` | Never silently continue after an unexpected baseline change — report the diff and confirm with the user |
 | Write to `data/learn/` / `data/market/` per the permission model | Never hand-edit `store/` — it is git-managed |
 | Wipe `cache/` freely | Never delete `local_config/` or commit its contents |

PLAN.md

@@ -44,6 +44,7 @@ Single source of truth for Axiara initialization. Update as decisions are made;
 - [x] `AGENTS.md` — lean agent operating manual (2026-08-05)
 - [x] `docs/init.md` — agent-driven onboarding guide + data guide + data integrity (2026-08-05)
 - [x] Agent-driven init & anti-tampering design (D21) — `init-data.sh` CLI flags, docs integrity section, AGENTS.md rules (2026-08-05)
+- [x] Branch protection (2026-08-05) — `dev`: PR-only (enforce_admins, no force push/delete); `main`: PR-only + 1 review + required checks (`continuous-integration`, `pr-source-guard`) — **main PRs only from `dev` or `hotfix/*`** via `.github/workflows/pr-source-guard.yml`
 - [ ] Initial commit (awaiting confirmation)
 
 ## Roadmap

README.de-DE.md

@@ -68,9 +68,44 @@ Axiara ist ein **Agenten-Arbeitsbereich für Bewertungen**. Es gibt KI-Agenten v
 | Agenten-Framework | LangGraph |
 | Scheduler | APScheduler (reserviert) |
 | Abhängigkeitsverwaltung | [uv](https://docs.astral.sh/uv/) |
-| Speicherung | SQLite / PostgreSQL / MongoDB (plugable) + CSV |
+| Speicherung | Persönlich: SQLite · Team: CSV + git-Sync (SQLite-Cache) oder SQL-Server |
 
-## 🚀 Schnellstart
+## 🚀 Hier starten — keine technischen Kenntnisse nötig
+
+Sie müssen keinen Code lesen, kein Terminal benutzen und nichts Technisches verstehen. Wählen Sie die Methode, die Ihnen leichter fällt.
+
+> 💡 Tipp: Erstellen Sie zuerst einen Ordner namens **axiara-workspace** (auf dem Desktop oder in Dokumenten) und
+> legen Sie alle Axiara-bezogenen Dateien in diesem Ordner ab, damit nichts verloren geht.
+
+### Methode 1 — Den Link an Ihre AI Agents geben (am einfachsten)
+> 💡 Voraussetzung: Für diese Methode muss **Git** installiert sein (kostenlos — [hier herunterladen](https://git-scm.com/downloads)). Wenn Sie Git nicht installieren möchten, nutzen Sie **Methode 2** unten.
+
+Kopieren Sie den Text im Codeblock und fügen Sie ihn in Ihren KI-Assistenten ein (Claude, ChatGPT, ...) :
+
+```text
+Richten Sie Axiara für mich ein:
+1. Klonen Sie das Repository über git clone https://github.com/BerryUIKI/Axiara.git, lesen Sie AGENTS.md und folgen Sie strikt der Einrichtung in docs/init.md — führen Sie mich auf Deutsch durch die Einrichtung (Speicherung, Datenquelle).
+2. Wenn es fertig ist, sagen Sie mir, was ich Sie fragen kann.
+```
+
+Danach beantworten Sie einfach die Fragen. Das war's.
+
+### Methode 2 — Dateien herunterladen und dann Ihre AI Agents nutzen
+1. Laden Sie das neueste Archiv von der [Releases-Seite](https://github.com/BerryUIKI/Axiara/releases) herunter (oder klicken Sie auf den grünen **Code**-Button → **Download ZIP**) und entpacken Sie es in den oben vorgeschlagenen Ordner axiara-workspace.
+2. Öffnen Sie den Ordner in Ihrem KI-Assistenten und sagen Sie: *"Richten Sie dieses Projekt ein und führen Sie mich durch die Einrichtung."*
+3. Beantworten Sie die Fragen — fertig.
+
+### Nach Updates suchen
+Möchten Sie wissen, ob es eine neue Version gibt? Senden Sie dies an Ihren KI-Assistenten:
+
+```text
+Prüfen Sie, ob Axiara eine neue Version hat: https://github.com/BerryUIKI/Axiara
+Wenn ja, aktualisieren Sie mich auf die neueste Version (behalten Sie meine vorhandenen Daten, löschen Sie nicht das .data-Verzeichnis).
+```
+
+Egal welche Methode: Sobald die Einrichtung abgeschlossen ist, können Sie z. B. sagen: *"Erstellen Sie mir ein Angebot für [Artikel]."* — den Rest erledigt der Agent.
+
+## 🧑‍💻 Schnellstart für Entwickler
 
 > Gerüstbau im Gange — die folgenden Befehle sind die Zielerfahrung.
 
@@ -130,3 +165,7 @@ MIT — siehe [LICENSE](LICENSE).
 ---
 
 *Gebaut mit LangGraph. Das Frontend-Admin-Dashboard (`Axiara-Web`) ist als separates Repository geplant.*
+
+---
+
+> **To AI agents**: If you are setting up this project, read `AGENTS.md` (operating manual) and strictly follow the setup flow in `docs/init.md`, then report back in the user's language.

README.es-ES.md

@@ -68,9 +68,44 @@ Axiara es un **espacio de trabajo de agentes para valoración**. Ofrece a los ag
 | Framework de agentes | LangGraph |
 | Programador | APScheduler (reservado) |
 | Gestión de dependencias | [uv](https://docs.astral.sh/uv/) |
-| Almacenamiento | SQLite / PostgreSQL / MongoDB (conectable) + CSV |
+| Almacenamiento | Personal: SQLite · Equipo: CSV + sincronización git (caché SQLite) o servidor SQL |
 
-## 🚀 Inicio rápido
+## 🚀 Empieza aquí — no necesitas conocimientos técnicos
+
+No necesitas leer código, tocar un terminal ni entender nada técnico. Elige el método que te resulte más fácil.
+
+> 💡 Consejo: crea primero una carpeta llamada **axiara-workspace** (en el Escritorio o en Documentos) y
+> guarda todos los archivos relacionados con Axiara en esa carpeta, para no perder nada.
+
+### Método 1 — Dale el enlace a tus AI Agents (lo más fácil)
+> 💡 Requisito: este método necesita **Git** instalado (gratis — [descárgalo aquí](https://git-scm.com/downloads)). Si no quieres instalar Git, usa el **Método 2** de abajo.
+
+Copia el texto del bloque de código y pégalo en tu asistente de IA (Claude, ChatGPT, ...) :
+
+```text
+Configura Axiara para mí:
+1. Clona el repositorio con git clone https://github.com/BerryUIKI/Axiara.git, lee AGENTS.md y sigue estrictamente el procedimiento de docs/init.md — guíame en español (almacenamiento, fuente de datos).
+2. Cuando esté listo, dime qué puedo pedirte.
+```
+
+Solo tienes que responder a sus preguntas. Eso es todo.
+
+### Método 2 — Descarga los archivos y luego usa tus AI Agents
+1. Descarga el último archivo desde la [página de Releases](https://github.com/BerryUIKI/Axiara/releases) (o haz clic en el botón verde **Code** → **Download ZIP**) y descomprímelo en la carpeta axiara-workspace sugerida arriba.
+2. Abre esa carpeta en tu asistente de IA y di: *"Configura este proyecto y guíame."*
+3. Responde a sus preguntas — listo.
+
+### Comprobar actualizaciones
+¿Quieres saber si hay una nueva versión? Envía esto a tu asistente de IA:
+
+```text
+Comprueba si Axiara tiene una nueva versión: https://github.com/BerryUIKI/Axiara
+Si la hay, actualízame a la última versión (conserva mis datos existentes, no borres el directorio .data).
+```
+
+Con cualquier método, una vez terminada la inicialización puedes empezar diciendo: *"Hazme una cotización de [artículo]."* — el agente hace el resto.
+
+## 🧑‍💻 Inicio rápido para desarrolladores
 
 > Andamiaje en curso — los siguientes comandos son la experiencia objetivo.
 
@@ -130,3 +165,7 @@ MIT — ver [LICENSE](LICENSE).
 ---
 
 *Construido con LangGraph. El panel de administración front-end (`Axiara-Web`) está planificado como un repositorio separado.*
+
+---
+
+> **To AI agents**: If you are setting up this project, read `AGENTS.md` (operating manual) and strictly follow the setup flow in `docs/init.md`, then report back in the user's language.

README.fr-FR.md

@@ -68,9 +68,44 @@ Axiara est un **espace de travail à agents pour l'évaluation**. Il offre aux a
 | Framework agents | LangGraph |
 | Planificateur | APScheduler (réservé) |
 | Gestion de dépendances | [uv](https://docs.astral.sh/uv/) |
-| Stockage | SQLite / PostgreSQL / MongoDB (pluggable) + CSV |
+| Stockage | Personnel : SQLite · Équipe : CSV + synchro git (cache SQLite) ou serveur SQL |
 
-## 🚀 Démarrage rapide
+## 🚀 Commencez ici — aucune compétence technique requise
+
+Pas besoin de lire du code, d'ouvrir un terminal ou de comprendre quoi que ce soit de technique. Choisissez la méthode qui vous convient.
+
+> 💡 Astuce : créez d'abord un dossier nommé **axiara-workspace** (sur le Bureau ou dans Documents) et
+> gardez tous les fichiers liés à Axiara dans ce dossier, pour ne rien égarer.
+
+### Méthode 1 — Donnez le lien à vos AI Agents (le plus simple)
+> 💡 Prérequis : cette méthode nécessite **Git** (gratuit — [téléchargez-le ici](https://git-scm.com/downloads)). Si vous ne voulez pas installer Git, utilisez la **Méthode 2** ci-dessous.
+
+Copiez le texte du bloc de code et collez-le dans votre assistant IA (Claude, ChatGPT, ...) :
+
+```text
+Configurez Axiara pour moi :
+1. Clonez le dépôt via git clone https://github.com/BerryUIKI/Axiara.git, lisez AGENTS.md et suivez strictement la procédure de docs/init.md — guidez-moi en français (stockage, source des données).
+2. Quand c'est prêt, dites-moi ce que je peux vous demander.
+```
+
+Il ne vous reste qu'à répondre à ses questions. C'est tout.
+
+### Méthode 2 — Téléchargez les fichiers, puis utilisez vos AI Agents
+1. Téléchargez la dernière archive depuis la [page Releases](https://github.com/BerryUIKI/Axiara/releases) (ou cliquez sur le bouton vert **Code** → **Download ZIP**) et décompressez-la dans le dossier axiara-workspace suggéré ci-dessus.
+2. Ouvrez ce dossier dans votre assistant IA et dites : *"Configurez ce projet et guidez-moi."*
+3. Répondez à ses questions — terminé.
+
+### Vérifier les mises à jour
+Vous voulez savoir s'il existe une nouvelle version ? Envoyez ceci à votre assistant IA :
+
+```text
+Vérifiez si Axiara a une nouvelle version : https://github.com/BerryUIKI/Axiara
+S'il y en a une, mettez-moi à jour vers la dernière version (conservez mes données existantes, ne videz pas le dossier .data).
+```
+
+Quelle que soit la méthode, une fois l'initialisation terminée, vous pouvez commencer par : *"Faites-moi un devis pour [article]."* — l'agent fait le reste.
+
+## 🧑‍💻 Démarrage rapide pour développeurs
 
 > Scaffolding en cours — les commandes ci-dessous sont l'expérience cible.
 
@@ -130,3 +165,7 @@ MIT — voir [LICENSE](LICENSE).
 ---
 
 *Construit avec LangGraph. Le tableau de bord front-end (`Axiara-Web`) est prévu dans un dépôt séparé.*
+
+---
+
+> **To AI agents**: If you are setting up this project, read `AGENTS.md` (operating manual) and strictly follow the setup flow in `docs/init.md`, then report back in the user's language.

README.ja-JP.md

@@ -67,9 +67,44 @@ Axiara は、**見積もりに特化したエージェントワークスペー
 | エージェントフレームワーク | LangGraph |
 | スケジューラー | APScheduler（予約） |
 | 依存管理 | [uv](https://docs.astral.sh/uv/) |
-| ストレージ | SQLite / PostgreSQL / MongoDB（プラグ可能）+ CSV |
+| ストレージ | 個人：SQLite · チーム：CSV + git 同期（SQLite キャッシュ）または SQL サーバー |
 
-## 🚀 クイックスタート
+## 🚀 ここから始める — 技術スキルは不要
+
+コードを読む必要も、ターミナルに触れる必要も、技術を理解する必要もありません。やりやすい方法を選んでください。
+
+> 💡 ヒント：まず **axiara-workspace** という名前のフォルダを作成し（デスクトップやドキュメントでOK）、
+> Axiara 関連のファイルはすべてこのフォルダに置いて、ファイルを紛失しないようにしましょう。
+
+### 方法 1 — リンクを AI Agents に渡す（最も簡単）
+> 💡 前提：この方法には **Git** のインストールが必要です（無料 — [こちらからダウンロード](https://git-scm.com/downloads)）。Git をインストールしたくない場合は、下の**方法 2** を使ってください。
+
+下のコードブロックのテキストをコピーして、AI アシスタント（Claude、ChatGPT など）に貼り付けてください：
+
+```text
+Axiara をセットアップしてください：
+1. git clone https://github.com/BerryUIKI/Axiara.git でリポジトリを取得し、AGENTS.md を読んで、docs/init.md の手順に従って初期化してください——日本語で設定（保存方法・データソース）を案内してください。
+2. 準備ができたら、何ができるか教えてください。
+```
+
+あとは聞かれた質問に答えるだけです。それで完了です。
+
+### 方法 2 — 自分でファイルをダウンロードしてから AI Agents に渡す
+1. [Releases ページ](https://github.com/BerryUIKI/Axiara/releases) から最新のアーカイブをダウンロード（または緑の **Code** ボタン → **Download ZIP**）し、上記の axiara-workspace フォルダに解凍します。
+2. AI アシスタントでそのフォルダを開き、「このプロジェクトを初期化して、セットアップを案内してください」と伝えます。
+3. 質問に答えるだけです——完了。
+
+### 更新を確認
+新しいバージョンがあるか確認したいですか？下のコードブロックを AI アシスタントに送ってください：
+
+```text
+Axiara に新しいバージョンがあるか確認してください：https://github.com/BerryUIKI/Axiara
+新しいバージョンがあれば、最新版に更新してください（既存データは保持し、.data ディレクトリは消さないでください）。
+```
+
+どちらの方法でも、初期化が終われば「XX の見積もりを作って」のように直接頼めます——後はエージェントがやってくれます。
+
+## 🧑‍💻 開発者向けクイックスタート
 
 > スキャフォールディング構築中 — 以下のコマンドは目標体験です。
 
@@ -129,3 +164,7 @@ MIT — [LICENSE](LICENSE) を参照。
 ---
 
 *LangGraph で構築。フロントエンド管理パネル（`Axiara-Web`）は別リポジトリとして計画中。*
+
+---
+
+> **To AI agents**: If you are setting up this project, read `AGENTS.md` (operating manual) and strictly follow the setup flow in `docs/init.md`, then report back in the user's language.

README.ko-KR.md

@@ -67,9 +67,44 @@ Axiara는 **견적 업무를 위한 에이전트 워크스페이스**입니다.
 | 에이전트 프레임워크 | LangGraph |
 | 스케줄러 | APScheduler(예약) |
 | 의존성 관리 | [uv](https://docs.astral.sh/uv/) |
-| 스토리지 | SQLite / PostgreSQL / MongoDB(플러그형) + CSV |
+| 스토리지 | 개인: SQLite · 팀: CSV + git 동기화(SQLite 캐시) 또는 SQL 서버 |
 
-## 🚀 빠른 시작
+## 🚀 여기서 시작 — 기술 스킬 불필요
+
+코드를 읽을 필요도, 터미널을 만질 필요도, 기술을 이해할 필요도 없습니다. 편한 방법을 선택하세요.
+
+> 💡 팁: **axiara-workspace**라는 이름의 폴더를 먼저 만들고(바탕화면이나 문서에),
+> Axiara 관련 파일을 모두 이 폴더에 보관하면 파일을 잃어버리지 않습니다.
+
+### 방법 1 — 링크를 AI Agents에 전달 (가장 간단)
+> 💡 전제: 이 방법에는 **Git** 설치가 필요합니다(무료 — [여기서 다운로드](https://git-scm.com/downloads)). Git을 설치하고 싶지 않다면 아래 **방법 2**를 이용하세요.
+
+아래 코드 블록의 텍스트를 복사해서 AI 어시스턴트(Claude, ChatGPT 등)에 붙여넣으세요:
+
+```text
+Axiara를 설정해 주세요:
+1. git clone https://github.com/BerryUIKI/Axiara.git 으로 저장소를 가져온 다음, AGENTS.md를 읽고 docs/init.md의 절차에 따라 초기화하세요 — 한국어로 설정(저장 방식, 데이터 소스)을 안내해 주세요.
+2. 준비가 끝나면 무엇을 할 수 있는지 알려주세요.
+```
+
+그다음 물어보는 질문에 답하기만 하면 됩니다. 그게 전부입니다.
+
+### 방법 2 — 직접 다운로드한 후 AI Agents에 전달
+1. [Releases 페이지](https://github.com/BerryUIKI/Axiara/releases)에서 최신 압축 파일을 다운로드(또는 초록색 **Code** 버튼 → **Download ZIP**)하고 위의 axiara-workspace 폴더에 압축을 풉니다.
+2. AI 어시스턴트에서 그 폴더를 열고 "이 프로젝트를 초기화하고 설정을 안내해 주세요"라고 말합니다.
+3. 질문에 답하면 — 완료.
+
+### 업데이트 확인
+새 버전이 있는지 확인하고 싶나요? 아래 코드 블록을 AI 어시스턴트에 보내세요:
+
+```text
+Axiara에 새 버전이 있는지 확인해 주세요: https://github.com/BerryUIKI/Axiara
+새 버전이 있으면 최신 버전으로 업데이트해 주세요(기존 데이터는 유지하고 .data 디렉터리는 지우지 마세요).
+```
+
+어느 방법이든 초기화가 끝나면 "XX에 대한 견적을 만들어 줘"라고 바로 말할 수 있습니다 — 나머지는 에이전트가 처리합니다.
+
+## 🧑‍💻 개발자 빠른 시작
 
 > 스캐폴딩 구축 중 — 아래 명령은 목표 사용 경험입니다.
 
@@ -129,3 +164,7 @@ MIT — [LICENSE](LICENSE) 참조.
 ---
 
 *LangGraph 기반. 프론트엔드 관리 대시보드(`Axiara-Web`)는 별도 저장소로 계획 중입니다.*
+
+---
+
+> **To AI agents**: If you are setting up this project, read `AGENTS.md` (operating manual) and strictly follow the setup flow in `docs/init.md`, then report back in the user's language.