claudetools/.claude/commands/save.md at ffef5bdf8f8410434c5da4cbfc6a34a538dfbf70

Files

Mike Swanson b87e97d3ba feat: Add directives system and DOS management utilities

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>

2026-01-19 15:52:28 -07:00

2.5 KiB

Raw Blame History

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

Commit with message: "Session log: [brief description of work done]"
Push to gitea remote (if configured)
Confirm push was successful
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)

2.5 KiB Raw Blame History