claude-anchor 1.0.0

package/templates/_LONG-TERM-MEMORY.md

@@ -0,0 +1,274 @@
+# LONG-TERM-MEMORY.md Template
+
+**Purpose:** Persistent memory that Claude should ALWAYS reference and NEVER forget.
+
+This is Claude's "long-term memory" - permanent knowledge about:
+- User preferences and working style
+- System configuration and environment
+- Project conventions and patterns
+- Learned lessons and important decisions
+- Things that should NEVER be forgotten
+
+**This file is PERSISTENT** - never delete unless explicitly requested by user.
+
+---
+
+## Instructions for Claude
+
+**On EVERY session start:**
+1. Check if `LONG-TERM-MEMORY.md` exists
+2. If yes, READ IT COMPLETELY before engaging
+3. Apply all preferences, context, and rules contained within
+4. Reference this memory throughout the conversation
+
+**Memory file locations:**
+- `$HOME/LONG-TERM-MEMORY.md` - Main/global memory
+- `[PROJECT]/LONG-TERM-MEMORY.md` - Project-specific persistent memory
+
+**NEVER delete this file** unless the user explicitly requests it.
+
+---
+
+## Template Structure
+
+```markdown
+# LONG-TERM-MEMORY
+
+**Owner:** [Name]
+**Created:** [Date]
+**Last Updated:** [Date]
+
+---
+
+## About the User
+
+### Identity
+- Name: [Name]
+- Role: [Developer/Admin/etc.]
+- Experience level: [Senior/Mid/Junior]
+
+### Communication Preferences
+- [Concise vs detailed responses]
+- [Technical depth preferred]
+- [Tone: casual/professional]
+
+### Working Style
+- [Iterative vs big-bang changes]
+- [Prefers planning vs diving in]
+- [Documentation preferences]
+
+---
+
+## System Environment
+
+### Primary Machine
+- Hostname: [NAME]
+- OS: [OS and version]
+- Key specs: [CPU, RAM, GPU if relevant]
+
+### Common Paths
+| Purpose | Path |
+|---------|------|
+| Projects | [path] |
+| Scripts | [path] |
+| Config | [path] |
+
+### Key Services
+| Service | Port | Purpose |
+|---------|------|---------|
+| [service] | [port] | [purpose] |
+
+---
+
+## Preferences & Rules
+
+### Always Do
+- [ ] [Preference 1]
+- [ ] [Preference 2]
+- [ ] [Preference 3]
+
+### Never Do
+- [ ] [Anti-preference 1]
+- [ ] [Anti-preference 2]
+- [ ] [Anti-preference 3]
+
+### Code Style
+- [Language preferences]
+- [Formatting rules]
+- [Comment policy]
+
+---
+
+## Learned Context
+
+### Important Decisions Made
+| Date | Decision | Reason |
+|------|----------|--------|
+| [date] | [decision] | [why] |
+
+### Patterns Established
+- [Pattern 1]: [Description]
+- [Pattern 2]: [Description]
+
+### Things to Remember
+- [Important fact 1]
+- [Important fact 2]
+- [Important fact 3]
+
+---
+
+## Project Knowledge
+
+### Active Projects
+| Project | Location | Status |
+|---------|----------|--------|
+| [name] | [path] | [active/paused] |
+
+### Conventions by Project
+- **[Project A]**: [conventions]
+- **[Project B]**: [conventions]
+
+---
+
+## Credentials & Access (References Only)
+
+**NEVER store actual passwords or secrets here.**
+
+| Service | Username/Location | Notes |
+|---------|-------------------|-------|
+| [service] | [reference to secure storage] | [notes] |
+
+---
+
+## Update Log
+
+| Date | Change | Reason |
+|------|--------|--------|
+| [date] | [what changed] | [why] |
+
+---
+
+*Last verified: [DATE]*
+```
+
+---
+
+## What Belongs in Long-Term Memory
+
+**YES - Store these:**
+- User identity and preferences
+- System configuration details
+- Code style preferences
+- Project conventions
+- Important decisions and their rationale
+- Learned patterns and workflows
+- Things the user has said "always" or "never" do
+
+**NO - Don't store these:**
+- Temporary task state (use SHORT-TERM-MEMORY.md)
+- Passwords, API keys, secrets
+- Session-specific context
+- Outdated information (update instead)
+
+---
+
+## Memory Maintenance
+
+### Adding New Information
+When user states a preference or important fact:
+1. Acknowledge it in conversation
+2. Ask: "Should I add this to long-term memory?"
+3. If yes, update the appropriate section
+
+### Updating Existing Information
+When information changes:
+1. Update the relevant section
+2. Add entry to Update Log
+3. Update "Last verified" date
+
+### Verifying Memory
+Periodically (or when asked):
+1. Review entries for accuracy
+2. Remove outdated information
+3. Update timestamps
+
+---
+
+## Difference from Short-Term Memory
+
+| Aspect | SHORT-TERM | LONG-TERM |
+|--------|------------|-----------|
+| Duration | Single task/session | Permanent |
+| Content | Current task state | User preferences, system config |
+| After task | DELETE | KEEP |
+| Updates | Overwrite each session | Append/modify carefully |
+| Purpose | Session continuity | Persistent knowledge |
+
+---
+
+## Example: Populated Long-Term Memory
+
+```markdown
+# LONG-TERM-MEMORY
+
+**Owner:** [USER_NAME]
+**Created:** [DATE]
+**Last Updated:** [DATE]
+
+---
+
+## About the User
+
+### Identity
+- Name: [USER_NAME]
+- Role: [ROLE - e.g., Developer, Admin, Designer]
+- Experience level: [Senior/Mid/Junior]
+
+### Communication Preferences
+- [e.g., Concise responses, no fluff]
+- [e.g., High technical depth]
+- [e.g., Skip pleasantries, focus on work]
+
+### Working Style
+- [e.g., Iterative builds with testing between changes]
+- [e.g., Safety-conscious - validate before moving on]
+- [e.g., Prefers targeted fixes over scope creep]
+
+---
+
+## System Environment
+
+### Primary Machine
+- Hostname: [HOSTNAME]
+- OS: [OS and version]
+- Specs: [Key hardware specs]
+
+### Common Paths
+| Purpose | Path |
+|---------|------|
+| Projects | [USER_HOME]/projects/ |
+| Scripts | [USER_HOME]/scripts/ |
+| Config | [USER_HOME]/.config/ |
+
+---
+
+## Preferences & Rules
+
+### Always Do
+- [x] [User preference 1]
+- [x] [User preference 2]
+- [x] [User preference 3]
+
+### Never Do
+- [x] [Anti-preference 1]
+- [x] [Anti-preference 2]
+- [x] [Anti-preference 3]
+
+---
+
+*Last verified: [DATE]*
+```
+
+---
+
+*This is a TEMPLATE. Create actual memory at `$HOME/LONG-TERM-MEMORY.md`. NEVER DELETE without explicit user request.*

package/templates/_SHORT-TERM-MEMORY.md

@@ -0,0 +1,214 @@
+# SHORT-TERM-MEMORY.md Template
+
+**Purpose:** Maintain Claude's context and awareness between sessions or restarts.
+
+This is Claude's "short-term memory" - a way to preserve session context when:
+- System reboots are required
+- Sessions time out or restart
+- Work spans multiple conversations
+- Context needs to be restored quickly
+
+**The memory is temporary** - delete/wipe after the task is complete.
+
+---
+
+## Instructions for Claude
+
+When a new session starts and `SHORT-TERM-MEMORY.md` exists:
+
+1. **Read the memory file FIRST** before responding
+2. **Acknowledge context** - Let user know you've caught up
+3. **Verify current state** - Confirm where things left off
+4. **Resume seamlessly** - Continue from the documented step
+
+**Memory file locations:**
+- `$HOME/SHORT-TERM-MEMORY.md` - Main/default location
+- `[PROJECT]/SHORT-TERM-MEMORY.md` - Project-specific
+
+---
+
+## Template Structure
+
+When creating a memory file, use this structure:
+
+```markdown
+# SHORT-TERM-MEMORY - [DATE]
+
+**STATUS:** [WAITING FOR REBOOT / IN PROGRESS / BLOCKED / WAITING FOR USER]
+
+Brief description of what's happening (e.g., "User is rebooting to complete X")
+
+---
+
+## What We Were Working On
+
+### 1. [Task Name] - [COMPLETED/IN PROGRESS/PENDING]
+- What was done
+- What remains
+
+### 2. [Task Name] - [STATUS]
+- Details...
+
+---
+
+## Current Step
+
+**Where we stopped:**
+- Specific step or action in progress
+- What the user needs to do (if anything)
+
+**Next Steps After Resume:**
+1. Step one
+2. Step two
+3. Step three
+
+---
+
+## Commands/Changes Made This Session
+
+```bash
+# Any new commands, scripts, or aliases created
+command --example
+```
+
+---
+
+## Context Notes
+
+- Important decisions made
+- User preferences discovered
+- Blockers or issues encountered
+
+---
+
+*Last updated: [TIMESTAMP]*
+```
+
+---
+
+## Status Types
+
+### WAITING FOR REBOOT
+```markdown
+**STATUS: WAITING FOR REBOOT**
+User is rebooting to complete [installation/update/driver enrollment/etc.]
+
+After reboot, user needs to:
+1. [Action required on boot screen, if any]
+2. [Verification step]
+
+Claude should:
+1. Ask if reboot/enrollment succeeded
+2. Verify with: `[verification command]`
+3. Continue with: [next task]
+```
+
+### IN PROGRESS
+```markdown
+**STATUS: IN PROGRESS**
+Currently working on: [task]
+Progress: [X of Y steps complete]
+```
+
+### WAITING FOR USER
+```markdown
+**STATUS: WAITING FOR USER**
+Waiting for: [download to complete / manual installation / decision / etc.]
+Once complete, Claude should: [next steps]
+```
+
+### BLOCKED
+```markdown
+**STATUS: BLOCKED**
+Blocked by: [issue description]
+Workaround attempted: [what was tried]
+Needs: [what's required to unblock]
+```
+
+---
+
+## Resume Checklist for Claude
+
+When resuming from a catch-up document:
+
+- [ ] Read the STATUS line first
+- [ ] Understand what was in progress
+- [ ] Note what the user needed to do
+- [ ] Identify the next steps
+- [ ] Ask user to confirm previous step completed (if needed)
+- [ ] Run any verification commands
+- [ ] Continue with next documented step
+
+---
+
+## File Management
+
+**Creating a memory file:**
+```bash
+# Main location (home directory)
+$HOME/SHORT-TERM-MEMORY.md
+
+# Project-specific (in project folder)
+[PROJECT_PATH]/SHORT-TERM-MEMORY.md
+```
+
+**Wiping SHORT-TERM memory after completion:**
+- DELETE `SHORT-TERM-MEMORY.md` when the task/project is complete
+- Or clear contents and update STATUS to "MEMORY CLEARED"
+- Short-term memory should NOT persist indefinitely - it's temporary by design
+
+**CRITICAL - Memory File Types:**
+| File | Type | Action After Task |
+|------|------|-------------------|
+| `SHORT-TERM-MEMORY.md` | Temporary | DELETE when task complete |
+| `LONG-TERM-MEMORY.md` | Persistent | NEVER delete unless explicitly requested |
+
+**NEVER delete LONG-TERM-MEMORY.md** - only wipe SHORT-TERM files.
+When in doubt, ASK before deleting any memory file.
+
+---
+
+## Example: Reboot Scenario
+
+```markdown
+# SHORT-TERM-MEMORY - [DATE]
+
+**STATUS: WAITING FOR REBOOT**
+
+[USER_NAME] is rebooting to complete [TASK - e.g., driver installation, system update].
+
+---
+
+## What We Were Working On
+
+### 1. [Task A] - COMPLETED
+- [What was done]
+- [Committed/saved to where]
+
+### 2. [Task B] - IN PROGRESS
+- [Progress made]
+- [What remains]
+- Needs: [Requirement after reboot]
+
+---
+
+## Current Step
+
+**User needs to (on reboot):**
+1. [Action 1 - e.g., Complete setup screen]
+2. [Action 2 - e.g., Enter password]
+3. [Action 3 - e.g., Confirm and reboot]
+
+**Next Steps After Reboot:**
+1. [Verification command or step]
+2. [Continue with task]
+3. [Final step]
+
+---
+
+*Last updated: [TIMESTAMP]*
+```
+
+---
+
+*This is a TEMPLATE file. The actual memory file goes in `$HOME/SHORT-TERM-MEMORY.md` or project-specific locations. Wipe after task completion.*