# 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.