> Source URL: /grok-26/10-20.slides
# The unreasonable effectiveness of files in a folder

---

![files-in-a-folder](./assets/files-in-a-folder.png)

---

# 👀 How do files look?

---

```bash
ls # list files in the current directory
cat <file> # not as cool as it looks... just print the contents of a file
find -name <pattern> # find files by name
tree # print the tree of the current directory
```

---

![file-finder](./assets/files-finder.png)

^ we all know what this is

---

![linked-files-in-a-folder](./assets/linked-files-in-a-folder.png)

^ files with links to other files (e.g. markdown) `>` files w/ no links

---

![linked-files-in-a-repo](./assets/linked-files-in-a-repo.png)

^ put these files in a repository and now you have versioned history, diffs, and more.

---

![linked-typed-files-in-a-repo](./assets/linked-typed-filees-in-a-repo.png)

^ if you name your files with type hints, it allows humans (and agents) to infer the ontological role of the file without having to read the contents.

---

![linked-files-graph](./assets/linked-files-graph.png)

^ this create an ontological graph representing whatever domain you like that can be built bottom-up.

---

```bash
ls -l  # list all files
find -name "*.profile.md" # find all profile files
cp lab-template.lab.md week-2.lab.md # create a new lab file from a template
claude -e "create a new guide for Rory T who is struggling with the concepts of loop introduced in lecture 3 and lab 2" # cretes a personalized guide for Rory T based on the current folder context
git diff # show all changes in the repository
git commit -m "add new lab file for week 2 and guide for Rory T"
git push # push the changes to the remote repository
```

---

# PathMX

- Human first. Agent friendly.
- "Markdown files in a repo" but with super powers
- Evolves as you build it, portable and maintainable by design

---

![figure 1](./assets/figure-1-pathmx-approach.png)

---

![figure 2](./assets/figure-2-pathmx-principles.png)

---

![figure 3](./assets/figure-3-pathmx-graph.png)

---

![figure 4](./assets/figure-4-pathmx-artifacts.png)

---

# Examples

- [Learn to Code with AI and Sports](https://bletchley.path.app/ai-and-sports/index.path)
- [Grok 26' Path](https://grok26.path.app/)
- [This talk!](https://pathmx.dev/grok-26/10-20.talk)

---

> [PathMX.dev](https://pathmx.dev)

---

![qr code](./assets/pathmx-dev-qr.png)

# Questions?

```

```


---

## Backlinks

The following sources link to this document:

- [Grok 26' 10/20 Talk](/index.path.llm.md)