cognitive-workflow-mcp 1.1.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/.workflow/bucket-builder.html +823 -0
- package/.workflow/bucket-discoverer.html +928 -0
- package/.workflow/bucket-experimenter.html +802 -0
- package/.workflow/bucket-operator.html +951 -0
- package/.workflow/bucket-strategist.html +970 -0
- package/.workflow/bucket-teacher.html +873 -0
- package/.workflow/cognitive-dashboard-enhanced.html +731 -0
- package/.workflow/cognitive-dashboard.html +296 -0
- package/LICENSE +21 -0
- package/README.md +317 -0
- package/bin/cli.js +286 -0
- package/package.json +57 -0
- package/src/analyzer.js +194 -0
- package/src/configurator.js +63 -0
- package/src/generator.js +65 -0
- package/src/index.js +233 -0
- package/src/insights.js +127 -0
- package/src/templates.js +396 -0
|
@@ -0,0 +1,296 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Cognitive Workflow Dashboard</title>
|
|
7
|
+
<style>
|
|
8
|
+
* { margin: 0; padding: 0; box-sizing: border-box; }
|
|
9
|
+
body {
|
|
10
|
+
font-family: 'SF Mono', 'Monaco', monospace;
|
|
11
|
+
background: linear-gradient(135deg, #0f172a 0%, #1e293b 100%);
|
|
12
|
+
color: #e2e8f0;
|
|
13
|
+
padding: 40px;
|
|
14
|
+
line-height: 1.6;
|
|
15
|
+
}
|
|
16
|
+
.container {
|
|
17
|
+
max-width: 1400px;
|
|
18
|
+
margin: 0 auto;
|
|
19
|
+
}
|
|
20
|
+
.header {
|
|
21
|
+
text-align: center;
|
|
22
|
+
margin-bottom: 50px;
|
|
23
|
+
}
|
|
24
|
+
h1 {
|
|
25
|
+
font-size: 3em;
|
|
26
|
+
margin-bottom: 20px;
|
|
27
|
+
color: #60a5fa;
|
|
28
|
+
}
|
|
29
|
+
.subtitle {
|
|
30
|
+
font-size: 1.2em;
|
|
31
|
+
color: #94a3b8;
|
|
32
|
+
}
|
|
33
|
+
.stats-overview {
|
|
34
|
+
display: grid;
|
|
35
|
+
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
|
|
36
|
+
gap: 20px;
|
|
37
|
+
margin-bottom: 50px;
|
|
38
|
+
}
|
|
39
|
+
.overview-card {
|
|
40
|
+
background: rgba(30, 41, 59, 0.8);
|
|
41
|
+
padding: 20px;
|
|
42
|
+
border-radius: 10px;
|
|
43
|
+
text-align: center;
|
|
44
|
+
border: 1px solid #334155;
|
|
45
|
+
}
|
|
46
|
+
.overview-number {
|
|
47
|
+
font-size: 2.5em;
|
|
48
|
+
font-weight: bold;
|
|
49
|
+
color: #60a5fa;
|
|
50
|
+
}
|
|
51
|
+
.overview-label {
|
|
52
|
+
color: #94a3b8;
|
|
53
|
+
margin-top: 5px;
|
|
54
|
+
}
|
|
55
|
+
.bucket-grid {
|
|
56
|
+
display: grid;
|
|
57
|
+
grid-template-columns: repeat(auto-fit, minmax(350px, 1fr));
|
|
58
|
+
gap: 30px;
|
|
59
|
+
}
|
|
60
|
+
.bucket-card {
|
|
61
|
+
background: rgba(30, 41, 59, 0.8);
|
|
62
|
+
padding: 30px;
|
|
63
|
+
border-radius: 15px;
|
|
64
|
+
cursor: pointer;
|
|
65
|
+
transition: all 0.3s ease;
|
|
66
|
+
border: 2px solid #334155;
|
|
67
|
+
}
|
|
68
|
+
.bucket-card:hover {
|
|
69
|
+
transform: translateY(-5px);
|
|
70
|
+
box-shadow: 0 10px 30px rgba(96, 165, 250, 0.3);
|
|
71
|
+
border-color: #60a5fa;
|
|
72
|
+
}
|
|
73
|
+
.bucket-header {
|
|
74
|
+
display: flex;
|
|
75
|
+
align-items: center;
|
|
76
|
+
gap: 15px;
|
|
77
|
+
margin-bottom: 20px;
|
|
78
|
+
}
|
|
79
|
+
.bucket-emoji {
|
|
80
|
+
font-size: 2.5em;
|
|
81
|
+
}
|
|
82
|
+
.bucket-header h3 {
|
|
83
|
+
font-size: 1.8em;
|
|
84
|
+
color: #e2e8f0;
|
|
85
|
+
}
|
|
86
|
+
.bucket-stats {
|
|
87
|
+
display: flex;
|
|
88
|
+
gap: 20px;
|
|
89
|
+
margin-bottom: 20px;
|
|
90
|
+
padding: 15px;
|
|
91
|
+
background: rgba(15, 23, 42, 0.5);
|
|
92
|
+
border-radius: 8px;
|
|
93
|
+
}
|
|
94
|
+
.stat {
|
|
95
|
+
flex: 1;
|
|
96
|
+
text-align: center;
|
|
97
|
+
}
|
|
98
|
+
.stat-number {
|
|
99
|
+
font-size: 1.8em;
|
|
100
|
+
font-weight: bold;
|
|
101
|
+
color: #60a5fa;
|
|
102
|
+
}
|
|
103
|
+
.stat-label {
|
|
104
|
+
font-size: 0.9em;
|
|
105
|
+
color: #94a3b8;
|
|
106
|
+
}
|
|
107
|
+
.bucket-description {
|
|
108
|
+
color: #cbd5e1;
|
|
109
|
+
font-style: italic;
|
|
110
|
+
}
|
|
111
|
+
.framework-section {
|
|
112
|
+
margin-top: 60px;
|
|
113
|
+
padding: 40px;
|
|
114
|
+
background: rgba(30, 41, 59, 0.6);
|
|
115
|
+
border-radius: 15px;
|
|
116
|
+
border: 1px solid #334155;
|
|
117
|
+
}
|
|
118
|
+
.framework-section h2 {
|
|
119
|
+
color: #60a5fa;
|
|
120
|
+
margin-bottom: 20px;
|
|
121
|
+
}
|
|
122
|
+
.framework-section p {
|
|
123
|
+
margin-bottom: 15px;
|
|
124
|
+
color: #cbd5e1;
|
|
125
|
+
}
|
|
126
|
+
</style>
|
|
127
|
+
</head>
|
|
128
|
+
<body>
|
|
129
|
+
<div class="container">
|
|
130
|
+
<div class="header">
|
|
131
|
+
<h1>🧠 Cognitive Workflow Dashboard</h1>
|
|
132
|
+
<p class="subtitle">Tool = Identity = Mindset</p>
|
|
133
|
+
</div>
|
|
134
|
+
|
|
135
|
+
<div class="stats-overview">
|
|
136
|
+
<div class="overview-card">
|
|
137
|
+
<div class="overview-number">1693</div>
|
|
138
|
+
<div class="overview-label">Total Commits</div>
|
|
139
|
+
</div>
|
|
140
|
+
<div class="overview-card">
|
|
141
|
+
<div class="overview-number">60</div>
|
|
142
|
+
<div class="overview-label">Days Analyzed</div>
|
|
143
|
+
</div>
|
|
144
|
+
<div class="overview-card">
|
|
145
|
+
<div class="overview-number">6</div>
|
|
146
|
+
<div class="overview-label">Cognitive Identities</div>
|
|
147
|
+
</div>
|
|
148
|
+
</div>
|
|
149
|
+
|
|
150
|
+
<div class="bucket-grid">
|
|
151
|
+
|
|
152
|
+
<div class="bucket-card" onclick="window.location='bucket-builder.html'">
|
|
153
|
+
<div class="bucket-header">
|
|
154
|
+
<span class="bucket-emoji">🏗️</span>
|
|
155
|
+
<h3>Builder</h3>
|
|
156
|
+
</div>
|
|
157
|
+
<div class="bucket-stats">
|
|
158
|
+
<div class="stat">
|
|
159
|
+
<div class="stat-number">1486</div>
|
|
160
|
+
<div class="stat-label">commits</div>
|
|
161
|
+
</div>
|
|
162
|
+
<div class="stat">
|
|
163
|
+
<div class="stat-number">88%</div>
|
|
164
|
+
<div class="stat-label">of work</div>
|
|
165
|
+
</div>
|
|
166
|
+
<div class="stat">
|
|
167
|
+
<div class="stat-number">24.77</div>
|
|
168
|
+
<div class="stat-label">per day</div>
|
|
169
|
+
</div>
|
|
170
|
+
</div>
|
|
171
|
+
<div class="bucket-description">The factory floor where hands meet keyboard</div>
|
|
172
|
+
</div>
|
|
173
|
+
|
|
174
|
+
<div class="bucket-card" onclick="window.location='bucket-discoverer.html'">
|
|
175
|
+
<div class="bucket-header">
|
|
176
|
+
<span class="bucket-emoji">🔬</span>
|
|
177
|
+
<h3>Discoverer</h3>
|
|
178
|
+
</div>
|
|
179
|
+
<div class="bucket-stats">
|
|
180
|
+
<div class="stat">
|
|
181
|
+
<div class="stat-number">102</div>
|
|
182
|
+
<div class="stat-label">commits</div>
|
|
183
|
+
</div>
|
|
184
|
+
<div class="stat">
|
|
185
|
+
<div class="stat-number">6%</div>
|
|
186
|
+
<div class="stat-label">of work</div>
|
|
187
|
+
</div>
|
|
188
|
+
<div class="stat">
|
|
189
|
+
<div class="stat-number">1.7</div>
|
|
190
|
+
<div class="stat-label">per day</div>
|
|
191
|
+
</div>
|
|
192
|
+
</div>
|
|
193
|
+
<div class="bucket-description">The research vault where foundational knowledge emerges</div>
|
|
194
|
+
</div>
|
|
195
|
+
|
|
196
|
+
<div class="bucket-card" onclick="window.location='bucket-operator.html'">
|
|
197
|
+
<div class="bucket-header">
|
|
198
|
+
<span class="bucket-emoji">🎩</span>
|
|
199
|
+
<h3>Operator</h3>
|
|
200
|
+
</div>
|
|
201
|
+
<div class="bucket-stats">
|
|
202
|
+
<div class="stat">
|
|
203
|
+
<div class="stat-number">61</div>
|
|
204
|
+
<div class="stat-label">commits</div>
|
|
205
|
+
</div>
|
|
206
|
+
<div class="stat">
|
|
207
|
+
<div class="stat-number">4%</div>
|
|
208
|
+
<div class="stat-label">of work</div>
|
|
209
|
+
</div>
|
|
210
|
+
<div class="stat">
|
|
211
|
+
<div class="stat-number">1.02</div>
|
|
212
|
+
<div class="stat-label">per day</div>
|
|
213
|
+
</div>
|
|
214
|
+
</div>
|
|
215
|
+
<div class="bucket-description">The command center where relationships are managed</div>
|
|
216
|
+
</div>
|
|
217
|
+
|
|
218
|
+
<div class="bucket-card" onclick="window.location='bucket-teacher.html'">
|
|
219
|
+
<div class="bucket-header">
|
|
220
|
+
<span class="bucket-emoji">📣</span>
|
|
221
|
+
<h3>Teacher</h3>
|
|
222
|
+
</div>
|
|
223
|
+
<div class="bucket-stats">
|
|
224
|
+
<div class="stat">
|
|
225
|
+
<div class="stat-number">31</div>
|
|
226
|
+
<div class="stat-label">commits</div>
|
|
227
|
+
</div>
|
|
228
|
+
<div class="stat">
|
|
229
|
+
<div class="stat-number">2%</div>
|
|
230
|
+
<div class="stat-label">of work</div>
|
|
231
|
+
</div>
|
|
232
|
+
<div class="stat">
|
|
233
|
+
<div class="stat-number">0.52</div>
|
|
234
|
+
<div class="stat-label">per day</div>
|
|
235
|
+
</div>
|
|
236
|
+
</div>
|
|
237
|
+
<div class="bucket-description">The public stage where ideas are broadcast</div>
|
|
238
|
+
</div>
|
|
239
|
+
|
|
240
|
+
<div class="bucket-card" onclick="window.location='bucket-experimenter.html'">
|
|
241
|
+
<div class="bucket-header">
|
|
242
|
+
<span class="bucket-emoji">🧪</span>
|
|
243
|
+
<h3>Experimenter</h3>
|
|
244
|
+
</div>
|
|
245
|
+
<div class="bucket-stats">
|
|
246
|
+
<div class="stat">
|
|
247
|
+
<div class="stat-number">9</div>
|
|
248
|
+
<div class="stat-label">commits</div>
|
|
249
|
+
</div>
|
|
250
|
+
<div class="stat">
|
|
251
|
+
<div class="stat-number">1%</div>
|
|
252
|
+
<div class="stat-label">of work</div>
|
|
253
|
+
</div>
|
|
254
|
+
<div class="stat">
|
|
255
|
+
<div class="stat-number">0.15</div>
|
|
256
|
+
<div class="stat-label">per day</div>
|
|
257
|
+
</div>
|
|
258
|
+
</div>
|
|
259
|
+
<div class="bucket-description">The lab where rapid prototypes are born</div>
|
|
260
|
+
</div>
|
|
261
|
+
|
|
262
|
+
<div class="bucket-card" onclick="window.location='bucket-strategist.html'">
|
|
263
|
+
<div class="bucket-header">
|
|
264
|
+
<span class="bucket-emoji">🗺️</span>
|
|
265
|
+
<h3>Strategist</h3>
|
|
266
|
+
</div>
|
|
267
|
+
<div class="bucket-stats">
|
|
268
|
+
<div class="stat">
|
|
269
|
+
<div class="stat-number">4</div>
|
|
270
|
+
<div class="stat-label">commits</div>
|
|
271
|
+
</div>
|
|
272
|
+
<div class="stat">
|
|
273
|
+
<div class="stat-number">0%</div>
|
|
274
|
+
<div class="stat-label">of work</div>
|
|
275
|
+
</div>
|
|
276
|
+
<div class="stat">
|
|
277
|
+
<div class="stat-number">0.07</div>
|
|
278
|
+
<div class="stat-label">per day</div>
|
|
279
|
+
</div>
|
|
280
|
+
</div>
|
|
281
|
+
<div class="bucket-description">The war room where patterns are analyzed</div>
|
|
282
|
+
</div>
|
|
283
|
+
|
|
284
|
+
</div>
|
|
285
|
+
|
|
286
|
+
<div class="framework-section">
|
|
287
|
+
<h2>Core Principle: Tool = Identity = Mindset</h2>
|
|
288
|
+
<p>Each terminal isn't just a tool—it's a <strong>cognitive identity you step into</strong>.
|
|
289
|
+
The muscle memory isn't "Kitty = email," it's "Kitty = I am the person who runs the business."</p>
|
|
290
|
+
|
|
291
|
+
<p style="margin-top: 20px;"><strong>The Flywheel Effect:</strong> Each identity's outputs become inputs for other identities.
|
|
292
|
+
Builder creates → Teacher documents → Strategist positions → Operator executes → Discoverer researches → Experimenter validates → repeat.</p>
|
|
293
|
+
</div>
|
|
294
|
+
</div>
|
|
295
|
+
</body>
|
|
296
|
+
</html>
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 ThetaDriven
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
# Cognitive Workflow MCP
|
|
2
|
+
|
|
3
|
+
**Transform your terminal setup into a mental palace with identity-based cognitive workflows.**
|
|
4
|
+
|
|
5
|
+
An MCP (Model Context Protocol) server that analyzes your git commit history, categorizes work into 6 cognitive identities, and generates a visual dashboard system for terminal-based context switching.
|
|
6
|
+
|
|
7
|
+
## 🧠 What is This?
|
|
8
|
+
|
|
9
|
+
A productivity system that maps **terminal applications** to **cognitive identities**, creating muscle-memory triggers for different work modes:
|
|
10
|
+
|
|
11
|
+
- **Builder** (iTerm2) - Hands-on coding and implementation
|
|
12
|
+
- **Discoverer** (WezTerm) - Deep research and first principles thinking
|
|
13
|
+
- **Operator** (Kitty) - Business operations and relationship management
|
|
14
|
+
- **Teacher** (Terminal) - Content creation and public communication
|
|
15
|
+
- **Strategist** (VS Code) - Market analysis and competitive positioning
|
|
16
|
+
- **Experimenter** (Cursor) - Rapid prototyping and hypothesis testing
|
|
17
|
+
|
|
18
|
+
**Core Principle:** `Tool = Identity = Mindset`
|
|
19
|
+
|
|
20
|
+
When you open a specific terminal, your brain shifts into that cognitive mode automatically.
|
|
21
|
+
|
|
22
|
+
## 🚀 Quick Start
|
|
23
|
+
|
|
24
|
+
### Installation
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# As MCP server for Claude Code
|
|
28
|
+
npm install -g cognitive-workflow-mcp
|
|
29
|
+
|
|
30
|
+
# Register with Claude Code
|
|
31
|
+
claude mcp add cognitive-workflow "cognitive-workflow"
|
|
32
|
+
|
|
33
|
+
# Restart Claude Code
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### CLI Usage
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
# Generate dashboard from current repo
|
|
40
|
+
cognitive-workflow analyze
|
|
41
|
+
|
|
42
|
+
# Configure terminal mappings
|
|
43
|
+
cognitive-workflow configure
|
|
44
|
+
|
|
45
|
+
# Open dashboard
|
|
46
|
+
cognitive-workflow open
|
|
47
|
+
|
|
48
|
+
# Export commit data
|
|
49
|
+
cognitive-workflow export commits.json
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### MCP Tools (via Claude Code)
|
|
53
|
+
|
|
54
|
+
Once registered, use natural language:
|
|
55
|
+
|
|
56
|
+
- "Analyze my cognitive workflow patterns"
|
|
57
|
+
- "Show my commit distribution across identities"
|
|
58
|
+
- "Generate the cognitive dashboard"
|
|
59
|
+
- "Which identity do I use most?"
|
|
60
|
+
- "Update my terminal mappings"
|
|
61
|
+
|
|
62
|
+
## 📊 Features
|
|
63
|
+
|
|
64
|
+
### 1. Git Commit Analysis
|
|
65
|
+
|
|
66
|
+
Automatically categorizes commits into 6 cognitive identities based on:
|
|
67
|
+
- Commit message patterns (feat, fix, docs, refactor, etc.)
|
|
68
|
+
- File paths and types
|
|
69
|
+
- Commit frequency and timing
|
|
70
|
+
- Code change patterns
|
|
71
|
+
|
|
72
|
+
### 2. Visual Dashboard System
|
|
73
|
+
|
|
74
|
+
Generates HTML dashboards with:
|
|
75
|
+
- Central command center showing all 6 identities
|
|
76
|
+
- Individual "room" pages for each identity
|
|
77
|
+
- Commit history categorized by focus area
|
|
78
|
+
- Stats: total commits, percentage of work, daily average
|
|
79
|
+
- Color-coded visual reinforcement
|
|
80
|
+
|
|
81
|
+
### 3. Terminal Configuration
|
|
82
|
+
|
|
83
|
+
Maps terminal applications to cognitive identities:
|
|
84
|
+
- Detects installed terminals automatically
|
|
85
|
+
- Customizable color schemes per identity
|
|
86
|
+
- Quick-launch commands
|
|
87
|
+
- Integration with Spotlight/Alfred
|
|
88
|
+
|
|
89
|
+
### 4. Mental Palace Architecture
|
|
90
|
+
|
|
91
|
+
Each identity gets a vivid room metaphor:
|
|
92
|
+
- **Builder's Workbench** - Factory floor with tools everywhere
|
|
93
|
+
- **Discoverer's Vault** - Underground library with ancient texts
|
|
94
|
+
- **Operator's Command Center** - Executive suite with dashboards
|
|
95
|
+
- **Teacher's Stage** - TED-style amphitheater with live audience
|
|
96
|
+
- **Strategist's War Room** - Command center with market maps
|
|
97
|
+
- **Experimenter's Lab** - Chaotic workshop with prototypes
|
|
98
|
+
|
|
99
|
+
### 5. Cognitive Triggers
|
|
100
|
+
|
|
101
|
+
Automatic detection of when to switch identities:
|
|
102
|
+
- Question patterns signal cognitive mode
|
|
103
|
+
- Exit conditions suggest next identity
|
|
104
|
+
- Flywheel diagrams show how identities feed each other
|
|
105
|
+
|
|
106
|
+
## 🛠️ Configuration
|
|
107
|
+
|
|
108
|
+
Create `.cognitive-workflow.json` in your project root:
|
|
109
|
+
|
|
110
|
+
```json
|
|
111
|
+
{
|
|
112
|
+
"terminals": {
|
|
113
|
+
"builder": "iTerm2",
|
|
114
|
+
"discoverer": "WezTerm",
|
|
115
|
+
"operator": "Kitty",
|
|
116
|
+
"teacher": "Terminal",
|
|
117
|
+
"strategist": "VSCode",
|
|
118
|
+
"experimenter": "Cursor"
|
|
119
|
+
},
|
|
120
|
+
"colors": {
|
|
121
|
+
"builder": "#3b82f6",
|
|
122
|
+
"discoverer": "#fbbf24",
|
|
123
|
+
"operator": "#10b981",
|
|
124
|
+
"teacher": "#f97316",
|
|
125
|
+
"strategist": "#8b5cf6",
|
|
126
|
+
"experimenter": "#f43f5e"
|
|
127
|
+
},
|
|
128
|
+
"commitPatterns": {
|
|
129
|
+
"builder": ["feat", "fix", "refactor", "perf"],
|
|
130
|
+
"discoverer": ["docs", "research", "analysis"],
|
|
131
|
+
"operator": ["chore", "deploy", "ops"],
|
|
132
|
+
"teacher": ["blog", "content", "tutorial"],
|
|
133
|
+
"strategist": ["strategy", "planning", "positioning"],
|
|
134
|
+
"experimenter": ["experiment", "prototype", "poc"]
|
|
135
|
+
},
|
|
136
|
+
"analysis": {
|
|
137
|
+
"daysBack": 60,
|
|
138
|
+
"minCommitsPerIdentity": 1
|
|
139
|
+
},
|
|
140
|
+
"output": {
|
|
141
|
+
"directory": ".workflow",
|
|
142
|
+
"openAfterGenerate": true
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## 📖 MCP Tools Reference
|
|
148
|
+
|
|
149
|
+
### `cognitive-analyze`
|
|
150
|
+
|
|
151
|
+
Analyzes git commit history and categorizes into identities.
|
|
152
|
+
|
|
153
|
+
**Parameters:**
|
|
154
|
+
- `daysBack` (number, optional) - Days of history to analyze (default: 60)
|
|
155
|
+
- `outputPath` (string, optional) - Where to save results
|
|
156
|
+
|
|
157
|
+
**Returns:**
|
|
158
|
+
```json
|
|
159
|
+
{
|
|
160
|
+
"totalCommits": 200,
|
|
161
|
+
"identities": {
|
|
162
|
+
"builder": { "commits": 89, "percentage": 45 },
|
|
163
|
+
"discoverer": { "commits": 58, "percentage": 29 },
|
|
164
|
+
"operator": { "commits": 24, "percentage": 12 },
|
|
165
|
+
"teacher": { "commits": 18, "percentage": 9 },
|
|
166
|
+
"strategist": { "commits": 7, "percentage": 3 },
|
|
167
|
+
"experimenter": { "commits": 4, "percentage": 2 }
|
|
168
|
+
},
|
|
169
|
+
"insights": [
|
|
170
|
+
"Builder is your dominant mode (45%)",
|
|
171
|
+
"Discoverer is strong secondary (29%)",
|
|
172
|
+
"Experimenter needs more attention (2%)"
|
|
173
|
+
]
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### `cognitive-generate-dashboard`
|
|
178
|
+
|
|
179
|
+
Creates HTML dashboard and room pages.
|
|
180
|
+
|
|
181
|
+
**Parameters:**
|
|
182
|
+
- `outputDir` (string, optional) - Output directory (default: `.workflow`)
|
|
183
|
+
- `openAfter` (boolean, optional) - Open in browser after generation
|
|
184
|
+
|
|
185
|
+
**Returns:**
|
|
186
|
+
```json
|
|
187
|
+
{
|
|
188
|
+
"filesCreated": [
|
|
189
|
+
".workflow/cognitive-dashboard.html",
|
|
190
|
+
".workflow/bucket-builder.html",
|
|
191
|
+
".workflow/bucket-discoverer.html",
|
|
192
|
+
".workflow/bucket-operator.html",
|
|
193
|
+
".workflow/bucket-teacher.html",
|
|
194
|
+
".workflow/bucket-strategist.html",
|
|
195
|
+
".workflow/bucket-experimenter.html"
|
|
196
|
+
],
|
|
197
|
+
"dashboardUrl": "file:///path/to/.workflow/cognitive-dashboard.html"
|
|
198
|
+
}
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### `cognitive-configure-terminals`
|
|
202
|
+
|
|
203
|
+
Sets up terminal application mappings.
|
|
204
|
+
|
|
205
|
+
**Parameters:**
|
|
206
|
+
- `mappings` (object) - Terminal assignments per identity
|
|
207
|
+
|
|
208
|
+
**Returns:**
|
|
209
|
+
```json
|
|
210
|
+
{
|
|
211
|
+
"configured": true,
|
|
212
|
+
"terminals": {
|
|
213
|
+
"builder": "iTerm2",
|
|
214
|
+
"discoverer": "WezTerm",
|
|
215
|
+
"operator": "Kitty"
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
### `cognitive-get-insights`
|
|
221
|
+
|
|
222
|
+
Provides insights about your work patterns.
|
|
223
|
+
|
|
224
|
+
**Returns:**
|
|
225
|
+
```json
|
|
226
|
+
{
|
|
227
|
+
"dominantIdentity": "builder",
|
|
228
|
+
"balanceScore": 0.72,
|
|
229
|
+
"recommendations": [
|
|
230
|
+
"Consider more strategic thinking time (Strategist at 3%)",
|
|
231
|
+
"Experimentation is low - try Cursor for rapid prototyping"
|
|
232
|
+
],
|
|
233
|
+
"trends": {
|
|
234
|
+
"builderIncreasing": true,
|
|
235
|
+
"strategistDecreasing": true
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
## 🎨 Use Cases
|
|
241
|
+
|
|
242
|
+
### 1. Solo Founders
|
|
243
|
+
|
|
244
|
+
Map work modes to terminal apps for instant context switching:
|
|
245
|
+
- iTerm2 → Build features
|
|
246
|
+
- Kitty → Handle customer support
|
|
247
|
+
- Terminal → Write blog posts
|
|
248
|
+
- VS Code → Analyze competitors
|
|
249
|
+
|
|
250
|
+
### 2. Development Teams
|
|
251
|
+
|
|
252
|
+
Share cognitive workflow patterns:
|
|
253
|
+
- Analyze team commit patterns
|
|
254
|
+
- Identify cognitive strengths per team member
|
|
255
|
+
- Balance identity distribution across sprints
|
|
256
|
+
|
|
257
|
+
### 3. Content Creators
|
|
258
|
+
|
|
259
|
+
Track creation vs. promotion time:
|
|
260
|
+
- Discoverer (research) vs. Teacher (publishing)
|
|
261
|
+
- Balance ideation vs. execution
|
|
262
|
+
- Monitor content flywheel health
|
|
263
|
+
|
|
264
|
+
### 4. Researchers
|
|
265
|
+
|
|
266
|
+
Document exploration patterns:
|
|
267
|
+
- Deep research sessions (Discoverer)
|
|
268
|
+
- Hypothesis testing (Experimenter)
|
|
269
|
+
- Publishing findings (Teacher)
|
|
270
|
+
|
|
271
|
+
## 🔬 The Science Behind It
|
|
272
|
+
|
|
273
|
+
### Mental Palace Technique
|
|
274
|
+
|
|
275
|
+
Based on the ancient "Method of Loci":
|
|
276
|
+
- Each terminal = distinct room in mental palace
|
|
277
|
+
- Visual cues (colors) trigger cognitive shifts
|
|
278
|
+
- Spatial memory reinforces work mode
|
|
279
|
+
|
|
280
|
+
### Identity-Based Productivity
|
|
281
|
+
|
|
282
|
+
Inspired by James Clear's "Atomic Habits":
|
|
283
|
+
- Identity > Goals: "I am a Builder" vs. "I should code"
|
|
284
|
+
- Environment design: Terminal choice triggers identity
|
|
285
|
+
- Habit stacking: Terminal muscle memory
|
|
286
|
+
|
|
287
|
+
### Flow State Optimization
|
|
288
|
+
|
|
289
|
+
Minimize context switching costs:
|
|
290
|
+
- Single terminal per identity = clear boundaries
|
|
291
|
+
- Color coding reduces cognitive load
|
|
292
|
+
- Exit conditions guide smooth transitions
|
|
293
|
+
|
|
294
|
+
## 📚 Further Reading
|
|
295
|
+
|
|
296
|
+
- [Mental Palace History](https://en.wikipedia.org/wiki/Method_of_loci)
|
|
297
|
+
- [Identity-Based Habits](https://jamesclear.com/identity-based-habits)
|
|
298
|
+
- [Context Switching Research](https://www.apa.org/research/action/multitask)
|
|
299
|
+
|
|
300
|
+
## 🤝 Contributing
|
|
301
|
+
|
|
302
|
+
Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
303
|
+
|
|
304
|
+
## 📄 License
|
|
305
|
+
|
|
306
|
+
MIT © ThetaDriven
|
|
307
|
+
|
|
308
|
+
## 🔗 Links
|
|
309
|
+
|
|
310
|
+
- [GitHub Repository](https://github.com/wiber/thetadrivencoach/tree/main/packages/cognitive-workflow-mcp)
|
|
311
|
+
- [npm Package](https://www.npmjs.com/package/cognitive-workflow-mcp)
|
|
312
|
+
- [Documentation](https://thetacoach.biz/docs/cognitive-workflow)
|
|
313
|
+
- [Issue Tracker](https://github.com/wiber/thetadrivencoach/issues)
|
|
314
|
+
|
|
315
|
+
---
|
|
316
|
+
|
|
317
|
+
**Made with 🧠 by [ThetaDriven](https://thetacoach.biz)**
|