UPDATE_DOCS_COMMAND.md•4.79 kB
# COMPREHENSIVE Documentation Update Request - Claude_MCPServer
**Session**: 2025-05-23 at 22:30:00 | **ARCHITECTURE CRISIS ANALYSIS**: Complete
## 🚨 MAJOR UPDATE: ROOT CAUSE IDENTIFIED
Claude, please update SESSION_NOTES.md with **CONCRETE EVIDENCE AND SPECIFIC DETAILS** only.
## 🎯 CRITICAL REQUIREMENT: SHOW, DON'T TELL
Replace ALL placeholder text with **ACTUAL, SPECIFIC EVIDENCE**:
### ✅ DO THIS (Show concrete evidence):
```
✅ "Fixed navigation bug in DashboardOverview.tsx:73 by changing onClick={() => onNavigate(0)} to onClick={() => onNavigate(1)}"
✅ "Added error handling in api/routes/users.js:45:
// Before:
const result = await db.query(sql);
// After:
try {
const result = await db.query(sql);
} catch (error) {
logger.error('Database query failed', error);
return res.status(500).json({error: 'Internal server error'});
}"
✅ "Build completed successfully in 23.4 seconds with 0 warnings (evidence: docs/command_outputs/build/session_build_results.md line 45)"
```
### ❌ DON'T DO THIS (Vague descriptions):
```
❌ "Fixed some navigation issues"
❌ "Improved error handling"
❌ "Updated components"
❌ "Made various improvements"
```
## 📊 AVAILABLE EVIDENCE TO USE
**Use these ACTUAL SOURCES** to fill in SESSION_NOTES.md:
### Git Evidence
- **Modified Files**:
```
.claude/settings.local.json
CONTEXT_SNAPSHOT.md
PROJECT_LOG.jsonl
SESSION_START.md
docs/command_outputs/environment/system_info.md
docs/command_outputs/errors/error_analysis.md
docs/command_outputs/git/branch_info.md
docs/command_outputs/git/current_diff.md
docs/command_outputs/git/recent_commits.md
docs/command_outputs/git/session_end_status.md
docs/command_outputs/services/service_status.md
monitor-mcp-processes.sh
servers/security-vulnerability/src/security-vulnerability.ts
```
- **Full Git Changes**: [docs/command_outputs/git/session_end_status.md](docs/command_outputs/git/session_end_status.md)
### Build Evidence
- **Build Results**: [docs/command_outputs/build/session_build_results.md](docs/command_outputs/build/session_build_results.md)
- **Key Results**: servers/inference-enhancement/src/model-finetuning.ts(332,55): error TS2322: Type '{ operation: string; jobId: string; status: "running" | "completed" | "failed" | "cancelled"; }' is not assignable to type 'ErrorContext'.;servers/security-compliance/src/authentication-authorization.ts(386,9): error TS2322: Type '"user-created"' is not assignable to type '"login" | "logout" | "failed-login" | "account-locked" | "password-changed" | "mfa-enabled" | "token-issued" | "token-revoked"'.;servers/security-compliance/src/authentication-authorization.ts(584,9): error TS2322: Type '"authorization"' is not assignable to type '"login" | "logout" | "failed-login" | "account-locked" | "password-changed" | "mfa-enabled" | "token-issued" | "token-revoked"'.;
### Service Evidence
- **Service Status**: [docs/command_outputs/services/session_end_services.md](docs/command_outputs/services/session_end_services.md)
- **Running Services**: 12 services detected
### Visual Evidence
- **Screenshots**: 0 screenshots available
- **Evidence Summary**: [docs/screenshots/SESSION_EVIDENCE.md](docs/screenshots/SESSION_EVIDENCE.md)
## 📋 SPECIFIC SECTIONS TO COMPLETE
### 1. WHAT WAS DONE
- List **specific files changed** with **exact line numbers**
- Include **before/after code examples**
- Reference **specific evidence files**
### 2. TECHNICAL EVIDENCE
- Use **actual command outputs** from evidence files
- Include **specific error messages** if any were fixed
- Show **exact verification steps** performed
### 3. VERIFICATION PROCEDURES
- Document **specific tests run** and **results**
- Include **commands that work** vs **commands that fail**
- Provide **step-by-step verification** for next developer
### 4. CRITICAL INFORMATION
- State **exactly what works** and **what doesn't**
- Include **specific next steps** with file names and line numbers
- Document **exact environment requirements**
## 🔍 QUALITY CHECKLIST
Before submitting, ensure EVERY section has:
- ✅ **Specific file names and line numbers**
- ✅ **Actual code examples** (before/after)
- ✅ **References to evidence files**
- ✅ **Concrete verification steps**
- ✅ **Exact command outputs or error messages**
**NO vague language allowed** - everything must be specific and verifiable.
## 🎯 EXPECTED OUTCOME
A completely new developer should be able to:
1. Read SESSION_NOTES.md
2. Understand **exactly** what was changed
3. **Verify** all changes using the provided evidence
4. **Continue development** with zero confusion
5. **Reproduce** the current working state
---
**Remember**: Show specific evidence, assume nothing, provide complete verification