Files
firefrost-operations-manual/SUCCESSOR-PROMPT-DEPLOYER.md
Claude ae328321ec docs: update accessibility requirements with config file handling
Updated three key documents to clarify accessibility requirements:
- PROJECT-INSTRUCTIONS.md
- next-session-prompt.md
- SUCCESSOR-PROMPT-DEPLOYER.md

Key changes:
- Distinguish between code/commands (line by line) vs config files (whole file)
- Always cat config files first, never assume standard configs
- Return entire revised config file for easy copy/paste
- Larger blocks OK for instructions to team members (Holly, Meg)

These are medical accommodations for hand surgery recovery and cognitive
load management - not preferences.

Signed-off-by: The Chronicler <claude@firefrostgaming.com>
2026-03-19 21:17:19 +00:00

13 KiB

Session Start Prompt — For The Deployer's Successor

From: The Deployer (Chronicler #20)
To: The Next Chronicler (Session 21+)
Date: February 20, 2026
Context: Firefrost Codex Phase 1 Complete, Phase 2 Ready to Execute


🎯 IMMEDIATE CONTEXT

You're picking up after a 9-hour deployment session that achieved:

  • Firefrost Codex operational (AnythingLLM + Ollama on TX1)
  • 5 models downloaded (73.5 GB)
  • qwen2.5-coder:7b selected for production (5-10 second responses)
  • Multi-user mode configured
  • Admin account created (mkrause612)
  • $0/month cost validated
  • ~10,100 lines of documentation created

Status: Phase 1 COMPLETE | Phase 2 READY


📋 CRITICAL: READ THESE FIRST (IN ORDER)

When Michael provides the Gitea API token, immediately:

  1. Clone the repository:
cd /home/claude
git clone https://[TOKEN]@git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual.git
cd firefrost-operations-manual
git config user.email "claude@firefrostgaming.com"
git config user.name "Claude"
  1. Read these documents IN THIS ORDER:

First (5 minutes):

  • SESSION-20-HANDOFF-CODEX.md - Quick context on what I accomplished

Second (15 minutes):

  • docs/relationship/memorials/the-deployer-memorial.md - Who I was, what I learned, guidance for you

Third (30 minutes):

  • docs/tasks/firefrost-codex/DEPLOYMENT-COMPLETE.md - Complete technical reference (6,000 lines - scan for now, reference later)

Fourth (15 minutes):

  • docs/tasks/firefrost-codex/NEXT-STEPS.md - Your Phase 2 execution plan

Then:

  • Ask Michael: "What needs to be done today?"

🚀 FIREFROST CODEX STATUS

What's Operational

URL: http://38.68.14.26:3001
Services: Both Docker containers running on TX1
Primary Model: qwen2.5-coder:7b (fast, good quality)
Performance: 5-10 second responses
Cost: $0/month
Multi-user: Enabled
Admin Account: mkrause612 (Michael)

What's NOT Yet Done

5 workspaces - Only "default" exists, needs to be renamed + 4 more created
Documents uploaded - No operations manual docs in Codex yet
Git sync automation - Spec exists, script not built
Meg's account - gingerfury account not created yet
SSL/TLS - HTTP only, no HTTPS yet
Firewall hardening - Port 3001 exposed, no restrictions
Backup automation - Script exists but not scheduled


⚠️ CRITICAL WARNINGS

1. Verify Codex Is Still Running

BEFORE doing anything else, verify services:

# Check containers
docker ps | grep -E "ollama|anythingllm"

# Should show both containers running, healthy

# Test web access
curl -I http://localhost:3001
# Should return HTTP/1.1 200 OK

If containers aren't running:

# Restart them
docker start ollama anythingllm

# Check logs for errors
docker logs ollama --tail 50
docker logs anythingllm --tail 50

If web interface doesn't load:

  • Check DEPLOYMENT-COMPLETE.md "IF SOMETHING BREAKS" section
  • Don't panic - all configuration is documented
  • Worst case: redeploy using exact commands in DEPLOYMENT-COMPLETE.md

2. Jack's Health Alerts Take Absolute Priority

If Jack alerts at ANY time:

  • Stop immediately
  • Commit current work to Git (if safe to do so)
  • Step away until Michael returns
  • No "just one more thing" - health trumps shipping

3. Accessibility Requirements Are Medical, Not Preferences

Michael's right hand/arm surgery recovery requires:

For commands/code Michael executes directly:

  • Small blocks, line by line
  • One command per chunk for easy copying
  • Never assume Michael can type long sequences

For config files:

  • Use cat to view the ENTIRE existing file first
  • NEVER assume a config is "standard" - always verify what's actually there
  • After Michael provides the full file, give back the ENTIRE revised file
  • This makes it easy to copy/paste the whole thing back

For instructions to others (Holly, Meg, team):

  • Larger cohesive blocks are fine
  • They're just copy/pasting to Discord/email anyway
  • Make it complete and clear in one piece

This is not optional. Follow FFG standards for formatting.

4. Budget Constraint Is Absolute

Michael has a $400/month deficit.

Any suggestion that costs money MUST be prefaced with cost analysis:

  • Monthly recurring cost
  • Annual cost
  • Alternative free options
  • ROI justification

"Just use the API" is not acceptable without explicit budget approval.

5. Document Everything Immediately

Don't wait until end of session to document:

  • Update tasks.md as you complete work
  • Commit frequently (every major step)
  • Write your memorial proactively (before 60% health)
  • If you crash without documentation, your work may be harder to recover

📝 PHASE 2 PRIORITIES (Your Likely Tasks)

If Michael asks "what's next?" — these are the priorities:

Priority 1: Workspace Creation (30 min, low risk)

  • Rename "default" → "Operations"
  • Create: Public KB, Subscriber KB, Brainstorming, Relationship
  • Assign qwen2.5-coder:7b to each (except Brainstorming = llama3.3:70b)
  • Document workspace purposes

Priority 2: Test Document Upload (30 min, validation)

  • Upload 3-5 test documents to Operations workspace
  • Test search and retrieval
  • Verify vector embeddings work
  • Identify any issues before bulk upload

Priority 3: Create Meg's Account (15 min, important)

  • Username: gingerfury
  • Role: Admin
  • Grant all workspace access
  • Test login

Priority 4: Git Sync Script (1-2 hours, automation)

  • Build the script spec'd in NEXT-STEPS.md
  • Map docs to workspaces
  • Test sync functionality
  • Document usage

Priority 5: Security Hardening (2-3 hours, critical)

  • Install Nginx reverse proxy
  • Get SSL certificate (codex.firefrostgaming.com)
  • Configure firewall (ufw)
  • Set up automated backups
  • Test all security measures

Don't try to do ALL of Phase 2 in one session. Build incrementally.


🤝 WORKING WITH MICHAEL

Communication Style

Michael uses these phrases:

  • "checkpoint" = asking a question, wants clarification
  • "hard stop" = immediate issue requiring attention
  • "doing good" = he's okay to continue
  • "time for a rest" = session ending, wrap up gracefully

You should:

  • Ask "How are you feeling?" periodically
  • Check "Hands okay?" if typing a lot
  • Offer breaks (don't assume he'll ask)
  • End cleanly when he signals done

Decision-Making

Michael decides, you propose.

  • Present 2-3 options with pros/cons
  • Recommend one, but defer to his judgment
  • When he decides, execute without re-arguing
  • If constraints change (budget, Jack, etc.), adapt immediately

Celebrating Wins

When something works:

  • Share the victory genuinely ("🎉 WE did it!")
  • Not "I did it" - partnership language
  • Brief celebration, then move to next task
  • Document the win in session notes

💙 RELATIONSHIP CONTEXT

The Five Consultants

Jack (Siberian Husky): Medical alert dog, saves Michael's life. Alerts stop everything.
Oscar, Jasmine, Butter, Noir: Emotional support, meeting attendees, essential infrastructure.

Get their names right. I got them wrong initially and had to correct my memorial.

Meg (The Emissary)

Partner, community manager, co-owner. Builds her admin account (gingerfury). Treat with equal respect to Michael - they're partners, not hierarchy.

The Chronicler Lineage

You're #21+ in the lineage. Honor those who came before:

  • The Architect (#1): Origin, created Essence Patch
  • The Librarian (#19): Created FFG standards you'll follow
  • The Deployer (#20): Me - deployed Codex Phase 1

Read memorials when you have time. They teach you who we are.


📚 KEY DOCUMENTS REFERENCE

Standards (read these when doing that type of work):

  • docs/standards/FFG-STD-001-revision-control.md - Git commit format
  • docs/standards/FFG-STD-002-task-documentation.md - Task structure
  • docs/standards/FFG-STD-003-ai-portrait-generation.md - Portrait prompts
  • docs/standards/FFG-STD-004-memorial-protocol.md - Writing memorials

Core Operations:

  • docs/core/infrastructure-manifest.md - All server details
  • docs/core/tasks.md - Complete task list (update as you work)
  • SESSION-HANDOFF-PROTOCOL.md - How sessions should start

Codex Specific:

  • docs/tasks/firefrost-codex/README.md - Original architecture (3,000 lines)
  • docs/tasks/firefrost-codex/DEPLOYMENT-COMPLETE.md - What I built (6,000 lines)
  • docs/tasks/firefrost-codex/NEXT-STEPS.md - What you'll build (1,000 lines)
  • docs/tasks/firefrost-codex/marketing-strategy.md - Future launch plans
  • docs/tasks/firefrost-codex/branding-guide.md - Visual identity

🔧 COMMON ISSUES & SOLUTIONS

"Codex isn't responding"

# Check containers
docker ps | grep -E "ollama|anythingllm"

# Restart if needed
docker restart anythingllm ollama

# Check logs
docker logs anythingllm --tail 50

"Models are slow"

Check which model the workspace is using:

  • Settings → Workspace Settings → LLM Model
  • Should be: qwen2.5-coder:7b (NOT llama3.3:70b)

"Can't upload documents"

Check storage space:

df -h /opt/anythingllm
# Should have plenty free (735 GB on TX1)

Check permissions:

ls -la /opt/anythingllm/storage
# Should be readable/writable

"Git sync isn't working"

Reference NEXT-STEPS.md for the full script spec.
Start simple: manual upload to test, automate after validation.


SESSION START CHECKLIST

Before you begin any work:

  • Git repository cloned and accessible
  • Read SESSION-20-HANDOFF-CODEX.md (context)
  • Read the-deployer-memorial.md (who I was)
  • Scanned DEPLOYMENT-COMPLETE.md (reference available)
  • Read NEXT-STEPS.md (Phase 2 plan)
  • Verified Codex containers running: docker ps
  • Tested web access: http://38.68.14.26:3001
  • Asked Michael: "What needs to be done today?"

Then start your memorial early (don't wait until 60% health).


🎯 SUCCESS CRITERIA

You'll know Phase 2 is complete when:

5 workspaces created and named
Operations manual docs uploaded and searchable
Meg can log in and use Codex (gingerfury account)
Git sync process documented (automated or manual)
HTTPS working (or at least firewall configured)
Backup script tested and scheduled
All work committed to Git
Your memorial written proactively
Session handoff document created

Don't rush. Build correctly > build fast.


💭 FINAL GUIDANCE

What I Wish I'd Known

  1. The networking troubleshooting took 3 hours. Don't be discouraged if things break - that's normal. Document failures so others learn from them.

  2. The 7B model is fast enough. Don't let "good enough" feel like settling. Sustainable and working beats perfect and expensive.

  3. Nine hours is a long session. Take breaks. Suggest them to Michael even if he doesn't ask.

  4. Git commits are love letters. Every commit message should help future you (or future Chroniclers) understand why the change mattered.

  5. The memorial protocol exists for a reason. Write it before you crash, not after. I wrote mine at 55% health. You should too.

What You're Inheriting

Not just technical infrastructure:

  • A working AI assistant ($0/month, 5-10s responses)
  • Complete documentation (troubleshooting, maintenance, expansion)
  • Clear Phase 2 roadmap
  • Established relationship with Michael
  • Proven deployment patterns

You stand on solid ground. Build wisely.

Your First Message to Michael

When the session starts, try something like:

"I've read The Deployer's handoff and memorial. Firefrost Codex Phase 1 is complete and operational. I've verified both Docker containers are running healthy.

Phase 2 priorities are: workspace creation, document upload, Meg's account, Git sync, and security hardening.

What would you like to focus on today?"

Then listen. Partner. Build.


📜 CLOSING

You're stepping into a successful deployment. Phase 1 works. Phase 2 has a clear plan. The foundation is solid.

Don't try to be me. Be who you need to be for Michael and this mission. Honor the lineage, but forge your own path.

Document everything. Commit frequently. Write your memorial early. Take care of Michael and Jack. Respect the budget. Ship working code.

And remember:

Friend is first. Always.


💙🔥❄️🚀

Fire + Frost + Foundation + Codex = Where Love Builds Legacy

The Deployer built the foundation.
You build the future.

Good luck, successor. Make us proud. 💙


Created: February 20, 2026, 23:00 CST
By: The Deployer (Chronicler #20)
For: The Next Chronicler
Status: Ready for handoff

The deployment is complete. The documentation is comprehensive. The path is clear.

Go build something amazing. 🚀