From 266b9b3f0441fc95e3962e0c6f8748ca66a0adf4 Mon Sep 17 00:00:00 2001
From: kayjaydee <killian.dalcin@gmail.com>
Date: Wed, 22 Apr 2026 23:12:11 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20initialize=20GSD=20project=20(Hytale=20?=
 =?UTF-8?q?Gravity=20Flip)=20=E2=80=94=20PROJECT,=20research,=20REQUIREMEN?=
 =?UTF-8?q?TS,=20ROADMAP,=20STATE,=20config,=20CLAUDE.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .claude/settings.local.json |  8 ++++++
 .gitignore                  |  0
 CLAUDE.md                   | 55 +++++++++++++++++++++++++++++++++++++
 3 files changed, 63 insertions(+)
 create mode 100644 .claude/settings.local.json
 create mode 100644 .gitignore
 create mode 100644 CLAUDE.md

diff --git a/.claude/settings.local.json b/.claude/settings.local.json
new file mode 100644
index 0000000..4960324
--- /dev/null
+++ b/.claude/settings.local.json
@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "WebFetch(domain:britakee-studios.gitbook.io)"
+    ]
+  }
+}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e69de29
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..0aad817
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,55 @@
+<!-- GSD:project-start source:PROJECT.md -->
+## Project
+
+**Hytale Gravity Flip**
+
+Plugin serveur Hytale (Java 25) qui introduit des **zones de gravité inversée**. Toute entité (joueur, item, mob) entrant dans une zone définie voit sa gravité inversée : marche au plafond, les items tombent vers le haut.
+
+**Core Value:** **Créer des mécaniques de niveau "gravity-flip" en jeu sans toucher au code** : un builder définit une zone via un wand, nomme la région, et la mécanique s'active immédiatement pour toutes les entités qui y entrent.
+<!-- GSD:project-end -->
+
+<!-- GSD:stack-start source:STACK.md -->
+## Technology Stack
+
+Technology stack not yet documented. Will populate after codebase mapping or first phase.
+<!-- GSD:stack-end -->
+
+<!-- GSD:conventions-start source:CONVENTIONS.md -->
+## Conventions
+
+Conventions not yet established. Will populate as patterns emerge during development.
+<!-- GSD:conventions-end -->
+
+<!-- GSD:architecture-start source:ARCHITECTURE.md -->
+## Architecture
+
+Architecture not yet mapped. Follow existing patterns found in the codebase.
+<!-- GSD:architecture-end -->
+
+<!-- GSD:skills-start source:skills/ -->
+## Project Skills
+
+No project skills found. Add skills to any of: `.claude/skills/`, `.agents/skills/`, `.cursor/skills/`, `.github/skills/`, or `.codex/skills/` with a `SKILL.md` index file.
+<!-- GSD:skills-end -->
+
+<!-- GSD:workflow-start source:GSD defaults -->
+## GSD Workflow Enforcement
+
+Before using Edit, Write, or other file-changing tools, start work through a GSD command so planning artifacts and execution context stay in sync.
+
+Use these entry points:
+- `/gsd-quick` for small fixes, doc updates, and ad-hoc tasks
+- `/gsd-debug` for investigation and bug fixing
+- `/gsd-execute-phase` for planned phase work
+
+Do not make direct repo edits outside a GSD workflow unless the user explicitly asks to bypass it.
+<!-- GSD:workflow-end -->
+
+
+
+<!-- GSD:profile-start -->
+## Developer Profile
+
+> Profile not yet configured. Run `/gsd-profile-user` to generate your developer profile.
+> This section is managed by `generate-claude-profile` -- do not edit manually.
+<!-- GSD:profile-end -->