create-sessions-dir 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
- package/templates/claude/commands/document.md +16 -0
- package/templates/sessions/README.md +19 -6
package/README.md
CHANGED
|
@@ -40,6 +40,7 @@ Then start your first session:
|
|
|
40
40
|
commands/
|
|
41
41
|
start-session.md # /start-session command
|
|
42
42
|
end-session.md # /end-session command
|
|
43
|
+
document.md # /document <topic> command
|
|
43
44
|
archive-session.md # /archive-session command
|
|
44
45
|
```
|
|
45
46
|
|
|
@@ -57,6 +58,12 @@ Claude reads your context and asks what you want to work on.
|
|
|
57
58
|
```
|
|
58
59
|
Claude updates your context with what happened and commits the changes.
|
|
59
60
|
|
|
61
|
+
### Document a Topic
|
|
62
|
+
```
|
|
63
|
+
/document architecture
|
|
64
|
+
```
|
|
65
|
+
Claude creates topic-specific documentation in `.sessions/docs/`. Use this for architectural decisions, API patterns, testing strategies, or other deep context.
|
|
66
|
+
|
|
60
67
|
### Archive Completed Work
|
|
61
68
|
```
|
|
62
69
|
/archive-session
|
package/dist/index.js
CHANGED
|
@@ -99,6 +99,9 @@ function createSessionsDirectory() {
|
|
|
99
99
|
const archiveSessionContent = getTemplateContent('claude/commands/archive-session.md');
|
|
100
100
|
writeFileSync('.claude/commands/archive-session.md', archiveSessionContent);
|
|
101
101
|
log('✓ Created .claude/commands/archive-session.md', colors.green);
|
|
102
|
+
const documentContent = getTemplateContent('claude/commands/document.md');
|
|
103
|
+
writeFileSync('.claude/commands/document.md', documentContent);
|
|
104
|
+
log('✓ Created .claude/commands/document.md', colors.green);
|
|
102
105
|
}
|
|
103
106
|
function main() {
|
|
104
107
|
log('\n✨ create-sessions-dir', colors.cyan + colors.bright);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-sessions-dir",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Scaffold a Sessions Directory for working with AI coding agents",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
|
-
"create-sessions-dir": "
|
|
7
|
+
"create-sessions-dir": "dist/index.js"
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
10
|
"dist",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"license": "MIT",
|
|
29
29
|
"repository": {
|
|
30
30
|
"type": "git",
|
|
31
|
-
"url": "https://github.com/vieko/create-sessions-dir.git"
|
|
31
|
+
"url": "git+https://github.com/vieko/create-sessions-dir.git"
|
|
32
32
|
},
|
|
33
33
|
"bugs": {
|
|
34
34
|
"url": "https://github.com/vieko/create-sessions-dir/issues"
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
Create or update documentation for a specific topic in .sessions/docs/
|
|
2
|
+
|
|
3
|
+
The user will provide a topic name (e.g., "authentication", "api-design", "testing-strategy").
|
|
4
|
+
|
|
5
|
+
Steps:
|
|
6
|
+
1. If .sessions/docs/ doesn't exist, create it first
|
|
7
|
+
2. Create or update .sessions/docs/<topic>.md
|
|
8
|
+
3. Ask me what should be documented about this topic
|
|
9
|
+
4. Structure the documentation with:
|
|
10
|
+
- Overview of the topic
|
|
11
|
+
- Current decisions and rationale
|
|
12
|
+
- Implementation details or patterns
|
|
13
|
+
- Open questions or considerations
|
|
14
|
+
- Links to relevant code or resources
|
|
15
|
+
|
|
16
|
+
Keep the documentation scannable and focused. Use clear headings and bullet points.
|
|
@@ -30,6 +30,8 @@ As you work, document important decisions, architecture choices, and progress:
|
|
|
30
30
|
|
|
31
31
|
### 3. End the Session
|
|
32
32
|
|
|
33
|
+
**End frequently** (every 20-30 minutes is fine). Think of it like saving your game - save often!
|
|
34
|
+
|
|
33
35
|
Use the slash command:
|
|
34
36
|
```
|
|
35
37
|
/end-session
|
|
@@ -70,7 +72,7 @@ Or prompt Claude directly:
|
|
|
70
72
|
|
|
71
73
|
## Slash Commands
|
|
72
74
|
|
|
73
|
-
This setup includes
|
|
75
|
+
This setup includes four slash commands for Claude Code:
|
|
74
76
|
|
|
75
77
|
### `/start-session`
|
|
76
78
|
Reads your session context and gets you oriented. Claude will:
|
|
@@ -85,6 +87,15 @@ Updates your session context with what happened. Claude will:
|
|
|
85
87
|
- Set next session priorities
|
|
86
88
|
- Commit the changes
|
|
87
89
|
|
|
90
|
+
### `/document <topic>`
|
|
91
|
+
Creates topic-specific documentation as your project grows. Claude will:
|
|
92
|
+
- Create `.sessions/docs/` folder (first time only)
|
|
93
|
+
- Create or update `.sessions/docs/<topic>.md`
|
|
94
|
+
- Ask what should be documented
|
|
95
|
+
- Structure it with clear headings and context
|
|
96
|
+
|
|
97
|
+
**Use this when:** You have architectural decisions, API patterns, testing strategies, or other deep context worth its own document.
|
|
98
|
+
|
|
88
99
|
### `/archive-session`
|
|
89
100
|
Archives completed work to keep your context file clean. Claude will:
|
|
90
101
|
- Move finished notes to `.sessions/archive/`
|
|
@@ -142,15 +153,17 @@ Clean up .sessions/index.md by removing completed items.
|
|
|
142
153
|
|
|
143
154
|
## Tips
|
|
144
155
|
|
|
145
|
-
1. **
|
|
156
|
+
1. **End sessions frequently** - Sessions can be 20-30 minutes. Think of `/end-session` like saving your game - save often. It's better to end and start fresh than to keep a session open all day.
|
|
157
|
+
|
|
158
|
+
2. **Update as you go** - Don't wait until the end. Document decisions as you make them.
|
|
146
159
|
|
|
147
|
-
|
|
160
|
+
3. **Be specific** - "Fixed auth bug" is less useful than "Fixed token refresh race condition in AuthProvider"
|
|
148
161
|
|
|
149
|
-
|
|
162
|
+
4. **Track blockers** - Note what's blocking progress so the next session can pick up smoothly
|
|
150
163
|
|
|
151
|
-
|
|
164
|
+
5. **Commit often** - Each session should have at least one commit updating `.sessions/index.md`
|
|
152
165
|
|
|
153
|
-
|
|
166
|
+
6. **Archive completed work** - Once a feature is done, move detailed notes to `.sessions/archive/` to keep your index file scannable
|
|
154
167
|
|
|
155
168
|
---
|
|
156
169
|
|