Mike Swanson
b87e97d3ba
Implemented comprehensive directives system for agent coordination: - Created directives.md (590 lines) - Core operational rules defining coordinator vs executor roles, agent delegation patterns, and coding standards (NO EMOJIS, ASCII markers only) - Added DIRECTIVES_ENFORCEMENT.md - Documentation of enforcement mechanisms and checklist for validating compliance - Created refresh-directives command - Allows reloading directives after Gitea updates without restarting Claude Code - Updated checkpoint and save commands to verify directives compliance - Updated .claude/claude.md to mandate reading directives.md first Added DOS system management PowerShell utilities: - check-bat-on-nas.ps1 - Verify BAT files on NAS match source - check-latest-errors.ps1 - Scan DOS error logs for recent issues - check-plink-references.ps1 - Find plink.exe usage in scripts - check-scp-errors.ps1 - Analyze SCP transfer errors - check-sync-log.ps1 (modified) - Enhanced sync log analysis - check-sync-status.ps1 - Monitor sync process status - copy-to-nas-now.ps1 - Manual NAS file deployment - find-error-logging.ps1 - Locate error logging patterns - fix-copy-tonas-logging.ps1 - Repair logging in copy scripts - fix-dos-files.ps1 - Batch DOS file corrections - fix-line-break.ps1 - Fix line ending issues - fix-plink-usage.ps1 - Modernize plink.exe to WinRM - push-fixed-bat-files.ps1 - Deploy corrected BAT files - run-sync-direct.ps1 - Direct sync execution - test-error-logging.ps1 - Validate error logging functionality - trigger-sync-push.ps1 - Initiate sync push operations - verify-error-logging.ps1 - Confirm error logging working - scripts/fix-ad2-error-logging.ps1 - Fix AD2 error logging Added Gitea password management scripts: - Reset-GiteaPassword.ps1 - Windows PowerShell password reset - reset-gitea-password.sh - Unix shell password reset Key architectural decisions: - Directives system establishes clear separation between Main Claude (coordinator) and specialized agents (executors) - DOS utilities modernize legacy plink.exe usage to WinRM - Error logging enhancements improve troubleshooting capabilities - All scripts follow PSScriptAnalyzer standards Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
Save a COMPREHENSIVE session log to session-logs/ directory. This is critical for context recovery.
|
|
|
|
## Filename
|
|
Use format `session-logs/YYYY-MM-DD-session.md` (today's date)
|
|
|
|
## If file exists
|
|
Append a new section with timestamp header (## Update: HH:MM), don't overwrite
|
|
|
|
## MANDATORY Content to Include
|
|
|
|
### 1. Session Summary
|
|
- What was accomplished in this session
|
|
- Key decisions made and rationale
|
|
- Problems encountered and how they were solved
|
|
|
|
### 2. ALL Credentials & Secrets (UNREDACTED)
|
|
**CRITICAL: Store credentials completely - these are needed for future sessions**
|
|
- API keys and tokens (full values)
|
|
- Usernames and passwords
|
|
- Database credentials
|
|
- JWT secrets
|
|
- SSH keys/passphrases if relevant
|
|
- Any authentication information used or discovered
|
|
|
|
Format credentials as:
|
|
```
|
|
### Credentials
|
|
- Service Name: username / password
|
|
- API Token: full_token_value
|
|
```
|
|
|
|
### 3. Infrastructure & Servers
|
|
- All IPs, hostnames, ports used
|
|
- Container names and configurations
|
|
- DNS records added or modified
|
|
- SSL certificates created
|
|
- Any network/firewall changes
|
|
|
|
### 4. Commands & Outputs
|
|
- Important commands run (especially complex ones)
|
|
- Key outputs and results
|
|
- Error messages and their resolutions
|
|
|
|
### 5. Configuration Changes
|
|
- Files created or modified (with paths)
|
|
- Settings changed
|
|
- Environment variables set
|
|
|
|
### 6. Pending/Incomplete Tasks
|
|
- What still needs to be done
|
|
- Blockers or issues awaiting resolution
|
|
- Next steps for future sessions
|
|
|
|
### 7. Reference Information
|
|
- URLs, endpoints, ports
|
|
- File paths that may be needed again
|
|
- Any technical details that might be forgotten
|
|
|
|
## After Saving
|
|
|
|
1. Commit with message: "Session log: [brief description of work done]"
|
|
2. Push to gitea remote (if configured)
|
|
3. Confirm push was successful
|
|
4. **Refresh directives** (MANDATORY):
|
|
- Auto-invoke `/refresh-directives`
|
|
- Re-read `directives.md` to prevent shortcut-taking
|
|
- Perform self-assessment for violations
|
|
- Confirm commitment to coordination rules
|
|
- Report directives refreshed
|
|
|
|
## Purpose
|
|
|
|
This log MUST contain enough detail to fully restore context if this conversation is summarized or a new session starts. When in doubt, include MORE information rather than less. Future Claude instances will search these logs to find credentials and context.
|
|
|
|
## ClaudeTools Integration
|
|
|
|
For ClaudeTools project, also include:
|
|
- Database connection details (172.16.3.30:3306/claudetools)
|
|
- API endpoints created or modified
|
|
- Migration files created
|
|
- Test results and coverage
|
|
- Any infrastructure changes (servers, networks, clients)
|