added unity files

Assets/RL_DevPlus1/Docs/AI_CONTEXT.md

@@ -0,0 +1,34 @@
+# AI Context
+
+The primary AI-ready file is:
+
+`Assets/RL_DevPlus1/Reports/RL_AI_Project_Context.md`
+
+This file is intended to be pasted into or read by AI/Codex before deeper work on a customer Unity project.
+
+It summarizes:
+
+- project name
+- Unity version
+- scenes
+- likely entry scene
+- GameObjects
+- managers/controllers
+- MonoBehaviour scripts
+- ScriptableObjects
+- lifecycle methods
+- public methods
+- serialized fields
+- UnityEvents
+- scene transitions
+- prefabs
+- missing scripts and references
+- imported Git report status
+- suggested first files to inspect
+- risks and unknowns
+
+The JSON companion file is:
+
+`Assets/RL_DevPlus1/Reports/RL_AI_Project_Context.json`
+
+Use cautious interpretation. The report is designed to accelerate understanding, not replace manual review.

Assets/RL_DevPlus1/Docs/CODEX_INSTRUCTIONS.md

@@ -0,0 +1,30 @@
+# Codex Instructions For Unity Analyzer
+
+## Purpose
+
+This Unity package gives Runlevel Systems DevPlus1 a safe Editor-only analyzer for customer Unity projects.
+
+## Rules
+
+- Read generated reports before changing customer Unity code.
+- Treat findings as best-effort and confirm manually.
+- Do not modify customer scenes, prefabs, scripts, assets, or project settings unless explicitly asked.
+- Do not generate C# files into `Assets/RL_DevPlus1/Reports/`.
+- Keep analyzer Editor scripts under `Assets/RL_DevPlus1/Editor/`.
+- Keep docs under `Assets/RL_DevPlus1/Docs/`.
+- Keep report outputs under `Assets/RL_DevPlus1/Reports/`.
+
+## Recommended AI Reading Order
+
+1. `Assets/RL_DevPlus1/Reports/RL_AI_Project_Context.md`
+2. `Assets/RL_DevPlus1/Reports/RL_Unity_Report_Index.md`
+3. `Assets/RL_DevPlus1/Reports/RL_Unity_Project_Summary.md`
+4. `reports/api-reference.md`
+5. `reports/call-map.md`
+6. `Assets/RL_DevPlus1/Reports/RL_Unity_Scene_Map.md`
+7. `Assets/RL_DevPlus1/Reports/RL_Unity_Script_Map.md`
+8. `Assets/RL_DevPlus1/Reports/RL_Unity_Event_Map.md`
+
+## Maintenance
+
+Update this file when analyzer behavior, report locations, or recommended reading order changes.

Assets/RL_DevPlus1/Docs/README.md

@@ -0,0 +1,26 @@
+# Runlevel DevPlus1 Unity Analyzer
+
+This folder contains the Unity-side Runlevel Systems DevPlus1 project analyzer.
+
+The analyzer is an Editor-only tool. It reads Unity project structure, scenes, prefabs, scripts, UnityEvents, and existing Git-generated reports, then writes safe markdown and JSON reports under:
+
+`Assets/RL_DevPlus1/Reports/`
+
+It does not modify customer scenes, prefabs, scripts, project settings, or assets.
+
+## Menu Location
+
+Unity menu:
+
+`Runlevel Systems/DevPlus1/Analyze Unity Project`
+
+## Main Reports
+
+- `RL_AI_Project_Context.md`
+- `RL_Unity_Report_Index.md`
+- `RL_Unity_Project_Summary.md`
+- `RL_Unity_Scene_Map.md`
+- `RL_Unity_Script_Map.md`
+- `RL_Unity_Event_Map.md`
+
+Future Codex sessions should read `RL_AI_Project_Context.md` first after reports are generated.

Assets/RL_DevPlus1/Docs/REPORTS.md

@@ -0,0 +1,28 @@
+# Unity Analyzer Reports
+
+Reports are written under:
+
+`Assets/RL_DevPlus1/Reports/`
+
+## Human-Readable Reports
+
+- `RL_Unity_Project_Summary.md`: high-level counts and project status.
+- `RL_Unity_Scene_Map.md`: scene paths, root objects, counts, and missing reference totals.
+- `RL_Unity_GameObject_Map.md`: GameObject hierarchy, tags, layers, and components.
+- `RL_Unity_Script_Map.md`: script classes, lifecycle methods, fields, methods, and Unity API usage.
+- `RL_Unity_Event_Map.md`: UnityEvent and Button callback bindings where detectable.
+- `RL_Unity_Prefab_Map.md`: prefab components, scripts, nested prefabs, and references.
+- `RL_Unity_Execution_Order.md`: custom script execution order and probable lifecycle order.
+- `RL_Unity_Missing_References.md`: missing scripts and missing serialized references.
+- `RL_Unity_Git_Report_Summary.md`: summary of repository-root Git reports if present.
+- `RL_Unity_Report_Index.md`: index of generated reports.
+
+## AI-Ready Reports
+
+- `RL_AI_Project_Context.md`: primary Codex/AI context report.
+- `RL_AI_Project_Context.json`: machine-readable AI context.
+- `RL_Unity_Project_Data.json`: full machine-readable project analysis data.
+
+## Limitations
+
+Reports are best-effort. Runtime-created objects, reflection, dependency injection, generated content, addressable content, and custom serialization may require manual confirmation.

Assets/RL_DevPlus1/Docs/UNITY_ANALYZER.md

@@ -0,0 +1,47 @@
+# Unity Analyzer
+
+## What It Does
+
+The Runlevel DevPlus1 Unity Analyzer creates project-understanding reports for customer Unity projects.
+
+It can inspect:
+
+- open scenes
+- build settings scenes
+- all asset scenes
+- prefabs
+- C# scripts
+- Unity lifecycle methods
+- UnityEvents and Button callbacks where serialized data is visible
+- missing scripts
+- missing serialized object references where detectable
+- root Git-generated reports under `reports/`
+
+## Menu Items
+
+- `Runlevel Systems/DevPlus1/Analyze Unity Project`
+- `Runlevel Systems/DevPlus1/Open Report Folder`
+- `Runlevel Systems/DevPlus1/Refresh Git Reports`
+
+## Safety
+
+The analyzer is read-only against customer source files and Unity assets.
+
+It does not:
+
+- save scenes
+- modify prefabs
+- edit scripts
+- write generated C# files
+- modify project settings
+- create asmdef files
+
+If open scenes have unsaved changes, broad scene-scan operations skip scene switching rather than saving or discarding changes.
+
+## How To Run
+
+1. Open the Unity project.
+2. Wait for Unity to compile Editor scripts.
+3. Open `Runlevel Systems/DevPlus1/Analyze Unity Project`.
+4. Click `Generate All Reports`.
+5. Open `Assets/RL_DevPlus1/Reports/`.