docs: Remove database save from checkpoint command
Removed deprecated database context save functionality from /checkpoint: - Deleted Part 2: Database Context Save section - Removed API endpoint, JWT auth, and payload examples - Updated description to focus on git operations only - Simplified verification to git commit only - Kept directives refresh requirement Checkpoint command now handles git commits exclusively. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,8 +1,8 @@
|
|||||||
---
|
---
|
||||||
description: Create commit with detailed comment and save session context to database
|
description: Create detailed git commit with comprehensive commit message
|
||||||
---
|
---
|
||||||
|
|
||||||
Please create a comprehensive checkpoint that captures BOTH git changes AND session context with the following steps:
|
Please create a comprehensive git checkpoint with the following steps:
|
||||||
|
|
||||||
## Part 1: Git Checkpoint
|
## Part 1: Git Checkpoint
|
||||||
|
|
||||||
@@ -34,146 +34,29 @@ Please create a comprehensive checkpoint that captures BOTH git changes AND sess
|
|||||||
|
|
||||||
5. **Execute the commit**: Create the commit with the properly formatted message following this repository's conventions.
|
5. **Execute the commit**: Create the commit with the properly formatted message following this repository's conventions.
|
||||||
|
|
||||||
## Part 2: Database Context Save
|
## Part 2: Verify Git Checkpoint
|
||||||
|
|
||||||
6. **Save session context to database**:
|
6. **Verify commit**:
|
||||||
|
- Confirm git commit succeeded by running `git log -1`
|
||||||
|
- Report commit status to user
|
||||||
|
|
||||||
After the commit is complete, save the session context to the ClaudeTools database for cross-machine recall.
|
## Part 3: Refresh Directives (MANDATORY)
|
||||||
|
|
||||||
**API Endpoint**: `POST http://172.16.3.30:8001/api/conversation-contexts`
|
7. **Refresh directives** (MANDATORY):
|
||||||
|
|
||||||
**Payload Structure**:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"project_id": "<project-uuid>",
|
|
||||||
"context_type": "checkpoint",
|
|
||||||
"title": "Checkpoint: <commit-summary>",
|
|
||||||
"dense_summary": "<comprehensive-session-summary>",
|
|
||||||
"relevance_score": 8.0,
|
|
||||||
"tags": ["<extracted-tags>"],
|
|
||||||
"metadata": {
|
|
||||||
"git_commit": "<commit-hash>",
|
|
||||||
"git_branch": "<branch-name>",
|
|
||||||
"files_changed": ["<file-list>"],
|
|
||||||
"commit_message": "<full-commit-message>"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Authentication**: Use JWT token from `.claude/context-recall-config.env`
|
|
||||||
|
|
||||||
**How to construct the payload**:
|
|
||||||
|
|
||||||
a. **Project ID**: Get from git config or environment
|
|
||||||
```bash
|
|
||||||
PROJECT_ID=$(git config --local claude.projectid 2>/dev/null)
|
|
||||||
```
|
|
||||||
|
|
||||||
b. **Title**: Use commit summary line
|
|
||||||
```
|
|
||||||
"Checkpoint: feat: Add Sequential Thinking to Code Review Agent"
|
|
||||||
```
|
|
||||||
|
|
||||||
c. **Dense Summary**: Create compressed summary including:
|
|
||||||
- What was accomplished (from commit message body)
|
|
||||||
- Key files modified (from git diff --name-only)
|
|
||||||
- Important decisions or technical details
|
|
||||||
- Context for future sessions
|
|
||||||
|
|
||||||
Example:
|
|
||||||
```
|
|
||||||
Enhanced code-review.md with Sequential Thinking MCP integration.
|
|
||||||
|
|
||||||
Changes:
|
|
||||||
- Added trigger conditions for 2+ rejections and 3+ critical issues
|
|
||||||
- Created enhanced escalation format with root cause analysis
|
|
||||||
- Added UI_VALIDATION_CHECKLIST.md (462 lines)
|
|
||||||
- Updated frontend-design skill for automatic invocation
|
|
||||||
|
|
||||||
Files: .claude/agents/code-review.md, .claude/skills/frontend-design/SKILL.md,
|
|
||||||
.claude/skills/frontend-design/UI_VALIDATION_CHECKLIST.md
|
|
||||||
|
|
||||||
Decision: Use Sequential Thinking MCP for complex review issues to break
|
|
||||||
rejection cycles and provide comprehensive feedback.
|
|
||||||
|
|
||||||
Commit: a1b2c3d on branch main
|
|
||||||
```
|
|
||||||
|
|
||||||
d. **Tags**: Extract relevant tags from context (4-8 tags)
|
|
||||||
```json
|
|
||||||
["code-review", "sequential-thinking", "frontend-validation", "ui", "documentation"]
|
|
||||||
```
|
|
||||||
|
|
||||||
e. **Metadata**: Include git info for reference
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"git_commit": "a1b2c3d4e5f",
|
|
||||||
"git_branch": "main",
|
|
||||||
"files_changed": [
|
|
||||||
".claude/agents/code-review.md",
|
|
||||||
".claude/skills/frontend-design/SKILL.md"
|
|
||||||
],
|
|
||||||
"commit_message": "feat: Add Sequential Thinking to Code Review Agent\n\n..."
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Implementation**:
|
|
||||||
```bash
|
|
||||||
# Load config
|
|
||||||
source .claude/context-recall-config.env
|
|
||||||
|
|
||||||
# Get git info
|
|
||||||
COMMIT_HASH=$(git rev-parse --short HEAD)
|
|
||||||
BRANCH=$(git rev-parse --abbrev-ref HEAD)
|
|
||||||
COMMIT_MSG=$(git log -1 --pretty=%B)
|
|
||||||
FILES=$(git diff --name-only HEAD~1 | tr '\n' ',' | sed 's/,$//')
|
|
||||||
|
|
||||||
# Create payload and POST to API
|
|
||||||
curl -X POST http://172.16.3.30:8001/api/conversation-contexts \
|
|
||||||
-H "Authorization: Bearer $JWT_TOKEN" \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{
|
|
||||||
"project_id": "'$CLAUDE_PROJECT_ID'",
|
|
||||||
"context_type": "checkpoint",
|
|
||||||
"title": "Checkpoint: <commit-summary>",
|
|
||||||
"dense_summary": "<comprehensive-summary>",
|
|
||||||
"relevance_score": 8.0,
|
|
||||||
"tags": ["<tags>"],
|
|
||||||
"metadata": {
|
|
||||||
"git_commit": "'$COMMIT_HASH'",
|
|
||||||
"git_branch": "'$BRANCH'",
|
|
||||||
"files_changed": ["'$FILES'"],
|
|
||||||
"commit_message": "'$COMMIT_MSG'"
|
|
||||||
}
|
|
||||||
}'
|
|
||||||
```
|
|
||||||
|
|
||||||
7. **Verify both checkpoints**:
|
|
||||||
- Confirm git commit succeeded (git log -1)
|
|
||||||
- Confirm database save succeeded (check API response)
|
|
||||||
- Report both statuses to user
|
|
||||||
|
|
||||||
8. **Refresh directives** (MANDATORY):
|
|
||||||
- After checkpoint completion, auto-invoke `/refresh-directives`
|
- After checkpoint completion, auto-invoke `/refresh-directives`
|
||||||
- Re-read `directives.md` to prevent shortcut-taking
|
- Re-read `directives.md` to prevent shortcut-taking
|
||||||
- Perform self-assessment for any violations
|
- Perform self-assessment for any violations
|
||||||
- Confirm commitment to agent coordination rules
|
- Confirm commitment to agent coordination rules
|
||||||
- Report directives refreshed to user
|
- Report directives refreshed to user
|
||||||
|
|
||||||
## Benefits of Dual Checkpoint
|
## Benefits of Git Checkpoint
|
||||||
|
|
||||||
**Git Checkpoint:**
|
**Git Checkpoint provides:**
|
||||||
- Code versioning
|
- Code versioning
|
||||||
- Change history
|
- Change history
|
||||||
- Rollback capability
|
- Rollback capability
|
||||||
|
- Complete project memory over time
|
||||||
**Database Context:**
|
- Collaboration support through detailed commit messages
|
||||||
- Cross-machine recall
|
|
||||||
- Semantic search
|
|
||||||
- Session continuity
|
|
||||||
- Context for future work
|
|
||||||
|
|
||||||
**Together:** Complete project memory across time and machines
|
|
||||||
|
|
||||||
## IMPORTANT
|
## IMPORTANT
|
||||||
|
|
||||||
@@ -181,6 +64,3 @@ Please create a comprehensive checkpoint that captures BOTH git changes AND sess
|
|||||||
- Make the commit message descriptive enough that someone reviewing the git log can understand what was accomplished
|
- Make the commit message descriptive enough that someone reviewing the git log can understand what was accomplished
|
||||||
- Follow the project's existing commit message conventions (check git log first)
|
- Follow the project's existing commit message conventions (check git log first)
|
||||||
- Include the Claude Code co-author attribution in the commit message
|
- Include the Claude Code co-author attribution in the commit message
|
||||||
- Ensure database context save includes enough detail for future recall
|
|
||||||
- Use relevance_score 8.0 for checkpoints (important milestones)
|
|
||||||
- Extract meaningful tags (4-8 tags) for search/filtering
|
|
||||||
|
|||||||
Reference in New Issue
Block a user