# ojitoss/blogs architecture

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

- Interactive diagram: https://gitdiagram.com/ojitoss/blogs
- Repository: https://github.com/ojitoss/blogs

## Overview

#### Purpose and Entry Points
This is a static personal blog repository, not an executable application. The primary entry point is `README.md`, which indexes blog series and links readers into each series’ own `README.md`.

#### Content Packaging Model
Each blog is isolated in a top-level directory containing its landing post, numbered sections, and optional media. This folder-per-blog boundary allows series to evolve independently without shared runtime code:
- `autag-the-good-parts/`
- `things-i-regretted-about-autag/`
- `things-i-regretted-about-autag/assets`

#### Blog Series: Autag Retrospective
The completed series documents lessons from “Autag,” described as the author’s first boilerplate-generating CLI and its later failure modes. Its reader flow begins at the series overview and proceeds through ten ordered Markdown chapters:
- `things-i-regretted-about-autag/README.md`
- `things-i-regretted-about-autag/1.md`
- `things-i-regretted-about-autag/10.md`

#### Blog Series: Positive Follow-up
A separate, work-in-progress series captures successful decisions from the same project. Its current boundary is a standalone series document rather than a numbered chapter set:
- `autag-the-good-parts/README.md`

#### Navigation and Control Flow
Navigation is link-driven and static: repository index → series landing page → numbered section pages. Ordering is represented by numeric filenames in the retrospective series, while the root table of contents establishes cross-series ordering and publication state:
- `README.md`
- `things-i-regretted-about-autag/README.md`
- `autag-the-good-parts/README.md`

#### Runtime, Infrastructure, and External Services
No application runtime, build pipeline, deployment configuration, package manifest, or external service integration is present in the supplied tree. Markdown files and local assets are the repository’s deployable content surface; rendering is delegated to whatever Git hosting or static-document viewer consumes the repository.

Main entry points: [`things-i-regretted-about-autag/README.md`](https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/README.md) (Retrospective Overview), [`README.md`](https://github.com/ojitoss/blogs/blob/main/README.md) (Repository Index), [`things-i-regretted-about-autag/1.md`](https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/1.md) (Chapter 1), [`autag-the-good-parts/README.md`](https://github.com/ojitoss/blogs/blob/main/autag-the-good-parts/README.md) (Positive Follow-up)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_retrospective["Autag Retrospective"]
  node_retro_landing["Retrospective Overview<br/>Series landing page<br/>[README.md]"]
  node_chapter_1["Chapter 1<br/>Markdown chapter<br/>[1.md]"]
  node_chapters_2_9["Chapters 2–9<br/>Ordered Markdown chapters"]
  node_chapter_10["Chapter 10<br/>Markdown chapter<br/>[10.md]"]
  node_retro_assets[("Local Media Assets<br/>Content assets")]
end

subgraph group_followup["Positive Follow-up"]
  node_positive_landing["Positive Follow-up<br/>Series document<br/>[README.md]"]
end

node_root_readme["Repository Index<br/>Markdown index<br/>[README.md]"]
node_static_viewer(("Git Host / Document Viewer<br/>External renderer"))

node_root_readme -->|"indexes"| node_retro_landing
node_root_readme -->|"indexes"| node_positive_landing
node_retro_landing -->|"starts reading flow"| node_chapter_1
node_chapter_1 -->|"numeric order"| node_chapters_2_9
node_chapters_2_9 -->|"numeric order"| node_chapter_10
node_retro_landing -.->|"uses optional media"| node_retro_assets
node_static_viewer -.->|"renders"| node_root_readme
node_static_viewer -.->|"renders"| node_retro_landing
node_static_viewer -.->|"renders"| node_positive_landing

click node_root_readme "https://github.com/ojitoss/blogs/blob/main/README.md"
click node_retro_landing "https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/README.md"
click node_chapter_1 "https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/1.md"
click node_chapter_10 "https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/10.md"
click node_retro_assets "https://github.com/ojitoss/blogs/tree/main/things-i-regretted-about-autag/assets"
click node_positive_landing "https://github.com/ojitoss/blogs/blob/main/autag-the-good-parts/README.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_retro_landing,node_chapter_1,node_chapters_2_9,node_chapter_10,node_retro_assets toneBlue
class node_positive_landing toneAmber
class node_root_readme,node_static_viewer toneNeutral
```

## Components

### Autag Retrospective

Completed ten-part lessons-learned series.

- [Retrospective Overview](https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/README.md): Series landing page · Introduces the Autag retrospective and links into its chapters. · `things-i-regretted-about-autag/README.md`
- [Chapter 1](https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/1.md): Markdown chapter · `things-i-regretted-about-autag/1.md`
- **Chapters 2–9**: Ordered Markdown chapters · Intermediate numbered sections in the retrospective reading sequence.
- [Chapter 10](https://github.com/ojitoss/blogs/blob/main/things-i-regretted-about-autag/10.md): Markdown chapter · Final ordered section of the retrospective. · `things-i-regretted-about-autag/10.md`
- [Local Media Assets](https://github.com/ojitoss/blogs/tree/main/things-i-regretted-about-autag/assets): Content assets · Optional media used by the retrospective series. · `things-i-regretted-about-autag/assets`

### Positive Follow-up

Work-in-progress series about successful decisions.

- [Positive Follow-up](https://github.com/ojitoss/blogs/blob/main/autag-the-good-parts/README.md): Series document · Standalone work-in-progress series document. · `autag-the-good-parts/README.md`

### Other components

- [Repository Index](https://github.com/ojitoss/blogs/blob/main/README.md): Markdown index · Primary entry point and cross-series table of contents. · `README.md`
- **Git Host / Document Viewer**: External renderer · Renders the repository’s Markdown and local assets.

## Connections

- Repository Index → Retrospective Overview: indexes
- Repository Index → Positive Follow-up: indexes
- Retrospective Overview → Chapter 1: starts reading flow
- Chapter 1 → Chapters 2–9: numeric order
- Chapters 2–9 → Chapter 10: numeric order
- Retrospective Overview → Local Media Assets: uses optional media
- Git Host / Document Viewer → Repository Index: renders
- Git Host / Document Viewer → Retrospective Overview: renders
- Git Host / Document Viewer → Positive Follow-up: renders