← FabianoMag

Public artifact · concise codemap

ARCHITECTURE.md

A compact codemap of FabianoMag's public routes, rendering boundaries, source boundaries, and invariants.

Open raw

Where it goes

  1. FabianoMag
  2. public
  3. ARCHITECTURE.md

Living file

Public architecture map

Explains how editorial HTML, Markdown mirrors, discovery files, harness graphs, and unknown routes fit together without exposing private implementation state.

ARCHITECTURE.md
View raw
# FabianoMag Public Architecture

## Purpose

FabianoMag is the English-first public site of Fabiano Magalhães. It combines
technical writing and public artifacts in one reader-friendly, agent-readable
Next.js application.

## Public route map

```text
/
  editorial home and current publications
/personal-harness-engineering
  article HTML
/artifacts/agent-harnesses
  interactive four-harness artifact
/personal-harness-engineering.md
  article Markdown mirror
/artifacts/agent-harnesses.md
  artifact Markdown mirror
/llms.txt
/sitemap.xml
/sitemap.md
/robots.txt
/AGENTS.md
/ARCHITECTURE.md
/sources.md
```

## Rendering boundaries

- Important editorial text is real HTML rendered at build time.
- The Agent Harnesses canvas has an equivalent HTML description and a static
  SVG generated from the same site-owned factual data. Graph IDs, ordered
  nodes, and ordered edges correspond to the public repository specs at commit
  `1a1978a8f456c2ea64ab4c556ef043d1bafb8441`.
- Article and artifact Markdown mirrors derive from the same content authority
  as their HTML routes.
- Discovery files list only routes that exist in the current deployment.
- Unknown routes return a human-readable, recoverable 404.

## Source boundaries

`Personal Harness Engineering` is an editorial migration from a public SGOPS
note. Its title, thesis, body order, and upstream source chain are preserved;
FabianoMag supplies the current public identity, links, and presentation.

The four harnesses are complementary packages selected by coordination
boundary. Capability badges describe evidence dimensions, not percentages,
maturity, or an overall ranking. Implementation, publication, and manual Codex
evidence remain separate states.

## Invariants

- Public authorship is Fabiano Magalhães.
- Source, release, install, evidence, and issue links are exposed only as real
  public destinations bound to the listed package version and source commit.
- No custom domain, DNS, private operational notes, or unrelated project state
  is implied by this site.