Skip to content

Commit 8747557

Browse files
jonathanpeterwujonathanpeterwu
committed
feat: Implement Claude Skills for enhanced workflow automation
- Add Frame Handoff Orchestrator skill for team collaboration - Auto-detects completed/blocked frames - Generates comprehensive handoff summaries - Creates action items and notifications - Supports priority levels - Add Recovery Checkpoint Manager skill - Creates full context snapshots - Auto-detects risky operations - Backs up specified files - Enables quick restoration and diffs - Add Context Archaeologist skill - Deep semantic search across historical frames - Extracts patterns (TDD, refactoring, debugging) - Identifies key decisions - Generates activity timelines - Integrate skills into CLI with 'stackmemory skills' command - Add comprehensive test suite (21 tests) - Add detailed documentation in docs/CLAUDE_SKILLS.md These skills leverage STA-100 FrameHandoffManager and provide intelligent assistance for common development workflows.
1 parent d5cb26b commit 8747557

6 files changed

Lines changed: 1896 additions & 4 deletions

File tree

‎.lint-fix-log.json‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
[
22
{
3-
"timestamp": "2026-01-05T19:12:54.534Z",
3+
"timestamp": "2026-01-05T19:42:12.135Z",
44
"level": "info",
55
"message": "🔧 Starting auto-fix loop..."
66
},
77
{
8-
"timestamp": "2026-01-05T19:12:54.536Z",
8+
"timestamp": "2026-01-05T19:42:12.138Z",
99
"level": "info",
1010
"message": "📝 Auto-fix attempt 1/3"
1111
},
1212
{
13-
"timestamp": "2026-01-05T19:12:57.965Z",
13+
"timestamp": "2026-01-05T19:42:15.745Z",
1414
"level": "info",
1515
"message": "Running ESLint auto-fix..."
1616
},
1717
{
18-
"timestamp": "2026-01-05T19:13:04.095Z",
18+
"timestamp": "2026-01-05T19:42:21.910Z",
1919
"level": "success",
2020
"message": "✅ All fixable lint errors resolved! (warnings are ok for commits)"
2121
}

‎docs/CLAUDE_SKILLS.md‎

Lines changed: 187 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,187 @@
1+
# Claude Skills Documentation
2+
3+
Claude Skills are custom commands that enhance your workflow when using Claude Code with StackMemory. These skills leverage the frame-based memory system to provide intelligent assistance for common development tasks.
4+
5+
## Available Skills
6+
7+
### 1. Frame Handoff Orchestrator (`/handoff`)
8+
9+
Streamlines frame handoffs between team members by automatically detecting completed work, errors, and pending tasks.
10+
11+
**Usage:**
12+
```bash
13+
stackmemory skills handoff @teammate "Feature complete for review"
14+
stackmemory skills handoff @teammate "Blocked on API issue" --priority critical
15+
stackmemory skills handoff @teammate "Ready for testing" --frames frame1,frame2
16+
```
17+
18+
**Features:**
19+
- Auto-detects frames that need handoff (completed or blocked)
20+
- Generates comprehensive handoff summaries
21+
- Creates action items for the recipient
22+
- Tracks handoff with notifications
23+
- Supports priority levels (low, medium, high, critical)
24+
25+
**Options:**
26+
- `-p, --priority <level>`: Set priority level
27+
- `-f, --frames <frames...>`: Specify specific frames to handoff
28+
- `--no-auto-detect`: Disable auto-detection of frames
29+
30+
### 2. Recovery Checkpoint Manager (`/checkpoint`)
31+
32+
Creates and manages recovery points for your work, enabling quick rollback and comparison between states.
33+
34+
**Usage:**
35+
```bash
36+
# Create checkpoints
37+
stackmemory skills checkpoint create "Before database migration"
38+
stackmemory skills checkpoint create "Stable state" --auto-detect-risky
39+
stackmemory skills checkpoint create "With configs" --files config.json,env.local
40+
41+
# Restore from checkpoint
42+
stackmemory skills checkpoint restore checkpoint-123456
43+
44+
# List checkpoints
45+
stackmemory skills checkpoint list
46+
stackmemory skills checkpoint list --limit 5 --since "2024-01-01"
47+
48+
# Compare checkpoints
49+
stackmemory skills checkpoint diff checkpoint-123 checkpoint-456
50+
```
51+
52+
**Features:**
53+
- Creates full context snapshots
54+
- Auto-detects risky operations (migrations, deployments, deletions)
55+
- Backs up specified files
56+
- Quick restoration to any checkpoint
57+
- Diff between checkpoints to see changes
58+
59+
**Options for create:**
60+
- `--files <files...>`: Include specific files in checkpoint
61+
- `--auto-detect-risky`: Auto-detect and flag risky operations
62+
63+
**Options for list:**
64+
- `-l, --limit <number>`: Limit number of results
65+
- `-s, --since <date>`: Show checkpoints since date
66+
67+
### 3. Context Archaeologist (`/dig`)
68+
69+
Deep historical context retrieval across all your sessions, finding patterns, decisions, and relevant information from the past.
70+
71+
**Usage:**
72+
```bash
73+
# Basic search
74+
stackmemory skills dig "authentication implementation"
75+
76+
# Search with time range
77+
stackmemory skills dig "database optimization" --depth 6months
78+
79+
# Advanced analysis
80+
stackmemory skills dig "API design decisions" --patterns --decisions --timeline
81+
82+
# Search all history
83+
stackmemory skills dig "production issues" --depth all
84+
```
85+
86+
**Features:**
87+
- Semantic search across all historical frames
88+
- Pattern detection (TDD, refactoring, debugging, etc.)
89+
- Decision extraction from past discussions
90+
- Timeline generation of activities
91+
- Configurable search depth
92+
93+
**Options:**
94+
- `-d, --depth <depth>`: Search depth (30days, 6months, 1year, all)
95+
- `--patterns`: Extract recurring patterns
96+
- `--decisions`: Extract key decisions made
97+
- `--timeline`: Generate activity timeline
98+
99+
## Integration with Claude Code
100+
101+
These skills are designed to work seamlessly with Claude Code sessions:
102+
103+
### During Development
104+
1. **Start work**: Create a checkpoint before major changes
105+
2. **Hit a blocker**: Use handoff to pass context to teammate
106+
3. **Need context**: Dig for relevant past decisions or implementations
107+
108+
### Example Workflow
109+
```bash
110+
# Starting a new feature
111+
stackmemory skills checkpoint create "Starting OAuth implementation"
112+
113+
# Found previous implementation
114+
stackmemory skills dig "OAuth" --depth 6months --decisions
115+
116+
# Blocked and need help
117+
stackmemory skills handoff @senior-dev "OAuth flow incomplete, need help with refresh tokens" --priority high
118+
119+
# Before risky change
120+
stackmemory skills checkpoint create "Before OAuth refactor" --auto-detect-risky
121+
122+
# Something went wrong
123+
stackmemory skills checkpoint restore checkpoint-xyz
124+
```
125+
126+
## Advanced Usage
127+
128+
### Combining Skills
129+
130+
Skills work together to provide powerful workflows:
131+
132+
```bash
133+
# Research -> Checkpoint -> Work -> Handoff
134+
stackmemory skills dig "payment integration" --patterns
135+
stackmemory skills checkpoint create "Before payment integration"
136+
# ... do work ...
137+
stackmemory skills handoff @qa-team "Payment integration ready for testing"
138+
```
139+
140+
### Automation Opportunities
141+
142+
Skills can be integrated into your development workflow:
143+
144+
1. **Git Hooks**: Auto-checkpoint before commits
145+
2. **CI/CD**: Create checkpoints before deployments
146+
3. **Team Processes**: Standardized handoff procedures
147+
148+
## Configuration
149+
150+
Skills use your StackMemory configuration and store data in:
151+
- Checkpoints: `~/.stackmemory/checkpoints/<project-id>/`
152+
- Skills config: `~/.stackmemory/skills/config.json`
153+
154+
## Tips and Best Practices
155+
156+
1. **Checkpoint Often**: Create checkpoints before any risky operation
157+
2. **Descriptive Messages**: Use clear descriptions for checkpoints and handoffs
158+
3. **Use Patterns**: Let `dig` find patterns in your workflow to improve processes
159+
4. **Team Coordination**: Establish team conventions for handoff priorities
160+
5. **Time-based Searches**: Use appropriate depth for `dig` to avoid information overload
161+
162+
## Troubleshooting
163+
164+
### Skills not working?
165+
```bash
166+
# Check if StackMemory is initialized
167+
stackmemory status
168+
169+
# View skill help
170+
stackmemory skills help
171+
stackmemory skills help handoff
172+
```
173+
174+
### Performance issues?
175+
- Limit search depth in `dig` command
176+
- Clean old checkpoints periodically
177+
- Use specific frame IDs for handoffs when possible
178+
179+
## Future Enhancements
180+
181+
Planned improvements for Claude Skills:
182+
- Visual diff viewer for checkpoints
183+
- Team templates for common handoffs
184+
- Auto-learning from successful patterns
185+
- Integration with Linear/Jira for handoffs
186+
- Scheduled checkpoint creation
187+
- Cross-project context search

0 commit comments

Comments
 (0)