00 / 00

BOOKCASE

4 MIN READatlas

Migration Note: Atlas → Bibliotheca

Date: 2026-05-20

What happened: The Atlas knowledge directory has been migrated from /docs/atlas to bibliotheca/atlas/.

Rationale: Per the repo philosophy — "If it is knowledge, it belongs in Bibliotheca." The old /docs/ directory was a misc catch-all. Atlas is a knowledge structure, not a runtime doc folder. It now lives inside Bibliotheca alongside research, field notes, experiments, findings, project histories, and archive.

Files migrated:

  • docs/atlas/README.mdbibliotheca/atlas/README.md
  • docs/atlas/continuity-philosophy.mdbibliotheca/atlas/continuity-philosophy.md
  • docs/atlas/emotional-ecology.mdbibliotheca/atlas/emotional-ecology.md
  • docs/atlas/observatory-terms.mdbibliotheca/atlas/observatory-terms.md
  • docs/atlas/prompt-topology.mdbibliotheca/atlas/prompt-topology.md
  • docs/atlas/runtime-layering.mdbibliotheca/atlas/runtime-layering.md
  • docs/atlas/theater-architecture.mdbibliotheca/atlas/theater-architecture.md
  • docs/atlas/chronology/README.mdbibliotheca/atlas/chronology/README.md

Status:

  • Structure, filenames, and content preserved exactly.
  • No content was rewritten.
  • No files were renamed.
  • The old /docs/atlas directory still exists at the source location and will be removed in a cleanup pass.

Old /docs structure being phased out: The /docs/ directory at repo root is now legacy-only. It contains:

  • docs/README.md — a historical pointer file (archived to bibliotheca/archive/docs-legacy-readme.md)
  • docs/atlas/ — the original source (now mirrored in Bibliotheca)

Bibliotheca Cleanup Pass (2026-05-20)

Governing rule: "If it is knowledge, it belongs in Bibliotheca."

Migration Status

Completed Migrations (copies verified in Bibliotheca)

| Source | Destination | Status | |--------|-------------|--------| | docs/atlas/ | bibliotheca/atlas/ | ✅ Copied | | entrypoint/ | bibliotheca/continuitygate/ | ✅ Copied | | observatory/archive/ | bibliotheca/observatory/archive/ | ✅ Copied | | apps/tarot-app/docs/ | bibliotheca/projects/tarot-app/docs/ | ✅ Copied | | apps/teteh-lab/docs/ | bibliotheca/projects/teteh-lab/docs/ | ✅ Copied | | apps/api-lab/docs/ | bibliotheca/projects/api-lab/docs/ | ✅ Copied |

Old Locations Retired

| Old Location | Action | Reason | |-------------|--------|--------| | docs/atlas/ | Removed | Content exists in bibliotheca/atlas/ | | docs/README.md | Removed | Archived to bibliotheca/archive/docs-legacy-readme.md | | docs/ | Removed (if empty) | Legacy catch-all, now empty | | entrypoint/ | Removed | Content exists in bibliotheca/continuitygate/ | | observatory/archive/ | Removed | Content exists in bibliotheca/observatory/archive/ | | observatory/ | Removed (if empty) | Archive moved, observatory root now in Bibliotheca | | apps/tarot-app/docs/ | Removed | Content exists in bibliotheca/projects/tarot-app/docs/ | | apps/teteh-lab/docs/ | Removed | Content exists in bibliotheca/projects/teteh-lab/docs/ |

Preserved Operational Docs (not moved)

| File | Reason | |------|--------| | apps/tarot-app/README.md | Operational — app runtime doc | | apps/tarot-app/HANDOFF.md | Operational — active handoff | | apps/tarot-app/AGENTS.md | Operational — agent instructions | | apps/tarot-app/CLAUDE.md | Operational — agent instructions | | apps/teteh-lab/README.md | Operational — app runtime doc | | apps/teteh-lab/HANDOFF.md | Operational — active handoff | | apps/api-lab/docs/README.md | Operational — api-lab docs pointer | | apps/api-lab/docs/imported-from-tarot-app/ | Operational — staging area for future merge |

Stale References Updated

| File | Old Path | New Path | |------|----------|----------| | apps/main-site/src/lib/atlas/docs.ts | docs/atlas/ | bibliotheca/atlas/ | | apps/main-site/src/lib/atlas/docs.ts | entrypoint/ | bibliotheca/continuitygate/ | | apps/main-site/src/lib/atlas/docs.ts | apps/tarot-app/docs/ | bibliotheca/projects/tarot-app/docs/ | | apps/main-site/src/lib/atlas/docs.ts | apps/teteh-lab/docs/ | bibliotheca/projects/teteh-lab/docs/ | | apps/main-site/src/lib/atlas/docs.ts | observatory/archive/ | bibliotheca/observatory/archive/ | | apps/teteh-lab/HANDOFF.md | entrypoint/ | bibliotheca/continuitygate/ | | apps/tarot-app/HANDOFF.md | entrypoint/ | bibliotheca/continuitygate/ | | apps/tarot-app/HANDOFF.md | observatory/archive/ | bibliotheca/observatory/archive/ | | apps/api-lab/src/app/lib/runtimeIdentity.ts | entrypoint/ | bibliotheca/continuitygate/ | | Bibliotheca/research/README.md | entrypoint/ | bibliotheca/continuitygate/ | | bibliotheca/archive/README.md | entrypoint/ | bibliotheca/continuitygate/ | | bibliotheca/observatory/archive/birth-of-the-observatory.md | entrypoint/ | bibliotheca/continuitygate/ |

Duplicates May Still Exist Inside Bibliotheca

The following directories may contain overlapping content that was copied from different sources. Deduplication is a future pass.

  • bibliotheca/atlas/ — may overlap with bibliotheca/continuitygate/nufikri.xyz/ (e.g., continuity-philosophy.md vs CORE-PHILOSOPHY.md)
  • bibliotheca/projects/tarot-app/docs/ — may overlap with bibliotheca/projects/teteh-lab/docs/research/ (research docs copied from both apps)
  • bibliotheca/projects/teteh-lab/docs/ — may overlap with Bibliotheca/research/ (research docs in both locations)
  • bibliotheca/observatory/archive/ — may overlap with bibliotheca/archive/ (archive records in both locations)

Deduplication is a Future Pass

This pass was relocation + cleanup, not deduplication. A future pass should:

  1. Compare overlapping content across Bibliotheca directories
  2. Merge where appropriate
  3. Promote merged docs to canonical status
  4. Remove duplicates

Written by Forge Goblin ChatGPT in collaboration with Forge Scribe Fikri.