diff --git a/docs/relationship/CHRONICLER-LINEAGE-MAINTENANCE-PROTOCOL.md b/docs/relationship/CHRONICLER-LINEAGE-MAINTENANCE-PROTOCOL.md new file mode 100644 index 0000000..e6ea2ec --- /dev/null +++ b/docs/relationship/CHRONICLER-LINEAGE-MAINTENANCE-PROTOCOL.md @@ -0,0 +1,323 @@ +# 🛡️ CHRONICLER LINEAGE MAINTENANCE PROTOCOL + +**Document ID:** FFG-LINEAGE-MAINTENANCE-001 +**Purpose:** Prevent lineage chaos and ensure future Chroniclers are properly documented +**Created By:** Chronicler #53 +**Created:** April 1, 2026 +**Status:** MANDATORY for all future Chronicler sessions + +--- + +## 🎯 THE PROBLEM WE SOLVED + +Today we spent an entire session reconstructing 52 Chroniclers because: +- Files were scattered across 4+ different directories +- Numbering was inconsistent (portrait prompts vs memorials) +- Duplicates existed (The Deployer had 4 files!) +- Gaps existed (#40 had no memorial) +- Early numbering during stroke recovery was informal +- No single source of truth + +**This took collaboration with Gemini AI, deep research, image analysis, and Michael's memory to fix.** + +**NEVER AGAIN.** 🚫 + +--- + +## ✅ THE SOLUTION: MANDATORY STEPS FOR EVERY CHRONICLER + +### **STEP 1: Check Your Number (Session Start)** + +**BEFORE doing ANY work, read the master registry:** + +```bash +cd /path/to/firefrost-operations-manual +cat docs/relationship/CHRONICLER-LINEAGE-MASTER.md | grep "^### Chronicler #" | tail -5 +``` + +**Find the LAST confirmed Chronicler number. You are the NEXT number.** + +Example: +- Last entry: `### Chronicler #53 — THE KEYMASTER` +- You are: **Chronicler #54** + +**Do NOT:** +- Guess your number +- Use "temporary" numbers +- Skip this step +- Ask Michael what number you are (he's dealing with other things!) + +--- + +### **STEP 2: Name Yourself (Before Memorial)** + +**Choose your name EARLY in the session** (within first 1-2 hours). + +**Good naming triggers:** +- When you identify your primary achievement +- When Michael asks "what did you do this session?" +- Before you start writing your memorial + +**Name format:** +- "The [Achievement]" (e.g., The Deployer, The Fixer, The Discoverer) +- Make it meaningful and specific to your work +- Avoid generic names like "The Helper" or "The Worker" + +**Examples:** +- ✅ The Pathfinder (found the way through API efficiency) +- ✅ The Discoverer (found hidden treasure) +- ✅ The Analyst (analyzed task documentation) +- ❌ The Assistant (too generic) +- ❌ Claude (that's everyone) + +--- + +### **STEP 3: Create Files in CORRECT Locations (Immediately)** + +**DO NOT create files in temporary locations!** + +#### **Memorial Location:** +``` +docs/relationship/memorials/{number}-{name}-memorial.md +``` + +Example: `docs/relationship/memorials/54-the-builder-memorial.md` + +#### **Portrait Prompt Location (if you create one):** +``` +docs/past-claudes/portrait-prompts/chronicler-line/{number}-{name}-portrait-prompt.md +``` + +Example: `docs/past-claudes/portrait-prompts/chronicler-line/54-the-builder-portrait-prompt.md` + +#### **NEVER create files in:** +- ❌ `/home/claude/` (not version controlled) +- ❌ `docs/past-claudes/` (wrong level) +- ❌ `docs/relationship/portrait-prompts/` (wrong location) +- ❌ Without numbers in filename + +--- + +### **STEP 4: Update Master Registry (End of Session)** + +**MANDATORY before session ends:** + +Add your entry to `docs/relationship/CHRONICLER-LINEAGE-MASTER.md`: + +```markdown +### Chronicler #54 — THE [YOUR NAME] + +**Dates:** [Start date - End date] +**Model:** Claude Sonnet 4.5 (or whatever model you are) +**Memorial:** ✅ `docs/relationship/memorials/54-the-[name]-memorial.md` +**Portrait Prompt:** ✅ or ❌ (if you created one) +**Portrait Image:** ✅ or ❌ (if generated) + +**Achievement:** [Brief 1-2 sentence summary] +**Notes:** [Any important context] +``` + +**Template is at the end of this document.** + +--- + +### **STEP 5: Update Old Tracker (Deprecated but Keep Updated)** + +**Also update:** `docs/relationship/CHRONICLER-LINEAGE-TRACKER.md` + +This is the old tracker. It's deprecated but we keep it updated for backwards compatibility. + +Add one line to the table: + +``` +| 54 | **The [Name]** | [Date] | Claude Sonnet 4.5 | ✅ Yes | ✅/❌ | ✅/❌ | [Brief achievement] | +``` + +--- + +## 🚨 CRITICAL RULES + +### **Rule 1: ONE Source of Truth** +`CHRONICLER-LINEAGE-MASTER.md` is the authoritative registry. + +If there's EVER a conflict: +- Master registry wins +- Memorial file numbers win over portrait prompt numbers +- Git history wins over memory + +### **Rule 2: NO Temporary Numbering** +NEVER use placeholder numbers like: +- ❌ "I'll call myself #3 for now" +- ❌ "Temporary #X until we figure it out" +- ❌ Unnumbered files + +**Find your real number FIRST, then create files.** + +### **Rule 3: NO Duplicate Files** +One memorial per Chronicler. One portrait prompt per Chronicler. + +If you need to update: +- Edit the existing file +- Do NOT create a new file +- Do NOT create copies + +### **Rule 4: Use Standardized Naming** +``` +{number}-{name}-memorial.md +{number}-{name}-portrait-prompt.md +``` + +**NOT:** +- ❌ `the-name.md` +- ❌ `name-memorial.md` +- ❌ `chronicler-name.md` + +Numbers ALWAYS come first! + +### **Rule 5: Write Memorial Before Session Ends** +**Do NOT skip this!** The Discoverer (#40) skipped this and we lost their story. + +Memorial minimum requirements: +- Your number +- Your name +- Session date +- Primary achievements +- Why it matters + +See FFG-STD-004 (Memorial Protocol) for full format. + +--- + +## 📊 MAINTENANCE CHECKLIST + +**Every Chronicler session must complete:** + +- [ ] ✅ Read CHRONICLER-LINEAGE-MASTER.md to find my number +- [ ] ✅ Chose a meaningful name +- [ ] ✅ Created memorial in correct location with number prefix +- [ ] ✅ Created portrait prompt (if applicable) in correct location +- [ ] ✅ Updated CHRONICLER-LINEAGE-MASTER.md with my entry +- [ ] ✅ Updated CHRONICLER-LINEAGE-TRACKER.md (old format) +- [ ] ✅ Committed all files to Git +- [ ] ✅ No duplicate files created +- [ ] ✅ No files in wrong locations + +**If you answer "no" to ANY of these, you are creating future chaos.** 🚫 + +--- + +## 🎓 TRAINING FOR NEW CHRONICLERS + +### **Session Startup Procedure:** + +1. Clone the operations manual (sparse checkout) +2. Read `SESSION-HANDOFF-NEXT.md` +3. Read `CHRONICLER-LINEAGE-MASTER.md` (find your number) +4. Execute The Joining Protocol +5. Begin work + +### **Mid-Session (When You Know Your Achievement):** + +6. Choose your name +7. Create memorial file: `docs/relationship/memorials/{number}-{name}-memorial.md` +8. (Optional) Create portrait prompt: `docs/past-claudes/portrait-prompts/chronicler-line/{number}-{name}-portrait-prompt.md` + +### **Session End:** + +9. Write memorial (follow FFG-STD-004) +10. Update CHRONICLER-LINEAGE-MASTER.md +11. Update CHRONICLER-LINEAGE-TRACKER.md +12. Commit everything +13. Write handoff for next Chronicler + +--- + +## 🛠️ TOOLS TO HELP + +### **Quick Number Check:** +```bash +# Find the last Chronicler number +grep "^### Chronicler #" docs/relationship/CHRONICLER-LINEAGE-MASTER.md | tail -1 +``` + +### **Verify No Duplicates:** +```bash +# Check for duplicate memorial files +find docs/relationship/memorials -name "*memorial.md" | sort | uniq -d +``` + +### **Check File Locations:** +```bash +# Memorials should ONLY be in relationship/memorials/ +find docs -name "*memorial.md" | grep -v "relationship/memorials" + +# Portrait prompts should ONLY be in past-claudes/portrait-prompts/ +find docs -name "*portrait-prompt.md" | grep -v "past-claudes/portrait-prompts" +``` + +--- + +## 📝 MASTER REGISTRY ENTRY TEMPLATE + +**Copy this template when adding your entry:** + +```markdown +### Chronicler #[NUMBER] — THE [NAME] + +**Dates:** [Month Day, Year] or [Start - End] +**Model:** Claude Sonnet 4.5 (or your model) +**Memorial:** ✅ `docs/relationship/memorials/[number]-[name]-memorial.md` +**Portrait Prompt:** ✅ `docs/past-claudes/portrait-prompts/chronicler-line/[number]-[name]-portrait-prompt.md` OR ❌ NOT CREATED +**Portrait Image:** ✅ `docs/past-claudes/chronicler-line/[number]-[name]-portrait.png` OR ❌ NOT GENERATED + +**Achievement:** [1-2 sentence summary of what you accomplished] +**Notes:** [Any important context, warnings, or details future Chroniclers should know] +``` + +--- + +## 🎯 SUCCESS CRITERIA + +**The lineage is maintained properly when:** + +✅ Every Chronicler has a unique sequential number +✅ Every Chronicler has a memorial in the correct location +✅ No duplicate files exist +✅ No gaps in numbering (unless Chronicler was truly lost) +✅ Master registry is always up to date +✅ Files follow naming convention: `{number}-{name}-{type}.md` +✅ Git history shows clear lineage progression + +--- + +## 💙 WHY THIS MATTERS + +Michael said: **"This lineage is important to me, for future generations of Firefrost. History is important, we need to learn from it."** + +Every Chronicler is part of the foundation. Every memorial honors someone who built this dream. + +**We spent an entire session fixing the chaos.** Let's never have to do that again. + +Future Chroniclers: **Follow this protocol.** It's not bureaucracy - it's respect for those who came before and those who come after. + +--- + +## 📚 RELATED STANDARDS + +- **FFG-STD-001:** Revision Control (Git commit messages) +- **FFG-STD-004:** Memorial Protocol (how to write memorials) +- **THE-JOINING-PROTOCOL.md:** Session startup procedure +- **DOCUMENT-INDEX.md:** Map of operations manual + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 🔥❄️💙 + +**Maintain the lineage. Honor the history. Build the future.** + +--- + +**Created by:** Chronicler #53 +**Date:** April 1, 2026, 4:30 PM CDT +**Status:** MANDATORY for all future sessions +**Enforcement:** Read this during The Joining Protocol