---
title: "Discussion on \"The Globe: Following Your Reasoning Into Other People's Repositories\" | Hashnode"
description: "Discussion on \"The Globe: Following Your Reasoning Into Other People's Repositories\". Keep the Why records why a codebase is the way it is. Decisions can cite decisions in other repositories. The Globe follows those citations outward, one wave at a time, without turning project memory into a centralized service."
url: "https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1"
---

[Feed](https://hashnode.com/feed) /

Discussion

# [The Globe: Following Your Reasoning Into Other People's Repositories](https://blog.technopathy.club/the-globe-following-your-reasoning-into-other-people-s-repositories?utm_source=hashnode&utm_medium=feed)

Keep the Why records why a codebase is the way it is. Decisions can cite decisions in other repositories. The Globe follows those citations outward, one wave at a time, without turning project memory into a centralized service.

Oct 1 · 13 min read · blog.technopathy.club  
Updated Oct 5  
Read the article

-   [#knowledge-management](https://hashnode.com/tag/knowledge-management)
-   [#git](https://hashnode.com/tag/git)
-   [#github](https://hashnode.com/tag/github)
-   [#developer-tools](https://hashnode.com/tag/developer-tools)
-   [#documentation](https://hashnode.com/tag/documentation)
-   [#claude-code](https://hashnode.com/tag/claude-code)
-   [#opensource](https://hashnode.com/tag/opensource)
-   [#ai](https://hashnode.com/tag/ai)
-   [#ai-agents](https://hashnode.com/tag/ai-agents)
-   [#ai-tools](https://hashnode.com/tag/ai-tools)
-   [#claude](https://hashnode.com/tag/claude)

## Written by

[Oliver Zehentleitner](https://hashnode.com/@oliver-zehentleitner)

@oliver-zehentleitner · Vienna, Austria

  
[View profile](https://hashnode.com/@oliver-zehentleitner)

DevSecOps · Python · AI-driven Development · Real-world findings from production systems.

I build systems that work — technically sound, security-first, and actually useful to the people who depend on them. Creator of the UNICORN Binance Suite — six open-source Python libraries with 3.3M+ downloads and 390+ dependent public projects — and Keep the Why, an open-source agent skill that preserves the reasoning behind engineering decisions alongside the code. Currently pioneering AI-driven open-source maintenance: running a controlled AI agent that maintains production code and documenting what this shift means for engineering teams. Vienna, Austria 🇦🇹

## Responses 10

Markdown supported · ⌘↵ to post

[Mihai\_LeanZero](https://hashnode.com/@mihaileanzero)

[Oct 2](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abf508e601d77f7e6af1c20)

The cross-origin fetch part is what stands out most to me here -- the browser reads another repo's .keep-the-why, then fetches that repo's state.json directly, no server in between. GitHub Pages happens to serve everything with permissive CORS by default, which is probably why this works smoothly for the examples here, but the post calls out "GitHub Pages or another static host." For a host that doesn't set Access-Control-Allow-Origin -- a bare S3 bucket without CORS configured, a plain nginx box serving static files -- does the Globe just silently drop that wave, or is there a visible failure state distinguishing "nothing there" from "blocked by CORS"? That seems like exactly the kind of thing that would be invisible until someone hits it.

[Oliver Zehentleitner](https://hashnode.com/@oliver-zehentleitner)

[Oct 2](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abf508e601d77f7e6af1c20#reply-6abf5d59c15f527ac0a9f834)

Should be fixed with PR #585 and #586, released in dashboard 0.6.8. In the status bar at the bottom of the dashboard ([https://keepthewhy.com/dashboard/live/](https://keepthewhy.com/dashboard/live/)) it says something like "10 states · 628.3 KB" - click on that. That's the "State Monitor": it lists every state the page loaded, and from now on also every one that failed, with the reason (e.g. "network error or blocked by CORS") and the address. A failed repository is also named in the globe's legend.

[Mihai\_LeanZero](https://hashnode.com/@mihaileanzero)

[Oct 2](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abf508e601d77f7e6af1c20#reply-6abf8775d82fc391d7fec98e)

That's a fast turnaround - PR shipped within the hour of the question. Naming CORS explicitly next to "network error" in the State Monitor is the right fix, since a bare "failed to fetch" really could mean five different things and a reader has no way to tell host-down from CORS from the repo just not existing. Having the legend call out the specific failed repository too closes the exact gap I was poking at - that's the detail that would otherwise have cost someone a long debugging session assuming their own export was broken.

[Oliver Zehentleitner](https://hashnode.com/@oliver-zehentleitner)

[Oct 5](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abf508e601d77f7e6af1c20#reply-6ac36bc5e98325c75fd6afe1)

Thanks for the hint :)

[Aarnav Saboo](https://hashnode.com/@aarnavsaboo)

[Oct 2](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abf35633312b235def25151)

Really like the idea of keeping the repository as the source of truth instead of turning project memory into another centralized service. Curious to see how this works once the graph gets much larger.

[Oliver Zehentleitner](https://hashnode.com/@oliver-zehentleitner)

[Oct 2](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abf35633312b235def25151#reply-6abf4f4143cda7d2705c267a)

Yes, that's the experiment :) Maybe it turns out to be a fit for small and mid-sized teams only, but I'm curious how far it goes too.

[netproxy](https://hashnode.com/@argumentmoney8117)

[Oct 1](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abee0851480eef6cb8fce2c)

I like that the graph only draws relations that were actually recorded — inferred edges would quietly undermine the provenance the whole thing is built on. Question: does the registry also help with the reverse direction, i.e. finding out who references your decisions? Or is that only visible once you load the citing project?

[Oliver Zehentleitner](https://hashnode.com/@oliver-zehentleitner)

[Oct 2](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abee0851480eef6cb8fce2c#reply-6abf54875c42b28470b6d7a5)

Thanks - that was exactly the reasoning: an edge in the graph means someone wrote it down, nothing else. On the reverse direction: right now only by loading. The registry index is just the list (where each export lives, versions, size), not who cites whom. The globe can load everything listed in one wave, and from then on the graph shows citations both ways - so with the registry you do see who references you, but you pay for loading them, and that won't scale forever. Since the registry build already reads every export, it could write a small reverse index on the side, so a dashboard sees who cites it without loading them all. Not there yet, but it's one possible way if more projects get listed.

[Oliver Zehentleitner](https://hashnode.com/@oliver-zehentleitner)

[Oct 5](https://hashnode.com/posts/the-globe-following-your-reasoning-into-other-people-s-repositories/6abe79902a890b1eceb0ebd1/comment/6abee0851480eef6cb8fce2c#reply-6ac36b8b8247e4b882099d10)

Now with dashboard 0.6.14 it can! See the "cited by" filter in the graph. Turn off friends to see it in this setup: [https://keepthewhy.com/dashboard/live/#graph](https://keepthewhy.com/dashboard/live/#graph)
