# 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.