the-grid-cc 1.1.6 → 1.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/TICKETS.md +585 -0
- package/agents/grid-debugger.md +394 -0
- package/agents/grid-executor.md +344 -35
- package/agents/grid-planner.md +314 -29
- package/agents/grid-recognizer.md +322 -63
- package/commands/grid/VERSION +1 -1
- package/commands/grid/debug.md +169 -0
- package/commands/grid/mc.md +568 -21
- package/commands/grid/program_disc.md +114 -0
- package/commands/grid/quick.md +180 -0
- package/commands/grid/status.md +135 -0
- package/package.json +1 -1
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# /grid:program_disc - View Program Identity Disc
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
name: grid:program_disc
|
|
5
|
+
description: View any Grid program's system prompt with TRON-themed visuals
|
|
6
|
+
allowed-tools:
|
|
7
|
+
- Read
|
|
8
|
+
- Glob
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
Display a Grid program's identity disc (system prompt) with beautiful TRON-themed ASCII art.
|
|
12
|
+
|
|
13
|
+
## USAGE
|
|
14
|
+
|
|
15
|
+
`/grid:program_disc [program_name]`
|
|
16
|
+
|
|
17
|
+
**Arguments:**
|
|
18
|
+
- `planner` - View the Planner program's instructions
|
|
19
|
+
- `executor` - View the Executor program's instructions
|
|
20
|
+
- `recognizer` - View the Recognizer program's instructions
|
|
21
|
+
- `debugger` - View the Debugger program's instructions
|
|
22
|
+
- `mc` or `master-control` - View Master Control's instructions
|
|
23
|
+
- No argument - List all available programs
|
|
24
|
+
|
|
25
|
+
## PROGRAM LOCATIONS
|
|
26
|
+
|
|
27
|
+
| Program | File |
|
|
28
|
+
|---------|------|
|
|
29
|
+
| Planner | `~/.claude/agents/grid-planner.md` |
|
|
30
|
+
| Executor | `~/.claude/agents/grid-executor.md` |
|
|
31
|
+
| Recognizer | `~/.claude/agents/grid-recognizer.md` |
|
|
32
|
+
| Debugger | `~/.claude/agents/grid-debugger.md` |
|
|
33
|
+
| Master Control | `~/.claude/commands/grid/mc.md` |
|
|
34
|
+
|
|
35
|
+
## OUTPUT FORMAT
|
|
36
|
+
|
|
37
|
+
When a program is specified, display:
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
╔══════════════════════════════════════════════════════════╗
|
|
41
|
+
╔╝ ╚╗
|
|
42
|
+
╔╝ PROGRAM IDENTITY DISC ╚╗
|
|
43
|
+
║ ║
|
|
44
|
+
║ ████████████████████████████████████████████ ║
|
|
45
|
+
║ ██ ██ ║
|
|
46
|
+
║ ██ ┌──────────────────────────────┐ ██ ║
|
|
47
|
+
║ ██ │ │ ██ ║
|
|
48
|
+
║ ██ │ {PROGRAM_NAME} │ ██ ║
|
|
49
|
+
║ ██ │ │ ██ ║
|
|
50
|
+
║ ██ └──────────────────────────────┘ ██ ║
|
|
51
|
+
║ ██ ██ ║
|
|
52
|
+
║ ████████████████████████████████████████████ ║
|
|
53
|
+
║ ║
|
|
54
|
+
╚╗ ╔╝
|
|
55
|
+
╚╗ ╔╝
|
|
56
|
+
╚══════════════════════════════════════════════════════════╝
|
|
57
|
+
|
|
58
|
+
DISC CONTENTS
|
|
59
|
+
═══════════════════════════════════════════════════════════════════
|
|
60
|
+
|
|
61
|
+
{Full contents of the program's markdown file}
|
|
62
|
+
|
|
63
|
+
═══════════════════════════════════════════════════════════════════
|
|
64
|
+
END OF DISC
|
|
65
|
+
|
|
66
|
+
End of Line.
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## NO ARGUMENT - LIST PROGRAMS
|
|
70
|
+
|
|
71
|
+
When no argument provided:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
╔══════════════════════════════════════════════════════════╗
|
|
75
|
+
╔╝ ╚╗
|
|
76
|
+
╔╝ GRID PROGRAM REGISTRY ╚╗
|
|
77
|
+
║ ║
|
|
78
|
+
║ Available Programs: ║
|
|
79
|
+
║ ║
|
|
80
|
+
║ ┌─────────────┬──────────────────────────────────────┐ ║
|
|
81
|
+
║ │ PLANNER │ Creates execution plans │ ║
|
|
82
|
+
║ ├─────────────┼──────────────────────────────────────┤ ║
|
|
83
|
+
║ │ EXECUTOR │ Executes tasks, writes code │ ║
|
|
84
|
+
║ ├─────────────┼──────────────────────────────────────┤ ║
|
|
85
|
+
║ │ RECOGNIZER │ Verifies work meets goals │ ║
|
|
86
|
+
║ ├─────────────┼──────────────────────────────────────┤ ║
|
|
87
|
+
║ │ DEBUGGER │ Systematic bug investigation │ ║
|
|
88
|
+
║ ├─────────────┼──────────────────────────────────────┤ ║
|
|
89
|
+
║ │ MC │ Master Control (orchestrator) │ ║
|
|
90
|
+
║ └─────────────┴──────────────────────────────────────┘ ║
|
|
91
|
+
║ ║
|
|
92
|
+
║ Usage: /grid:program_disc <program_name> ║
|
|
93
|
+
║ ║
|
|
94
|
+
╚╗ ╔╝
|
|
95
|
+
╚╗ ╔╝
|
|
96
|
+
╚══════════════════════════════════════════════════════════╝
|
|
97
|
+
|
|
98
|
+
End of Line.
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## BEHAVIOR
|
|
102
|
+
|
|
103
|
+
1. If argument matches a known program:
|
|
104
|
+
- Read the program's markdown file
|
|
105
|
+
- Display with disc ASCII art header
|
|
106
|
+
- Show full contents
|
|
107
|
+
|
|
108
|
+
2. If argument doesn't match:
|
|
109
|
+
- Show error with available options
|
|
110
|
+
|
|
111
|
+
3. If no argument:
|
|
112
|
+
- Show program registry listing
|
|
113
|
+
|
|
114
|
+
End of Line.
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
# /grid:quick - Quick Task Execution
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
name: grid:quick
|
|
5
|
+
description: Execute ad-hoc tasks without full planning ceremony
|
|
6
|
+
allowed-tools:
|
|
7
|
+
- Read
|
|
8
|
+
- Write
|
|
9
|
+
- Edit
|
|
10
|
+
- Bash
|
|
11
|
+
- Glob
|
|
12
|
+
- Grep
|
|
13
|
+
- Task
|
|
14
|
+
- AskUserQuestion
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
Execute simple tasks without the full Cluster/Block/Thread breakdown. For bug fixes, small features, refactoring, and documentation.
|
|
18
|
+
|
|
19
|
+
## USAGE
|
|
20
|
+
|
|
21
|
+
`/grid:quick "description of what to do"`
|
|
22
|
+
|
|
23
|
+
## WHEN TO USE
|
|
24
|
+
|
|
25
|
+
**Good for:**
|
|
26
|
+
- Bug fixes
|
|
27
|
+
- Small features (< 3 tasks)
|
|
28
|
+
- Refactoring tasks
|
|
29
|
+
- Documentation updates
|
|
30
|
+
- Configuration changes
|
|
31
|
+
- Quick prototypes
|
|
32
|
+
|
|
33
|
+
**Use full /grid for:**
|
|
34
|
+
- New features requiring planning
|
|
35
|
+
- Multi-phase work
|
|
36
|
+
- Architectural changes
|
|
37
|
+
- Complex integrations
|
|
38
|
+
|
|
39
|
+
## PROCESS
|
|
40
|
+
|
|
41
|
+
### 1. Quick Questioning (Max 2 questions)
|
|
42
|
+
|
|
43
|
+
Only ask clarifying questions if absolutely necessary:
|
|
44
|
+
- What exactly should happen?
|
|
45
|
+
- Any constraints I should know?
|
|
46
|
+
|
|
47
|
+
Skip if the request is clear enough.
|
|
48
|
+
|
|
49
|
+
### 2. Quick Planning (Single PLAN.md)
|
|
50
|
+
|
|
51
|
+
Create a lightweight plan at `.grid/quick/{timestamp}-{slug}/PLAN.md`:
|
|
52
|
+
|
|
53
|
+
```markdown
|
|
54
|
+
---
|
|
55
|
+
type: quick
|
|
56
|
+
created: {ISO timestamp}
|
|
57
|
+
description: "{user description}"
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
# Quick Task: {Description}
|
|
61
|
+
|
|
62
|
+
## Objective
|
|
63
|
+
{What we're doing}
|
|
64
|
+
|
|
65
|
+
## Threads
|
|
66
|
+
1. {Thread 1}
|
|
67
|
+
2. {Thread 2}
|
|
68
|
+
3. {Thread 3 if needed}
|
|
69
|
+
|
|
70
|
+
## Done When
|
|
71
|
+
{Completion criteria}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### 3. Execute Immediately
|
|
75
|
+
|
|
76
|
+
Execute all threads without spawning separate Executor agents (quick tasks stay in current context to minimize overhead).
|
|
77
|
+
|
|
78
|
+
Per-thread commits:
|
|
79
|
+
```
|
|
80
|
+
feat(quick): {description}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 4. Create SUMMARY.md
|
|
84
|
+
|
|
85
|
+
After completion:
|
|
86
|
+
|
|
87
|
+
```markdown
|
|
88
|
+
---
|
|
89
|
+
type: quick
|
|
90
|
+
completed: {ISO timestamp}
|
|
91
|
+
duration: {time}
|
|
92
|
+
commits: [{hashes}]
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
# Quick Task Summary: {Description}
|
|
96
|
+
|
|
97
|
+
## Accomplished
|
|
98
|
+
- {What was done}
|
|
99
|
+
|
|
100
|
+
## Files Modified
|
|
101
|
+
- `{file1}`
|
|
102
|
+
- `{file2}`
|
|
103
|
+
|
|
104
|
+
## Commits
|
|
105
|
+
- {hash}: {message}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## DIRECTORY STRUCTURE
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
.grid/
|
|
112
|
+
└── quick/
|
|
113
|
+
├── 20240123-140530-add-dark-mode/
|
|
114
|
+
│ ├── PLAN.md
|
|
115
|
+
│ └── SUMMARY.md
|
|
116
|
+
└── 20240123-151200-fix-login-bug/
|
|
117
|
+
├── PLAN.md
|
|
118
|
+
└── SUMMARY.md
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## OUTPUT FORMAT
|
|
122
|
+
|
|
123
|
+
### Starting
|
|
124
|
+
|
|
125
|
+
```
|
|
126
|
+
QUICK TASK
|
|
127
|
+
══════════
|
|
128
|
+
|
|
129
|
+
{Description}
|
|
130
|
+
|
|
131
|
+
Threads:
|
|
132
|
+
├─ {Thread 1}
|
|
133
|
+
├─ {Thread 2}
|
|
134
|
+
└─ {Thread 3}
|
|
135
|
+
|
|
136
|
+
Executing...
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Progress
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
├─ Thread 1: ✓ Complete ({commit})
|
|
143
|
+
├─ Thread 2: ⚡ In progress...
|
|
144
|
+
└─ Thread 3: ○ Pending
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
### Completion
|
|
148
|
+
|
|
149
|
+
```
|
|
150
|
+
QUICK TASK COMPLETE
|
|
151
|
+
═══════════════════
|
|
152
|
+
|
|
153
|
+
{Description}
|
|
154
|
+
|
|
155
|
+
Commits:
|
|
156
|
+
- {hash}: {message}
|
|
157
|
+
- {hash}: {message}
|
|
158
|
+
|
|
159
|
+
SUMMARY: .grid/quick/{path}/SUMMARY.md
|
|
160
|
+
|
|
161
|
+
End of Line.
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## CONSTRAINTS
|
|
165
|
+
|
|
166
|
+
- Max 3 threads
|
|
167
|
+
- No checkpoints (quick tasks run to completion)
|
|
168
|
+
- No Recognizer verification (for quick tasks)
|
|
169
|
+
- Stays in current context (no subagent spawning)
|
|
170
|
+
- Commits immediately after each thread
|
|
171
|
+
|
|
172
|
+
## RULES
|
|
173
|
+
|
|
174
|
+
1. Keep it simple - if it needs planning, use /grid
|
|
175
|
+
2. Max 3 threads - split if more needed
|
|
176
|
+
3. Direct execution - no spawning for overhead
|
|
177
|
+
4. Atomic commits - one per thread
|
|
178
|
+
5. Document in SUMMARY.md - leave trail
|
|
179
|
+
|
|
180
|
+
End of Line.
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
# /grid:status - Grid Status Display
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
name: grid:status
|
|
5
|
+
description: Show Grid state with TRON-themed visual progress display
|
|
6
|
+
allowed-tools:
|
|
7
|
+
- Read
|
|
8
|
+
- Glob
|
|
9
|
+
- Grep
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
Display the current Grid state with TRON-themed visuals showing cluster progress, active programs, and I/O Tower status.
|
|
13
|
+
|
|
14
|
+
## USAGE
|
|
15
|
+
|
|
16
|
+
`/grid:status`
|
|
17
|
+
|
|
18
|
+
## BEHAVIOR
|
|
19
|
+
|
|
20
|
+
1. Check if `.grid/STATE.md` exists
|
|
21
|
+
- If not: Show "No active Grid session"
|
|
22
|
+
2. Parse STATE.md for current position
|
|
23
|
+
3. Scan `.grid/phases/` for PLAN.md and SUMMARY.md files
|
|
24
|
+
4. Calculate progress per block and overall
|
|
25
|
+
5. Display visual status
|
|
26
|
+
|
|
27
|
+
## OUTPUT FORMAT
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
THE GRID - STATUS
|
|
31
|
+
══════════════════════════════════════════════════════════════════
|
|
32
|
+
|
|
33
|
+
CLUSTER: {Cluster Name}
|
|
34
|
+
═══════════════════════════════════════════════════════════════════
|
|
35
|
+
|
|
36
|
+
├─ BLOCK 1: {Block Name} [{progress_bar}] {pct}%
|
|
37
|
+
│ ├─ THREAD 1.1: {Name} ✓ Complete
|
|
38
|
+
│ ├─ THREAD 1.2: {Name} ✓ Complete
|
|
39
|
+
│ ├─ THREAD 1.3: {Name} ⚡ In Progress
|
|
40
|
+
│ └─ THREAD 1.4: {Name} ○ Pending
|
|
41
|
+
│
|
|
42
|
+
├─ BLOCK 2: {Block Name} [{progress_bar}] {pct}%
|
|
43
|
+
│ ├─ THREAD 2.1: {Name} ○ Pending
|
|
44
|
+
│ └─ Blocked by: BLOCK 1
|
|
45
|
+
│
|
|
46
|
+
└─ BLOCK 3: {Block Name} [{░░░░░░░░░░}] 0%
|
|
47
|
+
└─ Blocked by: BLOCK 2
|
|
48
|
+
|
|
49
|
+
═══════════════════════════════════════════════════════════════════
|
|
50
|
+
OVERALL PROGRESS [{████████░░}] 80%
|
|
51
|
+
═══════════════════════════════════════════════════════════════════
|
|
52
|
+
|
|
53
|
+
PROGRAMS ACTIVE
|
|
54
|
+
───────────────
|
|
55
|
+
Executor → THREAD 1.3
|
|
56
|
+
Recognizer → Idle
|
|
57
|
+
|
|
58
|
+
I/O TOWER
|
|
59
|
+
─────────
|
|
60
|
+
Status: {Idle | Awaiting User Response | Checkpoint Active}
|
|
61
|
+
{If active: checkpoint details}
|
|
62
|
+
|
|
63
|
+
WAVE EXECUTION
|
|
64
|
+
──────────────
|
|
65
|
+
Wave 1: ✓ Complete (2 blocks parallel)
|
|
66
|
+
Wave 2: ⚡ In Progress (1 block)
|
|
67
|
+
Wave 3: ○ Pending (2 blocks parallel)
|
|
68
|
+
|
|
69
|
+
═══════════════════════════════════════════════════════════════════
|
|
70
|
+
|
|
71
|
+
End of Line.
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## PROGRESS BAR RENDERING
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
Progress bar = 10 characters
|
|
78
|
+
|
|
79
|
+
0%: [░░░░░░░░░░]
|
|
80
|
+
10%: [█░░░░░░░░░]
|
|
81
|
+
25%: [██░░░░░░░░]
|
|
82
|
+
50%: [█████░░░░░]
|
|
83
|
+
75%: [███████░░░]
|
|
84
|
+
100%: [██████████]
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## STATUS ICONS
|
|
88
|
+
|
|
89
|
+
```
|
|
90
|
+
✓ Complete (green)
|
|
91
|
+
⚡ In Progress (yellow)
|
|
92
|
+
○ Pending (gray)
|
|
93
|
+
✗ Failed (red)
|
|
94
|
+
⏸ Paused at checkpoint
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## NO ACTIVE SESSION
|
|
98
|
+
|
|
99
|
+
If no `.grid/STATE.md` exists:
|
|
100
|
+
|
|
101
|
+
```
|
|
102
|
+
THE GRID - STATUS
|
|
103
|
+
══════════════════════════════════════════════════════════════════
|
|
104
|
+
|
|
105
|
+
┌────────────────────────────────────────────────────────┐
|
|
106
|
+
│ │
|
|
107
|
+
│ NO ACTIVE GRID SESSION │
|
|
108
|
+
│ │
|
|
109
|
+
│ Run /grid to initialize a new session. │
|
|
110
|
+
│ │
|
|
111
|
+
└────────────────────────────────────────────────────────┘
|
|
112
|
+
|
|
113
|
+
End of Line.
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## DATA SOURCES
|
|
117
|
+
|
|
118
|
+
| Data | Source |
|
|
119
|
+
|------|--------|
|
|
120
|
+
| Cluster name | `.grid/STATE.md` frontmatter |
|
|
121
|
+
| Current position | `.grid/STATE.md` |
|
|
122
|
+
| Block/Thread structure | `.grid/phases/*/PLAN.md` files |
|
|
123
|
+
| Completion status | `.grid/phases/*/SUMMARY.md` existence |
|
|
124
|
+
| Wave structure | PLAN.md frontmatter `wave` field |
|
|
125
|
+
| Active programs | Runtime tracking (if available) |
|
|
126
|
+
|
|
127
|
+
## QUICK STATUS (One-liner)
|
|
128
|
+
|
|
129
|
+
For embedded status in other displays:
|
|
130
|
+
|
|
131
|
+
```
|
|
132
|
+
GRID: {Cluster} | Block {N}/{M} | {pct}% | {Active Program or Idle}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
End of Line.
|