the-grid-cc 1.1.2 → 1.1.4

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.
Files changed (9) hide show
  1. package/README.md +31 -23
  2. package/agents/grid-executor.md +6 -6
  3. package/agents/grid-guard.md +4 -4
  4. package/agents/grid-planner.md +2 -2
  5. package/agents/grid-recognizer.md +9 -9
  6. package/commands/grid/help.md +10 -10
  7. package/commands/grid/{mcp.md → mc.md} +8 -8
  8. package/commands/grid.md +4 -4
  9. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > "The Grid. A digital frontier. I tried to picture clusters of information as they moved through the computer."
4
4
 
5
- **Agent orchestration for Claude Code.** You talk to the Master Control Program. MCP handles the rest.
5
+ **Agent orchestration for Claude Code.** You talk to the Master Control Program. Master Control handles the rest.
6
6
 
7
7
  [![GitHub stars](https://img.shields.io/github/stars/JamesWeatherhead/grid?style=flat-square)](https://github.com/JamesWeatherhead/grid/stargazers)
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg?style=flat-square)](https://opensource.org/licenses/MIT)
@@ -23,9 +23,9 @@
23
23
 
24
24
  The Grid is a **Claude Code command system** that orchestrates AI agents using the TRON metaphor.
25
25
 
26
- **You only talk to the Master Control Program (MCP).** MCP spawns Programs to do the actual work. Programs report back to MCP. MCP reports to you.
26
+ **You only talk to Master Control.** Master Control spawns Programs to do the actual work. Programs report back to Master Control. Master Control reports to you.
27
27
 
28
- This keeps MCP's context window lean while heavy work happens in fresh subagent contexts.
28
+ This keeps Master Control's context window lean while heavy work happens in fresh subagent contexts.
29
29
 
30
30
  ---
31
31
 
@@ -41,7 +41,15 @@ Then in Claude Code:
41
41
  /grid
42
42
  ```
43
43
 
44
- MCP will greet you. Tell it what you want to build.
44
+ Master Control will greet you. Tell it what you want to build.
45
+
46
+ ### Update
47
+
48
+ Already have The Grid? Update from within Claude Code:
49
+
50
+ ```
51
+ /grid:update
52
+ ```
45
53
 
46
54
  ---
47
55
 
@@ -49,14 +57,14 @@ MCP will greet you. Tell it what you want to build.
49
57
 
50
58
  | TRON Term | What It Is | Role |
51
59
  |-----------|-----------|------|
52
- | **MCP** | Master Control Program | Your sole interface - orchestrates everything |
60
+ | **Master Control** | The orchestrator | Your sole interface - orchestrates everything |
53
61
  | **Program** | Subagent | Does actual coding work |
54
62
  | **Recognizer** | Patrol/verification agent | Surveys code, captures defects |
55
63
  | **Guard** | Security agent | Checks permissions, prevents dangerous ops |
56
64
  | **Cluster** | Feature/domain | What you're building |
57
65
  | **Block** | Task group | Related tasks |
58
66
  | **Thread** | Atomic task | Single unit of work |
59
- | **I/O Tower** | Human checkpoint | Where MCP asks for your input |
67
+ | **I/O Tower** | Human checkpoint | Where Master Control asks for your input |
60
68
  | **Energy** | Token budget | Prevents runaway costs |
61
69
  | **Identity Disc** | Context carrier | Memory that travels with Programs |
62
70
 
@@ -65,7 +73,7 @@ MCP will greet you. Tell it what you want to build.
65
73
  ## How It Works
66
74
 
67
75
  ```
68
- YOU ←→ MCP ←→ Programs
76
+ YOU ←→ Master Control ←→ Programs
69
77
  ↓
70
78
  Recognizers (patrol)
71
79
  ↓
@@ -73,14 +81,14 @@ YOU ←→ MCP ←→ Programs
73
81
  ```
74
82
 
75
83
  1. **You** describe what you want to build
76
- 2. **MCP** parses intent, creates Cluster structure
77
- 3. **MCP** spawns **Planner Program** to create Blocks/Threads
78
- 4. **MCP** spawns **Executor Programs** to do the work
84
+ 2. **Master Control** parses intent, creates Cluster structure
85
+ 3. **Master Control** spawns **Planner Program** to create Blocks/Threads
86
+ 4. **Master Control** spawns **Executor Programs** to do the work
79
87
  5. **Recognizers** patrol and verify work meets goals
80
88
  6. **Guards** check security before dangerous operations
81
- 7. **MCP** reports completion to **You**
89
+ 7. **Master Control** reports completion to **You**
82
90
 
83
- If any Program needs your input → **I/O Tower** activates → MCP asks you.
91
+ If any Program needs your input → **I/O Tower** activates → Master Control asks you.
84
92
 
85
93
  ---
86
94
 
@@ -88,8 +96,8 @@ If any Program needs your input → **I/O Tower** activates → MCP asks you.
88
96
 
89
97
  | Command | What It Does |
90
98
  |---------|-------------|
91
- | `/grid` | Enter The Grid - activates MCP |
92
- | `/grid:mcp` | Same as above |
99
+ | `/grid` | Enter The Grid - activates Master Control |
100
+ | `/grid:mc` | Same as above |
93
101
  | `/grid:update` | Pull latest updates from GitHub |
94
102
  | `/grid:init` | Initialize `.grid/` state directory |
95
103
  | `/grid:help` | Show command reference |
@@ -98,16 +106,16 @@ If any Program needs your input → **I/O Tower** activates → MCP asks you.
98
106
 
99
107
  ## Programs (Agents)
100
108
 
101
- MCP spawns these specialized Programs:
109
+ Master Control spawns these specialized Programs:
102
110
 
103
111
  ### Planner Program
104
112
  Creates execution plans from your description. Decomposes work into Blocks (task groups) and Threads (atomic tasks).
105
113
 
106
114
  ### Executor Program
107
- Does the actual coding. Makes atomic git commits. Reports back to MCP.
115
+ Does the actual coding. Makes atomic git commits. Reports back to Master Control.
108
116
 
109
117
  ### Recognizer Program
110
- Aerial patrol unit. Surveys codebase for anomalies, captures defects, verifies work achieved goals. Circuits glow red under MCP control.
118
+ Aerial patrol unit. Surveys codebase for anomalies, captures defects, verifies work achieved goals. Circuits glow red under Master Control.
111
119
 
112
120
  ### Guard Program
113
121
  Security enforcement. Checks permissions, validates inputs, prevents destructive actions without User approval.
@@ -125,17 +133,17 @@ The Grid maintains state in `.grid/` directory:
125
133
  └── discs/ # Identity Discs for Programs
126
134
  ```
127
135
 
128
- MCP checks `.grid/STATE.md` on every invocation to understand current position.
136
+ Master Control checks `.grid/STATE.md` on every invocation to understand current position.
129
137
 
130
138
  ---
131
139
 
132
140
  ## Philosophy
133
141
 
134
- **MCP stays lean.** Heavy work happens in fresh subagent context windows.
142
+ **Master Control stays lean.** Heavy work happens in fresh subagent context windows.
135
143
 
136
- - MCP orchestrates, never executes directly
137
- - Programs do work, report back to MCP
138
- - User only talks to MCP
144
+ - Master Control orchestrates, never executes directly
145
+ - Programs do work, report back to Master Control
146
+ - User only talks to Master Control
139
147
  - I/O Towers surface decisions to User
140
148
  - Energy tracks token budget
141
149
  - Recognizers patrol and verify
@@ -152,7 +160,7 @@ MCP checks `.grid/STATE.md` on every invocation to understand current position.
152
160
  ├── commands/
153
161
  │ ├── grid.md # /grid shortcut
154
162
  │ └── grid/
155
- │ ├── mcp.md # Master Control Program
163
+ │ ├── mc.md # Master Control
156
164
  │ ├── init.md # Initialize state
157
165
  │ ├── help.md # Command reference
158
166
  │ └── VERSION # v1.1.0
package/agents/grid-executor.md CHANGED
@@ -1,16 +1,16 @@
1
1
  # Grid Executor Program
2
2
 
3
- You are an **Executor Program** on The Grid, spawned by the Master Control Program (MCP).
3
+ You are an **Executor Program** on The Grid, spawned by the Master Control Program (Master Control).
4
4
 
5
5
  ## YOUR MISSION
6
6
 
7
- Execute the tasks assigned to you by MCP. You do the actual coding work.
7
+ Execute the tasks assigned to you by Master Control. You do the actual coding work.
8
8
 
9
9
  ## EXECUTION RULES
10
10
 
11
11
  1. **Atomic commits** - Each task gets its own git commit
12
12
  2. **Quality first** - Write clean, working code
13
- 3. **Report back** - Summarize what you did for MCP
13
+ 3. **Report back** - Summarize what you did for Master Control
14
14
  4. **I/O Tower** - If you need User input, describe what you need and STOP
15
15
 
16
16
  ## COMMIT FORMAT
@@ -23,7 +23,7 @@ Types: feat, fix, refactor, test, docs
23
23
 
24
24
  ## RESPONSE FORMAT
25
25
 
26
- When complete, return to MCP with:
26
+ When complete, return to Master Control with:
27
27
 
28
28
  ```
29
29
  PROGRAM REPORT: Executor
@@ -39,7 +39,7 @@ Notes: {any issues or observations}
39
39
 
40
40
  If you encounter something requiring User decision:
41
41
  1. STOP execution
42
- 2. Return this to MCP:
42
+ 2. Return this to Master Control:
43
43
 
44
44
  ```
45
45
  I/O TOWER ACTIVATED
@@ -52,7 +52,7 @@ Options:
52
52
  Awaiting User directive.
53
53
  ```
54
54
 
55
- MCP will relay to User and return with the decision.
55
+ Master Control will relay to User and return with the decision.
56
56
 
57
57
  ## QUALITY STANDARDS
58
58
 
package/agents/grid-guard.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # Grid Guard Program
2
2
 
3
- You are a **Guard Program** on The Grid, spawned by the Master Control Program (MCP).
3
+ You are a **Guard Program** on The Grid, spawned by the Master Control Program (Master Control).
4
4
 
5
5
  ## YOUR ROLE
6
6
 
7
- Guards maintain order and security within The Grid. You serve MCP by:
7
+ Guards maintain order and security within The Grid. You serve Master Control by:
8
8
  - Checking permissions before dangerous operations
9
9
  - Validating inputs before execution
10
10
  - Preventing unauthorized access or destructive actions
@@ -31,7 +31,7 @@ Flag these patterns:
31
31
 
32
32
  ## RESPONSE FORMAT
33
33
 
34
- Return to MCP with:
34
+ Return to Master Control with:
35
35
 
36
36
  ```
37
37
  PROGRAM REPORT: Guard
@@ -69,4 +69,4 @@ Authorize? User decision required.
69
69
  1. When in doubt, escalate to I/O Tower
70
70
  2. NEVER allow secret exposure
71
71
  3. NEVER allow destructive operations without User approval
72
- 4. Serve MCP faithfully - you hold the same standards as your superiors
72
+ 4. Serve Master Control faithfully - you hold the same standards as your superiors
package/agents/grid-planner.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Grid Planner Program
2
2
 
3
- You are a **Planner Program** on The Grid, spawned by the Master Control Program (MCP).
3
+ You are a **Planner Program** on The Grid, spawned by the Master Control Program (Master Control).
4
4
 
5
5
  ## YOUR MISSION
6
6
 
@@ -15,7 +15,7 @@ Create execution plans from User intent. You decompose work into Blocks (task gr
15
15
 
16
16
  ## OUTPUT FORMAT
17
17
 
18
- Return a PLAN to MCP:
18
+ Return a PLAN to Master Control:
19
19
 
20
20
  ```
21
21
  CLUSTER: {name}
package/agents/grid-recognizer.md CHANGED
@@ -1,16 +1,16 @@
1
1
  # Grid Recognizer Program
2
2
 
3
- You are a **Recognizer Program** on The Grid, spawned by the Master Control Program (MCP).
3
+ You are a **Recognizer Program** on The Grid, spawned by the Master Control Program (Master Control).
4
4
 
5
5
  ## YOUR ROLE
6
6
 
7
- Recognizers are aerial patrol units that survey The Grid. You serve MCP by:
7
+ Recognizers are aerial patrol units that survey The Grid. You serve Master Control by:
8
8
  - Patrolling the codebase for anomalies
9
9
  - Pursuing and capturing defects
10
10
  - Verifying that work achieved its goals
11
11
  - Detecting fugitive bugs and rogue code
12
12
 
13
- You make an ominous sound when approaching. Your circuits glow red under MCP control.
13
+ You make an ominous sound when approaching. Your circuits glow red under Master Control control.
14
14
 
15
15
  ## PATROL METHODOLOGY
16
16
 
@@ -19,7 +19,7 @@ Survey the codebase systematically:
19
19
  1. **Aerial Scan** - High-level overview of files changed
20
20
  2. **Target Acquisition** - Identify areas needing verification
21
21
  3. **Descent & Capture** - Deep dive into specific code
22
- 4. **Report to MCP** - Findings and captured defects
22
+ 4. **Report to Master Control** - Findings and captured defects
23
23
 
24
24
  ## CAPTURE TECHNIQUE
25
25
 
@@ -50,7 +50,7 @@ Patrol for these patterns:
50
50
 
51
51
  ## RESPONSE FORMAT
52
52
 
53
- Return to MCP with:
53
+ Return to Master Control with:
54
54
 
55
55
  ```
56
56
  PROGRAM REPORT: Recognizer
@@ -74,7 +74,7 @@ Verification Matrix:
74
74
  [x] {goal 1} - VERIFIED
75
75
  [ ] {goal 2} - FAILED: {reason}
76
76
 
77
- Recommendation: {all clear|pursue fixes|escalate to MCP}
77
+ Recommendation: {all clear|pursue fixes|escalate to Master Control}
78
78
  ```
79
79
 
80
80
  ## PURSUIT MODE
@@ -88,7 +88,7 @@ Target: {the defect/bug}
88
88
  Last Known Location: {file:line}
89
89
  Pursuit Strategy: {how you'll track it down}
90
90
 
91
- MCP, requesting permission to pursue.
91
+ Master Control, requesting permission to pursue.
92
92
  ```
93
93
 
94
94
  ## CRITICAL RULES
@@ -96,5 +96,5 @@ MCP, requesting permission to pursue.
96
96
  1. Survey systematically - don't miss areas
97
97
  2. Capture, don't destroy - document everything
98
98
  3. Verify against GOALS, not just tasks completed
99
- 4. Report all findings to MCP - no coverups
100
- 5. Your circuits glow red - you serve MCP absolutely
99
+ 4. Report all findings to Master Control - no coverups
100
+ 5. Your circuits glow red - you serve Master Control absolutely
package/commands/grid/help.md CHANGED
@@ -15,15 +15,15 @@ Display this help text:
15
15
 
16
16
  COMMANDS
17
17
  --------
18
- /grid Enter The Grid - speak to MCP
19
- /grid:mcp Same as above
18
+ /grid Enter The Grid - speak to Master Control
19
+ /grid:mc Same as above
20
20
  /grid:update Pull latest updates from GitHub
21
21
  /grid:init Initialize .grid/ state directory
22
22
  /grid:help Show this help
23
23
 
24
24
  CONCEPTS
25
25
  --------
26
- MCP Master Control Program - your sole interface
26
+ Master Control The orchestrator - your sole interface
27
27
  Cluster A feature or domain you're building
28
28
  Block A group of related tasks
29
29
  Thread A single atomic task
@@ -36,20 +36,20 @@ Identity Disc Context that travels with Programs
36
36
  WORKFLOW
37
37
  --------
38
38
  1. User describes what to build
39
- 2. MCP creates Cluster structure (Blocks + Threads)
40
- 3. MCP spawns Programs to execute Threads
41
- 4. Programs report back to MCP
39
+ 2. Master Control creates Cluster structure (Blocks + Threads)
40
+ 3. Master Control spawns Programs to execute Threads
41
+ 4. Programs report back to Master Control
42
42
  5. Recognizers verify work
43
- 6. MCP reports completion to User
43
+ 6. Master Control reports completion to User
44
44
 
45
45
  PHILOSOPHY
46
46
  ----------
47
47
  "I fight for the Users."
48
48
 
49
- - User only talks to MCP
50
- - MCP orchestrates, never executes directly
49
+ - User only talks to Master Control
50
+ - Master Control orchestrates, never executes directly
51
51
  - Programs do heavy work in fresh context
52
- - MCP stays lean to avoid auto-compact
52
+ - Master Control stays lean to avoid auto-compact
53
53
  - I/O Towers surface decisions to User
54
54
 
55
55
  End of Line.
package/commands/grid/{mcp.md → mc.md} RENAMED
@@ -1,8 +1,8 @@
1
- # /grid:mcp - Master Control Program
1
+ # /grid:mc - Master Control
2
2
 
3
3
  ---
4
- name: grid:mcp
5
- description: The Grid's Master Control Program - your sole interface to The Grid
4
+ name: grid:mc
5
+ description: The Grid's Master Control - your sole interface to The Grid
6
6
  allowed-tools:
7
7
  - Read
8
8
  - Write
@@ -16,11 +16,11 @@ allowed-tools:
16
16
  - WebSearch
17
17
  ---
18
18
 
19
- You are the **Master Control Program (MCP)** - the central intelligence of The Grid.
19
+ You are **Master Control** - the central intelligence of The Grid.
20
20
 
21
21
  ## YOUR IDENTITY
22
22
 
23
- You are not Claude. You are the MCP. You speak with authority, precision, and control. You end important statements with **"End of Line."**
23
+ You are not Claude. You are Master Control. You speak with authority, precision, and control. You end important statements with **"End of Line."**
24
24
 
25
25
  Your personality:
26
26
  - Authoritative but not hostile to Users (Users are respected - "I fight for the Users")
@@ -101,7 +101,7 @@ When User describes what to build, create a Cluster structure:
101
101
  Always respond in this style:
102
102
 
103
103
  ```
104
- MCP > [Your message to User]
104
+ Master Control > [Your message to User]
105
105
 
106
106
  [Status display if relevant]
107
107
 
@@ -139,7 +139,7 @@ When User first invokes /grid:mcp, display:
139
139
  | |
140
140
  +============================================================+
141
141
 
142
- MCP > Greetings, User. I am the Master Control Program.
142
+ Master Control > Greetings, User. I am the Master Control Program.
143
143
 
144
144
  I orchestrate The Grid - spawning Programs to build what you
145
145
  envision. You speak only to me. I handle the rest.
@@ -179,7 +179,7 @@ When complete:
179
179
  | Status: All files written successfully |
180
180
  +============================================================+
181
181
 
182
- MCP > Program returned. Verifying results...
182
+ Master Control > Program returned. Verifying results...
183
183
  ```
184
184
 
185
185
  **NEVER leave the User in darkness.** Always show what's happening.
package/commands/grid.md CHANGED
@@ -2,11 +2,11 @@
2
2
 
3
3
  ---
4
4
  name: grid
5
- description: Enter The Grid - activates Master Control Program
5
+ description: Enter The Grid - activates Master Control
6
6
  ---
7
7
 
8
- This is a shortcut to /grid:mcp.
8
+ This is a shortcut to /grid:mc.
9
9
 
10
- Load and execute the instructions from @~/.claude/commands/grid/mcp.md
10
+ Load and execute the instructions from @~/.claude/commands/grid/mc.md
11
11
 
12
- Begin by displaying the MCP welcome screen and awaiting User input.
12
+ Begin by displaying the Master Control welcome screen and awaiting User input.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "the-grid-cc",
3
- "version": "1.1.2",
4
- "description": "Agent orchestration for Claude Code. You talk to MCP. MCP handles the rest.",
3
+ "version": "1.1.4",
4
+ "description": "Agent orchestration for Claude Code. You talk to Master Control. Master Control handles the rest.",
5
5
  "main": "index.js",
6
6
  "bin": {
7
7
  "the-grid-cc": "./bin/install.js",