claudetools/.claude/commands/save.md

Save a COMPREHENSIVE session log to appropriate session-logs/ directory. This is critical for context recovery.

Determine Correct Location

IMPORTANT: Save to project-specific or general session-logs based on work context

Project-Specific Logs

If working on a specific project, save to project folder:

• Dataforth DOS work → projects/dataforth-dos/session-logs/YYYY-MM-DD-session.md
• ClaudeTools API work → projects/claudetools-api/session-logs/YYYY-MM-DD-session.md
• Client-specific work → clients/[client-name]/session-logs/YYYY-MM-DD-session.md

General/Mixed Work

If working across multiple projects or general tasks:

• Use root session-logs/YYYY-MM-DD-session.md

Filename

Use format YYYY-MM-DD-session.md (today's date) in appropriate folder

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.

Project-Specific Requirements

Dataforth DOS Project

Save to: projects/dataforth-dos/session-logs/ Include:

• DOS batch file changes and versions
• Deployment script updates
• Infrastructure changes (AD2, D2TESTNAS)
• Test results from TS-XX machines
• Documentation files created

ClaudeTools API Project

Save to: projects/claudetools-api/session-logs/ 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)

Client Work

Save to: clients/[client-name]/session-logs/ Include:

• Issues resolved
• Services provided
• Support tickets/cases
• Client-specific infrastructure changes