# marcelojtelles/automato-pilha architecture

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

- Interactive diagram: https://gitdiagram.com/marcelojtelles/automato-pilha
- Repository: https://github.com/marcelojtelles/automato-pilha

## Overview

This repository contains a README about pushdown automata, not an implementation: there are no source files or runtime entry points. Its reader-facing path is from an introduction to theoretical foundations and then to illustrative applications. The README describes applications across parsing, navigation, expression evaluation, editing, and simulation, but these are examples rather than implemented subsystems; relationships below reflect only those documented topics.

Main entry points: [`README.md`](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md) (Pushdown automata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Learning guide"]
  node_overview["Pushdown automata<br/>[README.md]"]
end

subgraph group_applications["Application examples"]
  node_compiler["Compilers<br/>[README.md]"]
  node_natural_language["Natural language<br/>[README.md]"]
  node_filesystem["Filesystem navigation<br/>[README.md]"]
  node_rpn["RPN calculators<br/>[README.md]"]
  node_browser_history["Browser history<br/>[README.md]"]
  node_markup["Markup validation<br/>[README.md]"]
  node_undo_redo["Undo and redo<br/>[README.md]"]
  node_simulation["Cellular simulation<br/>[README.md]"]
  node_security["Security analysis<br/>[README.md]"]
  node_dsl["DSL parsing<br/>[README.md]"]
end

subgraph group_foundations["Theory context"]
  node_foundations_topics["Theory foundations<br/>[README.md]"]
end

node_learner(("Learner"))

node_learner -->|"reads"| node_overview
node_overview -->|"introduces"| node_foundations_topics
node_overview -->|"describes application"| node_compiler
node_overview -->|"describes application"| node_natural_language
node_overview -->|"describes application"| node_filesystem
node_overview -->|"describes application"| node_rpn
node_overview -->|"describes application"| node_browser_history
node_overview -->|"describes application"| node_markup
node_overview -->|"describes application"| node_undo_redo
node_overview -->|"describes application"| node_simulation
node_overview -->|"describes application"| node_security
node_overview -->|"describes application"| node_dsl

click node_overview "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_foundations_topics "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_compiler "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_natural_language "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_filesystem "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_rpn "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_browser_history "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_markup "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_undo_redo "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_simulation "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_security "https://github.com/marcelojtelles/automato-pilha/blob/main/README.md"
click node_dsl "https://github.com/marcelojtelles/automato-pilha/blob/main/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_overview toneBlue
class node_compiler,node_natural_language,node_filesystem,node_rpn,node_browser_history,node_markup,node_undo_redo,node_simulation,node_security,node_dsl toneAmber
class node_foundations_topics toneMint
class node_learner toneIndigo
```

## Components

### Learning guide

- [Pushdown automata](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`

### Application examples

- [Compilers](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Natural language](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Filesystem navigation](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [RPN calculators](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Browser history](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Markup validation](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Undo and redo](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Cellular simulation](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [Security analysis](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`
- [DSL parsing](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`

### Theory context

- [Theory foundations](https://github.com/marcelojtelles/automato-pilha/blob/main/README.md): `README.md`

### Other components

- **Learner**

## Connections

- Learner → Pushdown automata: reads (evidence: `README.md`)
- Pushdown automata → Theory foundations: introduces (evidence: `README.md`)
- Pushdown automata → Compilers: describes application (evidence: `README.md`)
- Pushdown automata → Natural language: describes application (evidence: `README.md`)
- Pushdown automata → Filesystem navigation: describes application (evidence: `README.md`)
- Pushdown automata → RPN calculators: describes application (evidence: `README.md`)
- Pushdown automata → Browser history: describes application (evidence: `README.md`)
- Pushdown automata → Markup validation: describes application (evidence: `README.md`)
- Pushdown automata → Undo and redo: describes application (evidence: `README.md`)
- Pushdown automata → Cellular simulation: describes application (evidence: `README.md`)
- Pushdown automata → Security analysis: describes application (evidence: `README.md`)
- Pushdown automata → DSL parsing: describes application (evidence: `README.md`)
