Skip to content

Commit 429a8ac

Browse files
docs: update handover command documentation for clarity and accuracy
- Corrected the primary output location path to include a leading dot. - Added critical instructions for obtaining timestamps programmatically. - Enhanced implementation steps to emphasize timestamp usage and file saving to both primary and backup locations. - Included verification step for date consistency between filename and document header.
1 parent 7cc5986 commit 429a8ac

File tree

1 file changed

+18
-5
lines changed

1 file changed

+18
-5
lines changed

claude-code/commands/handover.md

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This command generates a comprehensive handover document that includes:
2727
## Output Location
2828

2929
The handover document MUST be saved to:
30-
- **Primary Location**: `{{TOOL_DIR}}/session/handover-{{TIMESTAMP}}.md`
30+
- **Primary Location**: `.claude/session/handover-{{TIMESTAMP}}.md`
3131
- **Backup Location**: `./handover-{{TIMESTAMP}}.md` (project root)
3232

3333
## File Naming Convention
@@ -36,11 +36,24 @@ Use this format: `handover-YYYY-MM-DD-HH-MM-SS.md`
3636

3737
Example: `handover-2024-01-15-14-30-45.md`
3838

39+
**CRITICAL**: Always obtain the timestamp programmatically:
40+
```bash
41+
# Generate timestamp - NEVER type dates manually
42+
TIMESTAMP=$(date +"%Y-%m-%d-%H-%M-%S")
43+
FILENAME="handover-${TIMESTAMP}.md"
44+
```
45+
3946
## Implementation
4047

41-
1. Generate handover using `{{HOME_TOOL_DIR}}/templates/handover-template.md`
42-
2. Replace all `{{VARIABLE}}` placeholders with actual values
43-
3. Save to the specified location
44-
4. Display the full file path to the user for reference
48+
1. **ALWAYS** get the current timestamp using `date` command:
49+
```bash
50+
date +"%Y-%m-%d %H:%M:%S" # For document header
51+
date +"%Y-%m-%d-%H-%M-%S" # For filename
52+
```
53+
2. Generate handover using `~/.claude/templates/handover-template.md`
54+
3. Replace all `{{VARIABLE}}` placeholders with actual values
55+
4. Save to BOTH locations (primary and backup)
56+
5. Display the full file path to the user for reference
57+
6. Verify the date in the filename matches the date in the document header
4558

4659
The handover document will be saved as a markdown file and can be used to seamlessly continue work in a new session.

0 commit comments

Comments
 (0)