Adding all files and folders

docs/01_system_recon_guide.md

@@ -0,0 +1,39 @@
+# Phase 1: System Reconnaissance Guide
+
+**Objective:** To execute the reconnaissance script that gathers essential information about the current system. This information will be used in subsequent phases to plan the file and software migration.
+
+**Prerequisite:** Ensure you have completed **Phase 0: Full System Backup**. Do not run this script until you have a complete and verified offline backup of your data.
+
+## Instructions for Operator (Human or AI)
+
+### 1. Understand the Script
+
+- **Script Location:** `scripts/01_system_recon.sh`
+- **Purpose:** This script is designed to be **non-destructive**. It reads information about the system and saves it to a log file. It does not modify any files or settings.
+- **Actions Performed:**
+    - Gathers disk, partition, and filesystem information.
+    - Calculates the total size of major user directories (Documents, Pictures, etc.).
+    - Lists installed software from `apt` and `snap`.
+    - Collects detailed information about the Docker setup (containers, images, volumes).
+    - Checks for versions of common development languages (Rust, Node, etc.).
+    - Looks for evidence of common servers and development workspaces (Eclipse, Arduino).
+- **Output:** All findings are saved to `logs/01_system_recon.log`.
+
+### 2. Execution
+
+1.  Open a terminal on the Ubuntu machine that is being migrated.
+2.  Navigate to the `nixos-migration` project directory.
+3.  Run the script. It may ask for a password as some commands (like inspecting Docker's data directory or listing packages) can require elevated privileges to get a complete picture.
+
+    ```bash
+    sudo ./scripts/01_system_recon.sh
+    ```
+
+### 3. Review the Output
+
+- Upon completion, the script will have created or updated the log file at `logs/01_system_recon.log`.
+- Review this file to ensure the information appears correct and complete. This log is the foundation for all future planning steps.
+
+### 4. Next Steps
+
+Once the reconnaissance is complete and the log file has been generated, you may proceed to **Phase 2: Migration Analysis & Planning**. The data in the log file will be the primary input for this next phase.