# faisalulde/security-writeups architecture

> Architecture diagram of the GitHub repository faisalulde/security-writeups, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/faisalulde/security-writeups
- Repository: https://github.com/faisalulde/security-writeups

## Overview

This repository is a **content-only security portfolio**, not a software application. Its architecture is centered on **Markdown documentation** organized into a small set of topic collections, with the root README acting as the landing page.

1. **Top-level role**
   - The root `README.md` is the primary index and public-facing overview.
   - It introduces the author, summarizes capabilities, and links into the writeup collections below.

2. **Primary content boundaries**
   - The repo is split into two main collections:
     - `boroCTF-2026/` for boroCTF challenge writeups
     - `0xV01D-CTF-2026/` for 0xV01D CTF writeups
   - Each collection is a self-contained set of Markdown case studies.

3. **Writeup unit of architecture**
   - Each challenge file is one independent document describing a single target, exploit path, and lessons learned.
   - Examples:
     - `boroGPT.md`
     - `Kobenis-Dashboard.md`
     - `My-Mayor-Muslim.md`
     - `Silent-Oracle.md`
     - `Action-Packed.md`
     - `The-Altered-Grimoire.md`

4. **Navigation and information hierarchy**
   - The root README provides the highest-level navigation, including challenge tables, categories, difficulty, and techniques.
   - This gives the repo a **catalog → collection → article** structure:
     - portfolio overview
     - CTF event grouping
     - individual exploit writeups

5. **Supporting assets**
   - `boroCTF-2026/screenshots/` is a media support folder for evidence images.
   - These screenshots are not core logic; they support the narrative in the Markdown writeups by showing payloads, responses, or exploitation results.

6. **Meta/index file**
   - `SUMMARY.md` likely serves as a table of contents for a documentation renderer or book-style navigation.
   - Architecturally, it acts as an alternate index layer over the same Markdown content.

7. **Data flow through the repo**
   - The flow is editorial, not runtime:
     - author documents a challenge in Markdown
     - screenshots are referenced as supporting evidence
     - README and summary files link readers into the relevant writeups
   - There is no backend, database, build pipeline, or executable code path.

8. **Content themes and specialization**
   - The writeups are grouped around offensive web security techniques such as SQLi, JWT confusion, SSTI, LFI, access control flaws, and race conditions.
   - This gives the repository a technical taxonomy that mirrors the way an engineer might diagram the author’s skill coverage.

9. **Operational context**
   - The repository represents a personal security portfolio and CTF research archive.
   - The external services referenced in the README, such as LinkedIn and GitHub, are profile links only; they do not affect the repository’s internal structure.

10. **What to diagram**
   - If drawing architecture, depict:
     - a root documentation hub
     - two event-based documentation branches
     - per-challenge Markdown nodes under each branch
     - a screenshots asset store feeding selected writeups
     - a summary/navigation layer that points into the same content
   - Do not model any runtime services, APIs, or data processing components, because none are present.

Overall, this repo is best understood as a **static knowledge repository** with a simple hierarchical document structure and a separate asset folder for supporting evidence.

Main entry points: [`boroCTF-2026`](https://github.com/faisalulde/security-writeups/tree/main/boroCTF-2026) (boroCTF 2026), [`0xV01D-CTF-2026`](https://github.com/faisalulde/security-writeups/tree/main/0xV01D-CTF-2026) (0xV01D 2026), [`boroCTF-2026/screenshots`](https://github.com/faisalulde/security-writeups/tree/main/boroCTF-2026/screenshots) (Screenshots), [`README.md`](https://github.com/faisalulde/security-writeups/blob/main/README.md) (README)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_docs["Documentation Hub"]
  node_readme["README<br/>portfolio index<br/>[README.md]"]
  node_summary["SUMMARY<br/>toc<br/>[SUMMARY.md]"]
end

subgraph group_boro["boroCTF 2026"]
  node_boroctf["boroCTF 2026<br/>writeup collection"]
  node_borogpt["boroGPT<br/>challenge writeup<br/>[boroGPT.md]"]
  node_kobenis["Kobenis Dashboard<br/>challenge writeup"]
  node_mayor["My Mayor Muslim<br/>challenge writeup<br/>[My-Mayor-Muslim.md]"]
end

subgraph group_v01d["0xV01D 2026"]
  node_v01dctf["0xV01D 2026<br/>writeup collection"]
  node_action["Action Packed<br/>challenge writeup<br/>[Action-Packed.md]"]
  node_oracle["Silent Oracle<br/>challenge writeup<br/>[Silent-Oracle.md]"]
  node_grimoire["Altered Grimoire<br/>challenge writeup"]
end

subgraph group_assets["Support Assets"]
  node_screenshots["Screenshots<br/>asset folder"]
end

node_readme -->|"links to"| node_boroctf
node_readme -->|"links to"| node_v01dctf
node_readme -->|"indexes"| node_summary
node_summary -->|"toc for"| node_boroctf
node_summary -->|"toc for"| node_v01dctf
node_boroctf -->|"contains"| node_borogpt
node_boroctf -->|"contains"| node_kobenis
node_boroctf -->|"contains"| node_mayor
node_boroctf -.->|"supports"| node_screenshots
node_screenshots -.->|"evidence for"| node_borogpt
node_screenshots -.->|"evidence for"| node_kobenis
node_screenshots -.->|"evidence for"| node_mayor
node_v01dctf -->|"contains"| node_action
node_v01dctf -->|"contains"| node_oracle
node_v01dctf -->|"contains"| node_grimoire

click node_readme "https://github.com/faisalulde/security-writeups/blob/main/README.md"
click node_summary "https://github.com/faisalulde/security-writeups/blob/main/SUMMARY.md"
click node_boroctf "https://github.com/faisalulde/security-writeups/tree/main/boroCTF-2026"
click node_borogpt "https://github.com/faisalulde/security-writeups/blob/main/boroCTF-2026/boroGPT.md"
click node_kobenis "https://github.com/faisalulde/security-writeups/blob/main/boroCTF-2026/Kobenis-Dashboard.md"
click node_mayor "https://github.com/faisalulde/security-writeups/blob/main/boroCTF-2026/My-Mayor-Muslim.md"
click node_screenshots "https://github.com/faisalulde/security-writeups/tree/main/boroCTF-2026/screenshots"
click node_v01dctf "https://github.com/faisalulde/security-writeups/tree/main/0xV01D-CTF-2026"
click node_action "https://github.com/faisalulde/security-writeups/blob/main/0xV01D-CTF-2026/Action-Packed.md"
click node_oracle "https://github.com/faisalulde/security-writeups/blob/main/0xV01D-CTF-2026/Silent-Oracle.md"
click node_grimoire "https://github.com/faisalulde/security-writeups/blob/main/0xV01D-CTF-2026/The-Altered-Grimoire.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_summary toneBlue
class node_boroctf,node_borogpt,node_kobenis,node_mayor toneAmber
class node_v01dctf,node_action,node_oracle,node_grimoire toneMint
class node_screenshots toneRose
```

## Components

### Documentation Hub

Root index and alternate table-of-contents layer for the portfolio.

- [README](https://github.com/faisalulde/security-writeups/blob/main/README.md): portfolio index · Landing page and primary navigation hub for the repository. · `README.md`
- [SUMMARY](https://github.com/faisalulde/security-writeups/blob/main/SUMMARY.md): toc · Alternate navigation layer for the Markdown collection. · `SUMMARY.md`

### boroCTF 2026

Writeups from the boroCTF 2026 event.

- [boroCTF 2026](https://github.com/faisalulde/security-writeups/tree/main/boroCTF-2026): writeup collection · Collection of challenge writeups for the boroCTF 2026 event. · `boroCTF-2026`
- [boroGPT](https://github.com/faisalulde/security-writeups/blob/main/boroCTF-2026/boroGPT.md): challenge writeup · Single challenge case study and exploit narrative. · `boroCTF-2026/boroGPT.md`
- [Kobenis Dashboard](https://github.com/faisalulde/security-writeups/blob/main/boroCTF-2026/Kobenis-Dashboard.md): challenge writeup · Single challenge case study and exploit narrative. · `boroCTF-2026/Kobenis-Dashboard.md`
- [My Mayor Muslim](https://github.com/faisalulde/security-writeups/blob/main/boroCTF-2026/My-Mayor-Muslim.md): challenge writeup · Single challenge case study and exploit narrative. · `boroCTF-2026/My-Mayor-Muslim.md`

### 0xV01D 2026

Writeups from the 0xV01D CTF 2026 event.

- [0xV01D 2026](https://github.com/faisalulde/security-writeups/tree/main/0xV01D-CTF-2026): writeup collection · Collection of challenge writeups for the 0xV01D CTF 2026 event. · `0xV01D-CTF-2026`
- [Action Packed](https://github.com/faisalulde/security-writeups/blob/main/0xV01D-CTF-2026/Action-Packed.md): challenge writeup · Single challenge case study and exploit narrative. · `0xV01D-CTF-2026/Action-Packed.md`
- [Silent Oracle](https://github.com/faisalulde/security-writeups/blob/main/0xV01D-CTF-2026/Silent-Oracle.md): challenge writeup · Single challenge case study and exploit narrative. · `0xV01D-CTF-2026/Silent-Oracle.md`
- [Altered Grimoire](https://github.com/faisalulde/security-writeups/blob/main/0xV01D-CTF-2026/The-Altered-Grimoire.md): challenge writeup · Single challenge case study and exploit narrative. · `0xV01D-CTF-2026/The-Altered-Grimoire.md`

### Support Assets

Media used as evidence inside selected writeups.

- [Screenshots](https://github.com/faisalulde/security-writeups/tree/main/boroCTF-2026/screenshots): asset folder · Supporting evidence images referenced by writeups. · `boroCTF-2026/screenshots`

## Connections

- README → boroCTF 2026: links to · Primary navigation into the boroCTF writeup collection.
- README → 0xV01D 2026: links to · Primary navigation into the 0xV01D writeup collection.
- README → SUMMARY: indexes · Provides an alternate entry point for the same Markdown corpus.
- SUMMARY → boroCTF 2026: toc for · Table-of-contents layer points into the boroCTF collection.
- SUMMARY → 0xV01D 2026: toc for · Table-of-contents layer points into the 0xV01D collection.
- boroCTF 2026 → boroGPT: contains · Collection contains individual challenge writeups.
- boroCTF 2026 → Kobenis Dashboard: contains · Collection contains individual challenge writeups.
- boroCTF 2026 → My Mayor Muslim: contains · Collection contains individual challenge writeups.
- boroCTF 2026 → Screenshots: supports · Screenshot assets support selected boroCTF writeups.
- Screenshots → boroGPT: evidence for · Evidence images may be embedded or referenced by the writeup.
- Screenshots → Kobenis Dashboard: evidence for · Evidence images may be embedded or referenced by the writeup.
- Screenshots → My Mayor Muslim: evidence for · Evidence images may be embedded or referenced by the writeup.
- 0xV01D 2026 → Action Packed: contains · Collection contains individual challenge writeups.
- 0xV01D 2026 → Silent Oracle: contains · Collection contains individual challenge writeups.
- 0xV01D 2026 → Altered Grimoire: contains · Collection contains individual challenge writeups.
