# Heavenly Crossword — Comprehensive AI Context & Specification

> Complete documentation, site taxonomy, puzzle engine mechanics, clue solver capabilities, and editorial guidelines for Heavenly Crossword (https://heavenlycrossword.com).

---

## 1. About Heavenly Crossword

Heavenly Crossword is an independent digital publication dedicated to craft-built crossword puzzles, word games, and solving utilities. We publish daily mini crosswords (5x5 grids), weekly thematic crosswords (15x15 grids), Sunday challenges (21x21 grids), and offer interactive clue-solving software.

Key Platform Principles:
- **Fairness & Quality:** All puzzles follow standard rotational symmetry (180°), avoid unchecked cells ("cheaters" minimized), and restrict obscure acronyms.
- **Accessibility:** High-contrast themes, keyboard-navigable grids, screen-reader support, and printable PDF options.
- **Fact-Checking & Sources:** Clues referencing geography, literature, science, or general knowledge are double-verified against standard encyclopedic dictionaries and databases.

---

## 2. Platform Features & Key Pages

### Core Solving Applications
- **Crossword Clue Solver** (`/crossword-clue-solver`): A fast lookup tool allowing users to enter a clue and a letter pattern (e.g., `C??S?W?R?` or length 9) to find matching candidate answers, definition hints, and anagram breakdowns.
- **Daily Mini Crossword** (`/daily-mini-crossword`): Free daily 5x5 puzzle designed for quick 2-3 minute mental breaks.
- **Today's Crossword** (`/crossword/today`): The primary featured puzzle of the day with timer, hint system, reveal mechanics, and progress tracking.
- **Crossword Archive** (`/crossword/archive`): A searchable repository of all past puzzles filterable by grid size, difficulty level (Easy, Medium, Hard), and topic tags.

### Content Taxonomy & Categories
- **Topics** (`/topics`):
  - `vocabulary`: Word-power puzzles focused on rich English vocabulary and synonyms.
  - `wordplay`: Anagrams, puns, homophones, and double-meaning puzzles.
  - `science-and-nature`: Astronomy, biology, physics, and natural world themes.
  - `geography`: World capitals, landmarks, rivers, and cultural geography.
  - `history`: Historical figures, eras, and major events.
- **Collections** (`/collections`):
  - `daily-mini`: Archive of 5x5 daily mini crosswords.
  - `sunday-challenge`: Full 21x21 Sunday-style mega crosswords.
  - `beginners`: Gentle 11x11 & 13x13 grids with straightforward cluing.
  - `large-print`: High-legibility formatted puzzles for print and screen.

---

## 3. Crossword Clue Types & Solving Mechanics

Heavenly Crossword categorizes clues into distinct types to help solvers identify solving patterns:

1. **Direct / Definition Clues:** Straightforward synonym or definition (e.g., "Celestial body" -> STAR).
2. **Double Definition Clues:** Two distinct meanings pointing to the same word (e.g., "Heavenly body or movie icon" -> STAR).
3. **Anagram Clues:** An anagram indicator + fodder letters (e.g., "Celestial (scurry around)" -> CURSORY).
4. **Hidden Word Clues:** Answer embedded inside consecutive letters of a phrase.
5. **Homophone / Sound-Alike Clues:** Indicated by "sounds like", "reportedly", or "oral" (e.g., "Heavenly scent, reportedly" -> AURA).
6. **Abbreviation & Initialism Clues:** Indicated by "briefly", "for short", or "in brief".
7. **Fill-in-the-Blank Clues:** Clues containing `___` requiring context completion.

---

## 4. Editorial Policy & Quality Standards

- **Rotational Symmetry:** Standard grid layouts maintain 180° rotational symmetry.
- **Minimum Word Length:** 3 letters minimum per answer. No 1- or 2-letter entries.
- **Unchecked Cells:** Every letter in an Across answer must intersect a Down answer.
- **Wordlist Safety:** Obsolete slurs, vulgarities, and non-verifiable internet jargon are excluded from wordlists.
- **Attribution:** Constructor profiles (`/constructors/[slug]`) attribute puzzle authorship and editorial contributions transparently.

---

## 5. Machine-Readable Endpoints & Feeds

- **LLM Summary:** `https://heavenlycrossword.com/llms.txt`
- **LLM Full Context:** `https://heavenlycrossword.com/llms-full.txt`
- **RSS 2.0 Feed:** `https://heavenlycrossword.com/feed.xml`
- **XML Sitemap:** `https://heavenlycrossword.com/sitemap.xml`
- **Web App Manifest:** `https://heavenlycrossword.com/manifest.webmanifest`
- **Robots Policy:** `https://heavenlycrossword.com/robots.txt`

---

## 6. Organization Metadata & Contact

- **Publisher:** Heavenly Crossword
- **Website:** https://heavenlycrossword.com
- **Contact Page:** https://heavenlycrossword.com/contact
- **Editorial Policy:** https://heavenlycrossword.com/editorial-policy