Files
joshuaandClaude Opus 5.5 54ae9c49a1 Tested: static Astro site answering hard Bible questions
Built from the kit specs (CLAUDE.md, docs/01-05): question index import,
status seals, connections graph, Pagefind search, Scripture margin,
and 157 evidence articles (drafts unless published) with sources and
verified "Learn more" links. Includes link, owner-notes, a11y and
publish scripts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 10:46:19 +02:00

38 lines
1.8 KiB
Markdown

# Tested — site starter kit
Everything Claude Code needs to build the Bible questions site: specs, design system, brand assets and a data importer.
## What's inside
| Path | What it is |
| --- | --- |
| `CLAUDE.md` | Claude Code reads this automatically. Sets the rules and points to the specs. |
| `docs/01-brief.md` | What the site is, who it's for, the honesty principles |
| `docs/02-design-system.md` | Colors, type, layouts, the signature arc diagram |
| `docs/03-architecture.md` | Stack (Astro), folders, data model, routes |
| `docs/04-build-plan.md` | Seven phases with "done when" checks |
| `docs/05-content-rules.md` | Status meanings and the full-article structure |
| `brand/` | Favicon, logo mark, full logo, social card (SVG) |
| `scripts/import-index.mjs` | Turns your question index into site data |
| `content/source/` | Where your exported question index goes |
## Setup (5 minutes)
1. **Unzip** into an empty folder and open it in WebStorm.
2. **Export your question index.** Open the "Bible Defense — Question Index" doc, export it as Markdown, and save it as `content/source/question-index.md`. This is the site's source of truth: update the doc, re-export, run `npm run import`.
3. **Start Claude Code** in WebStorm's terminal (`claude`) and paste the kickoff prompt below.
## Kickoff prompt
```
Read CLAUDE.md and every file in docs/ before doing anything.
Then start Phase 1 of docs/04-build-plan.md. Stop at the end of the phase,
run the build, and tell me what you did and why before moving on.
```
After each phase, review it with `npm run dev`, then reply "go" (or ask for changes).
## Renaming the site
"Tested" is a working name (1 Thessalonians 5:21). To rename it, ask Claude Code to update `src/site.config.ts`, the wordmark in `brand/logo-full.svg`, and the OG image text.