# CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

## 🚨 MANDATORY FOR AI AGENTS - AI-CHATS PROTOCOL v3.2

Adhere to the `./.ai-chats/README.md` protocol with every chat and every exchange!

### 📁 Session Structure

```text
.ai-chats/
├── INDEX.md                             ← MASTER INDEX (MANDATORY!)
├── README.md                            ← Full protocol documentation
└── YYYY-MM-DD-NN-description/           ← Session folder
    ├── [Model-Version]--00.md           ← Summary, tech, lessons
    ├── [Model-Version]--01.md           ← Exchange 1 (VERBATIM)
    └── [Model-Version]--NN.md           ← Continue 01-99
```

### 🔴 Critical Filename Rules

| Rule                    | ❌ Wrong                | ✅ Correct             |
|-------------------------|-------------------------|------------------------|
| No spaces               | `Opus 4.5--00.md`       | `Opus-4.5--00.md`      |
| Double dash before seq  | `Opus-4.5-00.md`        | `Opus-4.5--00.md`      |
| Include version         | `Opus--00.md`           | `Opus-4.5--00.md`      |

### 📋 Session Start Checklist

1. Check `.ai-chats/` exists → Create if missing
2. Check `INDEX.md` exists → Create from template if missing
3. Check for today's folders (`YYYY-MM-DD-*`)
4. Create/use session folder: `YYYY-MM-DD-NN-description/`
5. Create `[Model-Version]--00.md` (summary) + `--01.md` (first exchange)

### 📋 Session End Checklist

1. Update `--00.md` with final summary and exchange index
2. **UPDATE INDEX.md** with session info, file count, status
3. Commit to git

### ⚠️ Critical Rules

- **--00 files**: Summary, tech details, lessons learned, next steps
- **--01+ files**: COMPLETE VERBATIM exchanges - **NO SUMMARIZATION!**
- **INDEX.md**: Must be updated after EVERY session
- **Model names**: `Opus-4.5`, `Sonnet-4.5`, `Haiku-3.5` (Claude Code)

---

## 📖 Project Overview

**Artfight HTML** is a public repository by **lavender-daydream** (Lav) containing:

- **Reusable HTML templates** for Artfight character/profile pages
- **Lavender's own Artfight character HTML pages** — for personal reference and public inspiration

This repo is intended to help the Artfight community use and customize HTML on their profiles and character pages.

**Owner:** lavender-daydream

> **Note for Claude:** The owner's public name is **lavender-daydream** (also referred to as **Lavender** or **Lav**). Their real name is in `CLAUDE.private.md` — never use it in any file, comment, or output in this repository. This is a public repo under their community identity.

---

## 🏗️ Repository Structure

```text
artfight-html/
├── templates/                  # Reusable HTML templates (copy-friendly)
│   └── character-template-1.html
├── characters/                 # Lav's own Artfight character pages
│   └── [character-name].html
├── archive/                    # Archived AI session logs from early setup
└── CLAUDE.md
```

### Adding a New Template

1. Create file in `templates/` with a descriptive name: `templates/[purpose]-[variant].html`
2. Include a header comment block at the top (see HTML Conventions below)
3. Keep templates self-contained — inline all styles, avoid external dependencies

### Adding a Character Page

1. Create file in `characters/` named after the character: `characters/[character-name].html`
2. Include a header comment block at the top (see HTML Conventions below)

---

## 📝 HTML Conventions

- **Self-contained files**: All CSS should be `<style>` tags inline; no external stylesheets
- **No JavaScript**: Artfight does not support JS — do not add `<script>` tags
- **Artfight HTML limits**: Be mindful of character limits and tag restrictions on Artfight profiles
- **Comments**: Use HTML comments (`<!-- -->`) to explain sections for people copying templates
- **Semantic HTML**: Prefer semantic tags (`<section>`, `<article>`, `<aside>`) over pure `<div>` soup where it reads more clearly

---

## 🤖 AI Transparency

Art communities deserve to know when AI is involved. **Every file in this repo must clearly disclose any AI involvement**, so that people can make their own informed choice about whether to use the code.

### Required Header Comment (ALL files)

Every `.html` file must start with a comment block like this:

```html
<!--
  ============================================================
  FILE: [filename].html
  AUTHOR: lavender-daydream (https://artfight.net/~Lavender-Daydream)
  ============================================================

  AI INVOLVEMENT:
  [One of the following — be honest and specific]

  ✅ No AI used — written entirely by Lav.

  OR

  🤖 AI-assisted — details below:
    - Tool: Claude Sonnet 4.6 (Claude Code)
    - What AI did: [e.g. "wrote the initial layout from scratch",
                       "suggested the color variables",
                       "rewrote lines 42-67 for better readability"]
    - What Lav did: [e.g. "chose all colors, adjusted spacing,
                         wrote all character-specific content"]
  ============================================================
-->
```

If AI edits a file after the initial header is written, **update the AI INVOLVEMENT section** to reflect the new changes. Be specific about which lines or sections were touched.

### AI-DISCLOSURE.md (Central Log)

A file called `AI-DISCLOSURE.md` lives at the root of this repo. It is a plain-English log that anyone — including people who don't know how to code — can read to understand AI involvement across the whole project.

**You must update `AI-DISCLOSURE.md` every time a file is created or AI-edited.** Format:

```markdown
## [filename].html
- **Location:** templates/ or characters/
- **AI involved:** Yes / No
- **AI tool:** Claude Sonnet 4.6 (if applicable)
- **What AI did:** [plain English description]
- **What Lav did:** [plain English description]
- **Last updated:** YYYY-MM-DD
```

### Rules for Claude

- **Never create or edit an HTML file without updating its header comment and `AI-DISCLOSURE.md`**
- If Lav writes a file herself and asks you to make a small edit, note the edit specifically — do not overwrite the "No AI used" status for the whole file
- When in doubt, disclose more, not less
- The goal is that someone browsing this repo can always tell exactly what a human made vs. what AI made

---

## ⚖️ Usage & Credit

All HTML in this repository is free to use and modify, but **credit is required**.

- Link back to this repository or credit **lavender-daydream** when using templates or character page code
- You may adapt and modify freely for your own Artfight use

---

## 🔗 Artfight Resources

- **Lavender's Artfight profile**: [artfight.net/~Lavender-Daydream](https://artfight.net/~Lavender-Daydream)
- **Lavender's website**: [lavender-daydream.com](https://www.lavender-daydream.com/)
- **Lavender's links**: [linkstack.lavender.spl.tech/@Lavender-Daydream](https://linkstack.lavender.spl.tech/@Lavender-Daydream)
- **Artfight**: [artfight.net](https://artfight.net/)
- **Artfight HTML Guide**: [artfight.net/info/html](https://artfight.net/info/html) (if applicable)