Artfight-HTML/CLAUDE.md

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

.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). Never use their real name (Berlyn / Berlyn Neese) in any file, comment, or output in this repository — this is a public repo under their community identity.

---

🏗️ Repository Structure

artfight-html/
├── templates/                  # Reusable HTML templates (copy-friendly)
│   └── character-template-1.html
├── characters/                 # Lav's own Artfight character pages
│   └── [character-name].html
├── .ai-chats/                  # AI session documentation
├── AI-DISCLOSURE.md            # Plain-English log of all AI involvement
└── CLAUDE.md

Adding a New Template

1. Create file in templates/ with a descriptive name: templates/[purpose]-[variant].html
2. Include a standard header comment block at the top (see AI Transparency section 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 standard header comment block at the top (see AI Transparency section 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:

<!--
  ============================================================
  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:

## [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
• Lavender's website: lavender-daydream.com
• Lavender's links: linkstack.lavender.spl.tech/@Lavender-Daydream
• Artfight: artfight.net
• Artfight HTML Guide: artfight.net/info/html (if applicable)