# THIS YOU — NEW ISSUE TEMPLATE v3

This folder is a complete authoring kit for one new THIS YOU issue.

## Give this folder to AI

A new AI conversation should be able to understand the magazine system without access to previous chats.

Start with:

1. `AI_INSTRUCTIONS.md`
2. `EDITORIAL_BRIEF_TEMPLATE.md`
3. `docs/00_START_HERE.md`
4. `examples/chapter-example/`

For convenience, `AI_START_PROMPT.md` contains a ready-to-paste first prompt.

---

# Workflow

1. Copy this folder.
2. Rename the copy to the final issue slug:
   `your-city-season-year`
3. Rename/fill the editorial brief.
4. Ask AI to lead **STEP 1**.
5. Work through the approval-gated process.
6. Fill JSON / layouts / assets as the issue develops.
7. Keep everything issue-specific inside this folder.
8. In Admin → Packages:
   - Upload Package Folder
   - Validate / Dry Run
   - Sync to DB

---

# Folder anatomy

```text
your-city-season-year/
    AI_INSTRUCTIONS.md
    AI_START_PROMPT.md
    EDITORIAL_BRIEF_TEMPLATE.md
    README.md

    manifest.json
    issue.json
    chapters.json
    pages.json
    theme.css

    layouts/
    assets/

    docs/
        00_START_HERE.md
        ...
        reference/

    examples/
        chapter-example/
```

---

# Important

**One folder = one issue.**

Do not merge issue assets or layouts into the engine root.

The shared issue is built first.
Reader personalization happens only after the shared issue has been approved.

The template ZIP itself is no longer stored inside this folder.
The admin download artifact lives separately in `/downloads/`.


## Template format v3

This template supports backward-compatible SCENE object variants (`default / male / female`) and the Style Exploration workflow (`familiar / elevated / surprise`). See `docs/04_SCENE_DESIGN_SYSTEM.md` and `docs/11_PRODUCT_FIRST_PERSONALIZATION.md`.