AndersPier/neural-nexus-claude-project
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Files
2ae786c852aacdf259111b054e094a11df766f29
neural-nexus-claude-project/workflow/emergency-recovery.md

7.9 KiB
Raw Blame History

Emergency Recovery Procedures

Context Loss Recovery

Symptoms

  • Claude doesn't remember recent project decisions
  • Having to re-explain game mechanics or architecture
  • Contradictory suggestions from previous sessions
  • Unclear about current development stage or priorities

Recovery Steps

1. Immediate Assessment

# Emergency Context Recovery Protocol

I've lost context about this project's current state. Please help me reconstruct our situation:

## 🔍 CONVERSATION ANALYSIS
**Recent History Review:**
- Analyze the last 10-15 conversation exchanges
- Identify what we were working on most recently
- Extract any recent technical decisions or changes
- Note any blockers or issues mentioned

## 📋 PROJECT STATE RECONSTRUCTION
**Current Development Status:**
- What stage are we in (Exploration/Prototype/Development/Production)?
- What's our current sprint or focus area?
- What features are completed vs in-progress vs planned?
- What's our technology stack and architecture approach?

**Recent Technical Decisions:**
- What architectural choices have we made recently?
- Are there any new patterns or approaches we've adopted?
- What trade-offs have we accepted in recent sessions?

## 📚 KNOWLEDGE BASE ASSESSMENT
**Documentation Gaps:**
- What important information isn't documented that should be?
- Are there recent decisions that need to be captured?
- What patterns or learnings should be added to our knowledge base?

## 🎯 IMMEDIATE NEXT STEPS
**Priority Clarification:**
- What should be our immediate focus for this session?
- Are there any urgent blockers to address?
- What's the most important task to complete next?

## 📝 RECOMMENDED UPDATES
**Project Configuration Updates:**
- Does our project description need updating?
- Should our custom instructions be revised?
- What knowledge base files need immediate attention?

Provide a comprehensive reconstruction to get us back on track.

2. Documentation Review

  • Check session logs in knowledge-base/development/session-logs/
  • Review recent decisions in knowledge-base/development/decision-history.md
  • Update project description if needed

3. Knowledge Base Refresh

  • Re-upload critical documents to Claude Project
  • Update project instructions with current focus
  • Archive outdated information

Technical Issues Recovery

Game Won't Load

Symptoms

  • Blank screen or error messages
  • JavaScript console errors
  • Performance issues

Recovery Steps

# 1. Check browser console
F12 -> Console tab
# Look for error messages

# 2. Revert to last working version
git log --oneline -10  # See recent commits
git checkout [last-working-commit]

# 3. Test in clean environment
# Open in incognito/private browsing
# Try different browser

# 4. Check file integrity
# Ensure index.html is complete
# Verify no corrupted files

Performance Degradation

Symptoms

  • Frame rate drops below 30fps
  • Stuttering animations
  • High memory usage
  • Unresponsive controls

Recovery Steps

// 1. Enable performance monitoring
function enableDebugMode() {
  window.gameDebug = {
    frameTime: [],
    avgFrameTime: function() {
      const avg = this.frameTime.reduce((a,b) => a+b) / this.frameTime.length;
      console.log(`Average frame time: ${avg.toFixed(2)}ms`);
      return avg;
    },
    clearFrameData: function() {
      this.frameTime = [];
    }
  };
}

// 2. Identify performance bottlenecks
// Use browser DevTools Performance tab
// Profile 5-10 seconds of gameplay
// Look for long tasks or memory leaks

// 3. Disable features systematically
// Comment out particle effects
// Reduce node count
// Simplify rendering

Repository Issues

Corrupted Git Repository

# 1. Check repository status
git status
git log --oneline -5

# 2. If corrupted, clone fresh copy
cd ..
git clone https://github.com/AndersPier/neural-nexus-game.git neural-nexus-game-backup
cd neural-nexus-game-backup

# 3. Copy work in progress
# Manually copy changes from original directory

Lost Commits

# 1. Check reflog
git reflog

# 2. Find lost commit
git show [commit-hash]

# 3. Recover if needed
git cherry-pick [commit-hash]

Development Environment Recovery

Editor/IDE Issues

# 1. Reset editor settings
# VS Code: Command Palette -> "Reload Window"
# Other editors: Close and restart

# 2. Clear editor cache
# VS Code: Remove .vscode/settings.json if corrupted

# 3. Verify file associations
# Ensure .html, .js, .css files open correctly

Browser Issues

# 1. Clear browser cache
# Chrome: Ctrl+Shift+Delete
# Firefox: Ctrl+Shift+Delete
# Safari: Develop -> Empty Caches

# 2. Disable extensions
# Test in incognito/private mode
# Disable ad blockers and dev extensions

# 3. Reset browser if needed
# Create new browser profile
# Test with different browser entirely

Project Health Recovery

Architecture Drift

Symptoms

  • Code doesn't follow established patterns
  • Inconsistent naming conventions
  • Technical debt accumulating
  • Features not integrating well

Recovery Process

# Architecture Drift Analysis and Recovery

Our current implementation seems to have drifted from our original architectural intentions. Please help analyze and resolve this:

## 🏗️ CURRENT STATE ANALYSIS
**Implementation Reality:**
- Document how our current code is actually structured
- Identify the patterns we're actually using (not what we planned)
- Note any informal conventions that have emerged
- Assess the current data flow and component relationships

**Deviation Assessment:**
- Compare current implementation with our documented architecture
- Identify specific areas where we've diverged from the plan
- Analyze when and why these deviations occurred
- Determine if deviations were conscious decisions or gradual drift

## ⚖️ DRIFT EVALUATION
**Beneficial Drift (Should Embrace):**
- Which deviations have actually improved our architecture?
- What patterns emerged organically that work better than planned?
- Are there performance or maintainability improvements from drift?

**Harmful Drift (Should Correct):**
- Which deviations are causing problems or technical debt?
- What inconsistencies make the codebase harder to maintain?
- Are there security or performance regressions from drift?

## 🎯 RESOLUTION STRATEGY
**Immediate Actions (This Sprint):**
1. [Action] - [Rationale] - [Effort estimate]

**Short-term Alignment (Next 2-4 weeks):**
1. [Action] - [Rationale] - [Effort estimate]

**Long-term Architecture Evolution:**
1. [Action] - [Rationale] - [Effort estimate]

Provide specific, actionable recommendations for resolving architecture uncertainty.

Prevention Strategies

Daily Habits

  • Always complete session end consolidation
  • Commit changes frequently with clear messages
  • Test on multiple devices regularly
  • Document architectural decisions immediately

Weekly Reviews

  • Assess project health honestly
  • Update documentation and knowledge base
  • Plan upcoming work clearly
  • Archive completed work

Monthly Audits

  • Review codebase for consistency
  • Assess technical debt levels
  • Update development workflows
  • Validate architectural decisions

Emergency Contacts

Technical Resources

Community Support

  • Stack Overflow: For specific technical issues
  • GitHub Discussions: For project-specific questions
  • Discord/Reddit: Game development communities

Backup Plans

  • Repository Backup: Always maintain local and cloud copies
  • Documentation Backup: Export knowledge base regularly
  • Contact Lists: Maintain list of helpful community members

Remember: Most "emergencies" can be prevented with good daily habits. When they do occur, stay calm and work through recovery procedures systematically.