179 lines
7.2 KiB
Markdown
179 lines
7.2 KiB
Markdown
# 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
|
|
├── .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:
|
|
|
|
```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)
|