Shipyard

Monorepo for ravencalder.com — an astrological reading engine built around Raven Calder, a symbolic AI.

---

📂 Documentation Restructure

We have recently consolidated and organized all documentation files across this repository. Please navigate to the appropriate subdirectory under docs/ to find canonical specs, system architecture, operations, and logs:

• 📘 Canonical Core: docs/core/README.md — Main repository setup, key commands, and stack info.
• 🤖 Agent Directive: docs/core/AGENTS.md — Essential guidelines for LLM and coding agents.
• 🗺️ Restructure Guide: docs/core/DOCS_RESTRUCTURE_EXPLANATION_FOR_AGENTS.md — How the documentation is organized and rules for future contributions.
• 📜 Changelog Index: docs/history/changelogs/CHANGELOG_2026_05_08_docs_restructure.md — Restructuring changelog.

---

📂 Normalized Folder Map

• docs/core/ -> Canonical project docs (README, roadmap, status)
• docs/architecture/ -> System architecture, blueprints, structural contracts
• docs/operations/ -> Maintenance, runbooks, workflows, policies
• docs/research/ -> Audits, experiments, validations, notebooks
• docs/history/changelogs/ -> Changelogs
• docs/history/captains-logs/ -> Captain logs and historical session narratives
• docs/subprojects/ -> Subproject-specific buckets
• docs/source-notes/ -> Pasted notes, raw notes, transient source material
• docs/archive/ -> Legacy/superseded but retained material
• artifacts/generated/ -> Generated diagnostics, machine context dumps