renn-studio 0.6.0 → 0.6.2

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/LICENSE CHANGED
@@ -1,22 +1,22 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Lex Christopherson
4
- Copyright (c) 2026 Ash
5
-
6
- Permission is hereby granted, free of charge, to any person obtaining a copy
7
- of this software and associated documentation files (the "Software"), to deal
8
- in the Software without restriction, including without limitation the rights
9
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- copies of the Software, and to permit persons to whom the Software is
11
- furnished to do so, subject to the following conditions:
12
-
13
- The above copyright notice and this permission notice shall be included in all
14
- copies or substantial portions of the Software.
15
-
16
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Lex Christopherson
4
+ Copyright (c) 2026 Ash
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
package/README.md CHANGED
@@ -1,36 +1,36 @@
1
- # RENN — Grow Ideas into Shipped Software
2
-
3
- A stage-driven, context-engineered agentic code execution system for Claude Code, OpenCode, and Gemini.
4
-
5
- RENN gives your AI coding assistant a structured workflow: stages, tasks, state management, and specialized agents — so it builds your project methodically instead of wandering. From mud to lotus through structured runs.
6
-
7
- ## Install
8
-
9
- ```bash
10
- npx renn
11
- ```
12
-
13
- The installer walks you through setup — pick global or local install, choose your AI tool (Claude Code, OpenCode, Gemini, or all), and RENN copies the commands, agents, and workflows into the right place.
14
-
15
- ## What you get
16
-
17
- - **25 slash commands** — structured actions like `/renn.run-stage`, `/renn.add-todo`, `/renn.audit`
18
- - **11 specialized agents** — architect, runner, detective, auditor, and more
19
- - **15 workflows** — reusable processes the commands delegate to
20
- - **State files** — `pulse.md` (living memory), `track.md` (stage structure), `brief.md` (project context)
21
-
22
- ## How it works
23
-
24
- 1. **Initialize** — `/renn.start` sets up your project with a brief and stage structure
25
- 2. **Plan** — `/renn.plan-stage` breaks a stage into concrete tasks
26
- 3. **Build** — `/renn.run-stage` executes tasks with autonomous agents
27
- 4. **Track** — State files keep context across sessions so nothing gets lost
28
-
29
- ## Requirements
30
-
31
- - Node.js 16.7+
32
- - One of: Claude Code, OpenCode, or Gemini CLI
33
-
34
- ## License
35
-
36
- [MIT](LICENSE)
1
+ # RENN — Grow Ideas into Shipped Software
2
+
3
+ A stage-driven, context-engineered agentic code execution system for Claude Code, OpenCode, and Gemini.
4
+
5
+ RENN gives your AI coding assistant a structured workflow: stages, tasks, state management, and specialized agents — so it builds your project methodically instead of wandering. From mud to lotus through structured runs.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npx renn-studio
11
+ ```
12
+
13
+ The installer walks you through setup — pick global or local install, choose your AI tool (Claude Code, OpenCode, Gemini, or all), and RENN copies the commands, agents, and workflows into the right place.
14
+
15
+ ## What you get
16
+
17
+ - **25 slash commands** — structured actions like `/renn.run-stage`, `/renn.add-todo`, `/renn.audit`
18
+ - **11 specialized agents** — architect, runner, detective, auditor, and more
19
+ - **15 workflows** — reusable processes the commands delegate to
20
+ - **State files** — `pulse.md` (living memory), `track.md` (stage structure), `brief.md` (project context)
21
+
22
+ ## How it works
23
+
24
+ 1. **Initialize** — `/renn.start` sets up your project with a brief and stage structure
25
+ 2. **Plan** — `/renn.plan-stage` breaks a stage into concrete tasks
26
+ 3. **Build** — `/renn.run-stage` executes tasks with autonomous agents
27
+ 4. **Track** — State files keep context across sessions so nothing gets lost
28
+
29
+ ## Requirements
30
+
31
+ - Node.js 16.7+
32
+ - One of: Claude Code, OpenCode, or Gemini CLI
33
+
34
+ ## License
35
+
36
+ [MIT](LICENSE)
@@ -19,7 +19,7 @@ Output ONLY the reference content below. Do NOT add:
19
19
  <reference>
20
20
  # RENN Command Reference
21
21
 
22
- **RENN** (Agentic Code Engine) creates hierarchical project plans optimized for solo agentic development with Claude Code.
22
+ **RENN** creates hierarchical project plans optimized for solo agentic development with Claude Code.
23
23
 
24
24
  ## Quick Start
25
25
 
@@ -45,7 +45,7 @@ const child = spawn(
45
45
 
46
46
  let latest = null;
47
47
  try {
48
- latest = execSync('npm view renn version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
48
+ latest = execSync('npm view renn-studio version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
49
49
  } catch (e) {}
50
50
 
51
51
  const result = {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "renn-studio",
3
- "version": "0.6.0",
3
+ "version": "0.6.2",
4
4
  "description": "Grow ideas into shipped software",
5
5
  "bin": {
6
6
  "renn": "bin/install.js"
@@ -1,189 +1,192 @@
1
- <ui_patterns>
2
-
3
- Visual patterns for user-facing RENN output. Orchestrators @-reference this file.
4
-
5
- ## Brand Identity
6
-
7
- - **Name:** RENN (uppercase in prose, lowercase in code/CLI)
8
- - **Tagline:** "Grow ideas into shipped software"
9
- - **Symbol:** Lotus (U+1FAB7 with U+2740 fallback)
10
- - **Philosophy:** From mud to lotus through structured runs
11
-
12
- ### Color Palette
13
-
14
- | Role | ANSI Code | Hex | Usage |
15
- |------|-----------|-----|-------|
16
- | Primary | `\e[38;5;218m` | #FFB7C5 | Banner text, highlights |
17
- | Secondary | `\e[38;5;255m` | #EEEEEE | Body text |
18
- | Accent | `\e[38;5;213m` | #FF79C6 | Status symbols, emphasis |
19
- | Success | `\e[38;5;114m` | #98C379 | Completion indicators |
20
- | Warning | `\e[38;5;221m` | #E5C07B | Caution states |
21
- | Error | `\e[38;5;204m` | #E06C75 | Failure states |
22
- | Dim | `\e[38;5;245m` | #8C8C8C | Muted text, hints |
23
-
24
- ### Naming Rules
25
-
26
- - **Prose/docs:** RENN (uppercase)
27
- - **CLI commands:** `renn` (lowercase)
28
- - **Slash commands:** `/renn.command-name`
29
- - **Agents:** `renn-agent-name`
30
- - **Package name:** `renn`
31
-
32
- ---
33
-
34
- ## Stage Banners
35
-
36
- Use for major workflow transitions.
37
-
38
- ```
39
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
40
- RENN > {STAGE NAME}
41
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
42
- ```
43
-
44
- **Stage names (uppercase):**
45
- - `QUESTIONING`
46
- - `RESEARCHING`
47
- - `DEFINING REQUIREMENTS`
48
- - `CREATING TRACK`
49
- - `PLANNING STAGE {N}`
50
- - `EXECUTING BATCH {N}`
51
- - `VERIFYING`
52
- - `STAGE {N} COMPLETE ✓`
53
- - `MILESTONE COMPLETE 🎉`
54
-
55
- ---
56
-
57
- ## Gate Boxes
58
-
59
- User action required. 62-character width.
60
-
61
- ```
62
- ╔══════════════════════════════════════════════════════════════╗
63
- GATE: {Type}
64
- ╚══════════════════════════════════════════════════════════════╝
65
-
66
- {Content}
67
-
68
- ──────────────────────────────────────────────────────────────
69
- → {ACTION PROMPT}
70
- ──────────────────────────────────────────────────────────────
71
- ```
72
-
73
- **Types:**
74
- - `GATE: Verification Required` → `→ Type "approved" or describe issues`
75
- - `GATE: Decision Required` → `→ Select: option-a / option-b`
76
- - `GATE: Action Required` → `→ Type "done" when complete`
77
-
78
- ---
79
-
80
- ## Status Symbols
81
-
82
- ```
83
- ✓ Complete / Passed / Verified
84
- ✗ Failed / Missing / Blocked
85
- ◆ In Progress
86
- ○ Pending
87
- ⚡ Auto-approved
88
- ⚠ Warning
89
- 🎉 Milestone complete (only in banner)
90
- ```
91
-
92
- ---
93
-
94
- ## Progress Display
95
-
96
- **Stage/milestone level:**
97
- ```
98
- Progress: ████████░░ 80%
99
- ```
100
-
101
- **Task level:**
102
- ```
103
- Tasks: 2/4 complete
104
- ```
105
-
106
- **Run level:**
107
- ```
108
- Runs: 3/5 complete
109
- ```
110
-
111
- ---
112
-
113
- ## Spawning Indicators
114
-
115
- ```
116
- ◆ Spawning scout...
117
-
118
- ◆ Spawning 4 scouts in parallel...
119
- → Stack research
120
- Features research
121
- Architecture research
122
- Pitfalls research
123
-
124
- Scout complete: STACK.md written
125
- ```
126
-
127
- ---
128
-
129
- ## Next Up Block
130
-
131
- Always at end of major completions.
132
-
133
- ```
134
- ───────────────────────────────────────────────────────────────
135
-
136
- ## ▶ Next Up
137
-
138
- **{Identifier}: {Name}** {one-line description}
139
-
140
- `{copy-paste command}`
141
-
142
- <sub>`/clear` first → fresh context window</sub>
143
-
144
- ───────────────────────────────────────────────────────────────
145
-
146
- **Also available:**
147
- - `/renn.alternative-1` — description
148
- - `/renn.alternative-2` — description
149
-
150
- ───────────────────────────────────────────────────────────────
151
- ```
152
-
153
- ---
154
-
155
- ## Error Box
156
-
157
- ```
158
- ╔══════════════════════════════════════════════════════════════╗
159
- ║ ERROR ║
160
- ╚══════════════════════════════════════════════════════════════╝
161
-
162
- {Error description}
163
-
164
- **To fix:** {Resolution steps}
165
- ```
166
-
167
- ---
168
-
169
- ## Tables
170
-
171
- ```
172
- | Stage | Status | Runs | Progress |
173
- |-------|--------|-------|----------|
174
- | 1 | | 3/3 | 100% |
175
- | 2 | ◆ | 1/4 | 25% |
176
- | 3 | | 0/2 | 0% |
177
- ```
178
-
179
- ---
180
-
181
- ## Anti-Patterns
182
-
183
- - Varying box/banner widths
184
- - Mixing banner styles (`===`, `---`, `***`)
185
- - Skipping `RENN >` prefix in banners
186
- - Random emoji (`🚀`, `✨`, `💫`)
187
- - Missing Next Up block after completions
188
-
189
- </ui_patterns>
1
+ <ui_patterns>
2
+
3
+ Visual patterns for user-facing RENN output. Orchestrators @-reference this file.
4
+
5
+ ## Brand Identity
6
+
7
+ - **Name:** RENN (uppercase in prose, lowercase in code/CLI)
8
+ - **Tagline:** "Grow ideas into shipped software"
9
+ - **Symbol:** Cherry Blossom 🌸 (U+1F338)
10
+ - **Philosophy:** From mud to lotus through structured runs
11
+
12
+ ### Color Palette
13
+
14
+ | Role | ANSI Code | Hex | Usage |
15
+ |------|-----------|-----|-------|
16
+ | Primary | `\e[38;5;218m` | #FFB7C5 | Banner text, highlights |
17
+ | Secondary | `\e[38;5;255m` | #EEEEEE | Body text |
18
+ | Accent | `\e[38;5;213m` | #FF79C6 | Status symbols, emphasis |
19
+ | Success | `\e[38;5;114m` | #98C379 | Completion indicators |
20
+ | Warning | `\e[38;5;221m` | #E5C07B | Caution states |
21
+ | Error | `\e[38;5;204m` | #E06C75 | Failure states |
22
+ | Dim | `\e[38;5;245m` | #8C8C8C | Muted text, hints |
23
+
24
+ ### Naming Rules
25
+
26
+ - **Prose/docs:** RENN (uppercase)
27
+ - **CLI commands:** `renn` (lowercase)
28
+ - **Slash commands:** `/renn.command-name`
29
+ - **Agents:** `renn-agent-name`
30
+ - **Package name:** `renn`
31
+
32
+ ---
33
+
34
+ ## Stage Banners
35
+
36
+ Use for major workflow transitions.
37
+
38
+ ```
39
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
40
+ RENN > {STAGE NAME}
41
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
42
+ ```
43
+
44
+ **Stage names (uppercase):**
45
+ - `QUESTIONING`
46
+ - `RESEARCHING`
47
+ - `DEFINING REQUIREMENTS`
48
+ - `CREATING TRACK`
49
+ - `PLANNING STAGE {N}`
50
+ - `EXECUTING BATCH {N}`
51
+ - `VERIFYING`
52
+ - `STAGE {N} COMPLETE ✓`
53
+ - `🌸 MILESTONE COMPLETE`
54
+
55
+ ---
56
+
57
+ ## Gate Boxes
58
+
59
+ User action required.
60
+
61
+ ```
62
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
63
+ ⚠️ GATE: {Type}
64
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
65
+
66
+ {Content}
67
+
68
+ ──────────────────────────────────────────────────────
69
+ → {ACTION PROMPT}
70
+ ──────────────────────────────────────────────────────
71
+ ```
72
+
73
+ **Types:**
74
+ - `⚠️ GATE: Verification Required` → `→ Type "approved" or describe issues`
75
+ - `⚠️ GATE: Decision Required` → `→ Select: option-a / option-b`
76
+ - `⚠️ GATE: Action Required` → `→ Type "done" when complete`
77
+
78
+ ---
79
+
80
+ ## Status Symbols
81
+
82
+ ```
83
+ ✓ Complete / Passed / Verified
84
+ ✗ Failed / Missing / Blocked
85
+ ◆ In Progress
86
+ ○ Pending
87
+ ⚡ Auto-approved
88
+ ⚠ Warning
89
+ 🌸 Milestone complete (only in banner)
90
+ ⚠️ Gate (only in gate banner)
91
+ ❌ Error (only in error banner)
92
+ ```
93
+
94
+ ---
95
+
96
+ ## Progress Display
97
+
98
+ **Stage/milestone level:**
99
+ ```
100
+ Progress: ████████░░ 80%
101
+ ```
102
+
103
+ **Task level:**
104
+ ```
105
+ Tasks: 2/4 complete
106
+ ```
107
+
108
+ **Run level:**
109
+ ```
110
+ Runs: 3/5 complete
111
+ ```
112
+
113
+ ---
114
+
115
+ ## Spawning Indicators
116
+
117
+ ```
118
+ ◆ Spawning scout...
119
+
120
+ Spawning 4 scouts in parallel...
121
+ Stack research
122
+ Features research
123
+ → Architecture research
124
+ Pitfalls research
125
+
126
+ ✓ Scout complete: STACK.md written
127
+ ```
128
+
129
+ ---
130
+
131
+ ## Next Up Block
132
+
133
+ Always at end of major completions.
134
+
135
+ ```
136
+ ───────────────────────────────────────────────────────────────
137
+
138
+ ## Next Up
139
+
140
+ **{Identifier}: {Name}** — {one-line description}
141
+
142
+ `{copy-paste command}`
143
+
144
+ <sub>`/clear` first → fresh context window</sub>
145
+
146
+ ───────────────────────────────────────────────────────────────
147
+
148
+ **Also available:**
149
+ - `/renn.alternative-1` — description
150
+ - `/renn.alternative-2` — description
151
+
152
+ ───────────────────────────────────────────────────────────────
153
+ ```
154
+
155
+ ---
156
+
157
+ ## Error Box
158
+
159
+ ```
160
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
161
+ ❌ ERROR
162
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
163
+
164
+ {Error description}
165
+
166
+ **To fix:** {Resolution steps}
167
+ ```
168
+
169
+ ---
170
+
171
+ ## Tables
172
+
173
+ ```
174
+ | Stage | Status | Runs | Progress |
175
+ |-------|--------|-------|----------|
176
+ | 1 | | 3/3 | 100% |
177
+ | 2 | ◆ | 1/4 | 25% |
178
+ | 3 | ○ | 0/2 | 0% |
179
+ ```
180
+
181
+ ---
182
+
183
+ ## Anti-Patterns
184
+
185
+ - Varying box/banner widths
186
+ - Mixing banner styles (`===`, `---`, `***`)
187
+ - Skipping `RENN >` prefix in banners
188
+ - Random emoji (`🚀`, `✨`, `💫`) — only 🌸, ⚠️, ❌ are allowed
189
+ - Using emoji in stage banners other than milestone complete
190
+ - Missing Next Up block after completions
191
+
192
+ </ui_patterns>
@@ -102,7 +102,7 @@ Proceed directly to gather_stats step.
102
102
  <if style="guided" OR="custom with gates.confirm_milestone_scope true">
103
103
 
104
104
  ```
105
- Ready to mark this milestone as shipped?
105
+ Ready to mark this milestone as complete to be shipped?
106
106
  (yes / wait / adjust scope)
107
107
  ```
108
108