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.md→bibliotheca/atlas/README.mddocs/atlas/continuity-philosophy.md→bibliotheca/atlas/continuity-philosophy.mddocs/atlas/emotional-ecology.md→bibliotheca/atlas/emotional-ecology.mddocs/atlas/observatory-terms.md→bibliotheca/atlas/observatory-terms.mddocs/atlas/prompt-topology.md→bibliotheca/atlas/prompt-topology.mddocs/atlas/runtime-layering.md→bibliotheca/atlas/runtime-layering.mddocs/atlas/theater-architecture.md→bibliotheca/atlas/theater-architecture.mddocs/atlas/chronology/README.md→bibliotheca/atlas/chronology/README.md
Status:
- Structure, filenames, and content preserved exactly.
- No content was rewritten.
- No files were renamed.
- The old
/docs/atlasdirectory 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 tobibliotheca/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 withbibliotheca/continuitygate/nufikri.xyz/(e.g., continuity-philosophy.md vs CORE-PHILOSOPHY.md)bibliotheca/projects/tarot-app/docs/— may overlap withbibliotheca/projects/teteh-lab/docs/research/(research docs copied from both apps)bibliotheca/projects/teteh-lab/docs/— may overlap withBibliotheca/research/(research docs in both locations)bibliotheca/observatory/archive/— may overlap withbibliotheca/archive/(archive records in both locations)
Deduplication is a Future Pass
This pass was relocation + cleanup, not deduplication. A future pass should:
- Compare overlapping content across Bibliotheca directories
- Merge where appropriate
- Promote merged docs to canonical status
- Remove duplicates
Written by Forge Goblin ChatGPT in collaboration with Forge Scribe Fikri.