# skytthe/codyssi architecture

> Architecture diagram of the GitHub repository skytthe/codyssi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skytthe/codyssi
- Repository: https://github.com/skytthe/codyssi

## Overview

##### Project type and purpose
- This is a purely code-exercise repository (“codyssi”) containing Python solutions organized by year (2024, 2025) and by challenge round.
- There is no running service or API—each file is a standalone script solving a puzzle.

##### File structure
- Top level:
- .gitignore
- README.md
- Directories “2024/” and “2025/”
- Under each year directory: “round1”, “round2”, … each containing a single Python file named after the puzzle.
- There are no config files, no build scripts, no dependency manifests—this is a flat collection of scripts.

##### README
- It simply states: “My Codyssi solutions.” No extra information on architecture, dependencies, or runtime.

##### Key advice
- Be detailed in capturing every year and round as separate nodes.
- Keep it simple—this is not a multi-tier service but a collection of standalone scripts.

## Diagram (Mermaid)

```mermaid
graph TB
  Repo["Repository Root"]:::root

  Repo --> Y2024
  Repo --> Y2025

  subgraph "Year 2024"
    direction TB
    Y2024["2024"]:::year

    Y2024 --> R2024_1
    Y2024 --> R2024_2
    Y2024 --> R2024_3
    Y2024 --> R2024_4

    R2024_1["round1"]:::round
    R2024_1 --> S2024_1["handling_the_budget.py"]:::script

    R2024_2["round2"]:::round
    R2024_2 --> S2024_2["sensors_and_circuits.py"]:::script

    R2024_3["round3"]:::round
    R2024_3 --> S2024_3["unformatted_readings.py"]:::script

    R2024_4["round4"]:::round
    R2024_4 --> S2024_4["traversing_the_country.py"]:::script
  end

  subgraph "Year 2025"
    direction TB
    Y2025["2025"]:::year

    Y2025 --> R2025_1
    Y2025 --> R2025_2
    Y2025 --> R2025_3
    Y2025 --> R2025_4
    Y2025 --> R2025_5
    Y2025 --> R2025_6
    Y2025 --> R2025_7
    Y2025 --> R2025_8
    Y2025 --> R2025_9
    Y2025 --> R2025_10
    Y2025 --> R2025_11
    Y2025 --> R2025_12
    Y2025 --> R2025_13
    Y2025 --> R2025_14
    Y2025 --> R2025_15
    Y2025 --> R2025_16
    Y2025 --> R2025_17

    R2025_1["round1"]:::round
    R2025_1 --> S2025_1["compass_calibration.py"]:::script

    R2025_2["round2"]:::round
    R2025_2 --> S2025_2["absurd_arithmetic.py"]:::script

    R2025_3["round3"]:::round
    R2025_3 --> S2025_3["supplies_in_surplus.py"]:::script

    R2025_4["round4"]:::round
    R2025_4 --> S2025_4["aeolian_transmissions.py"]:::script

    R2025_5["round5"]:::round
    R2025_5 --> S2025_5["patron_islands.py"]:::script

    R2025_6["round6"]:::round
    R2025_6 --> S2025_6["lotus_scramble.py"]:::script

    R2025_7["round7"]:::round
    R2025_7 --> S2025_7["siren_disruption.py"]:::script

    R2025_8["round8"]:::round
    R2025_8 --> S2025_8["risky_shortcut.py"]:::script

    R2025_9["round9"]:::round
    R2025_9 --> S2025_9["windy_bargain.py"]:::script

    R2025_10["round10"]:::round
    R2025_10 --> S2025_10["cyclops_chaos.py"]:::script

    R2025_11["round11"]:::round
    R2025_11 --> S2025_11["games_in_a_storm.py"]:::script

    R2025_12["round12"]:::round
    R2025_12 --> S2025_12["challenging_the_whirlpool.py"]:::script

    R2025_13["round13"]:::round
    R2025_13 --> S2025_13["laestrygonian_guards.py"]:::script

    R2025_14["round14"]:::round
    R2025_14 --> S2025_14["crucial_crafting.py"]:::script

    R2025_15["round15"]:::round
    R2025_15 --> S2025_15["artifacts_at_atlantis.py"]:::script

    R2025_16["round16"]:::round
    R2025_16 --> S2025_16["leviathan_mindscape.py"]:::script

    R2025_17["round17"]:::round
    R2025_17 --> S2025_17["spiralling_stairs.py"]:::script
  end

  click Repo "https://github.com/skytthe/codyssi/blob/master/."
  click Y2024 "https://github.com/skytthe/codyssi/tree/master/2024/"
  click Y2025 "https://github.com/skytthe/codyssi/tree/master/2025/"
  click R2024_1 "https://github.com/skytthe/codyssi/tree/master/2024/round1/"
  click S2024_1 "https://github.com/skytthe/codyssi/blob/master/2024/round1/handling_the_budget.py"
  click R2024_2 "https://github.com/skytthe/codyssi/tree/master/2024/round2/"
  click S2024_2 "https://github.com/skytthe/codyssi/blob/master/2024/round2/sensors_and_circuits.py"
  click R2024_3 "https://github.com/skytthe/codyssi/tree/master/2024/round3/"
  click S2024_3 "https://github.com/skytthe/codyssi/blob/master/2024/round3/unformatted_readings.py"
  click R2024_4 "https://github.com/skytthe/codyssi/tree/master/2024/round4/"
  click S2024_4 "https://github.com/skytthe/codyssi/blob/master/2024/round4/traversing_the_country.py"
  click R2025_1 "https://github.com/skytthe/codyssi/tree/master/2025/round1/"
  click S2025_1 "https://github.com/skytthe/codyssi/blob/master/2025/round1/compass_calibration.py"
  click R2025_2 "https://github.com/skytthe/codyssi/tree/master/2025/round2/"
  click S2025_2 "https://github.com/skytthe/codyssi/blob/master/2025/round2/absurd_arithmetic.py"
  click R2025_3 "https://github.com/skytthe/codyssi/tree/master/2025/round3/"
  click S2025_3 "https://github.com/skytthe/codyssi/blob/master/2025/round3/supplies_in_surplus.py"
  click R2025_4 "https://github.com/skytthe/codyssi/tree/master/2025/round4/"
  click S2025_4 "https://github.com/skytthe/codyssi/blob/master/2025/round4/aeolian_transmissions.py"
  click R2025_5 "https://github.com/skytthe/codyssi/tree/master/2025/round5/"
  click S2025_5 "https://github.com/skytthe/codyssi/blob/master/2025/round5/patron_islands.py"
  click R2025_6 "https://github.com/skytthe/codyssi/tree/master/2025/round6/"
  click S2025_6 "https://github.com/skytthe/codyssi/blob/master/2025/round6/lotus_scramble.py"
  click R2025_7 "https://github.com/skytthe/codyssi/tree/master/2025/round7/"
  click S2025_7 "https://github.com/skytthe/codyssi/blob/master/2025/round7/siren_disruption.py"
  click R2025_8 "https://github.com/skytthe/codyssi/tree/master/2025/round8/"
  click S2025_8 "https://github.com/skytthe/codyssi/blob/master/2025/round8/risky_shortcut.py"
  click R2025_9 "https://github.com/skytthe/codyssi/tree/master/2025/round9/"
  click S2025_9 "https://github.com/skytthe/codyssi/blob/master/2025/round9/windy_bargain.py"
  click R2025_10 "https://github.com/skytthe/codyssi/tree/master/2025/round10/"
  click S2025_10 "https://github.com/skytthe/codyssi/blob/master/2025/round10/cyclops_chaos.py"
  click R2025_11 "https://github.com/skytthe/codyssi/tree/master/2025/round11/"
  click S2025_11 "https://github.com/skytthe/codyssi/blob/master/2025/round11/games_in_a_storm.py"
  click R2025_12 "https://github.com/skytthe/codyssi/tree/master/2025/round12/"
  click S2025_12 "https://github.com/skytthe/codyssi/blob/master/2025/round12/challenging_the_whirlpool.py"
  click R2025_13 "https://github.com/skytthe/codyssi/tree/master/2025/round13/"
  click S2025_13 "https://github.com/skytthe/codyssi/blob/master/2025/round13/laestrygonian_guards.py"
  click R2025_14 "https://github.com/skytthe/codyssi/tree/master/2025/round14/"
  click S2025_14 "https://github.com/skytthe/codyssi/blob/master/2025/round14/crucial_crafting.py"
  click R2025_15 "https://github.com/skytthe/codyssi/tree/master/2025/round15/"
  click S2025_15 "https://github.com/skytthe/codyssi/blob/master/2025/round15/artifacts_at_atlantis.py"
  click R2025_16 "https://github.com/skytthe/codyssi/tree/master/2025/round16/"
  click S2025_16 "https://github.com/skytthe/codyssi/blob/master/2025/round16/leviathan_mindscape.py"
  click R2025_17 "https://github.com/skytthe/codyssi/tree/master/2025/round17/"
  click S2025_17 "https://github.com/skytthe/codyssi/blob/master/2025/round17/spiralling_stairs.py"

  classDef root fill:#cccccc,stroke:#333,stroke-width:1px;
  classDef year fill:#add8e6,stroke:#333,stroke-width:1px;
  classDef round fill:#90ee90,stroke:#333,stroke-width:1px;
  classDef script fill:#ffa500,stroke:#333,stroke-width:1px;
```
