Getting Started Tutorial
========================

This tutorial walks you through using Claude Code to explore and understand FUSION.

Step 1: Understand the Project Structure
----------------------------------------

Start by getting an overview of how FUSION is organized:

::

   > What are the main modules in FUSION and what does each one do?

Claude will explain the directory structure and the purpose of each major component.

Step 2: Learn a Core Concept
----------------------------

FUSION deals with optical networking concepts that may be unfamiliar. Ask Claude to explain:

::

   > Explain what RSA (Routing and Spectrum Assignment) means and how FUSION implements it.

::

   > What is spectrum fragmentation and why does it matter?

Step 3: Find Specific Code
--------------------------

When you need to locate specific functionality:

::

   > Where is the main simulation loop? Show me the key functions.

::

   > Which file handles network topology loading?

Step 4: Understand How to Run a Simulation
------------------------------------------

Learn the practical aspects of using the simulator:

::

   > How do I run a basic simulation with FUSION? Walk me through the steps.

::

   > What configuration options are available and where do I set them?

Step 5: Make a Change
---------------------

When you're ready to contribute or modify the code:

::

   > I want to add a new routing algorithm. What files do I need to modify and what interfaces should I implement?

::

   > Show me an example of an existing routing algorithm so I can follow the same pattern.

Step 6: Debug an Issue
----------------------

If you encounter problems:

::

   > The simulation is giving high blocking probability. What should I check?

::

   > I'm getting an error in the spectrum assignment module. Help me understand this traceback.

Next Steps
----------

Once you're comfortable with these basics, explore more advanced topics:

- Ask about the reinforcement learning integration
- Learn about the failure injection and survivability features
- Understand the metrics and reporting system