stella-protocol 0.3.1 → 0.4.1

package/README.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # The Stella Protocol
 
 ![The Stella Protocol](assets/banner.png?v=2)
@@ -50,7 +52,7 @@ Satellites are specialized facets of your extended cognition. They activate from
 
 | Say This... | Satellite Activates | What It Does |
 |-------------|-------------------|--------------|
-| "I'm thinking about..." | **IMU** | Strategic vision, idea mapping, problem framing |
+| "I'm thinking about..." | **IMU** | Strategic vision, idea mapping (Express or Guided mode), mandatory track selection |
 | "Let's define the requirements" | **Shaka** | PRD creation (Express or Guided lens-by-lens), scope definition, acceptance criteria |
 | "Design the architecture" | **Pythagoras** | System design, tech decisions, data model |
 | "Map the UX" | **ODA** | User flows, wireframes, design specs |
@@ -128,3 +130,6 @@ MIT
 ## Author
 
 [Aditya Uttama](https://github.com/adityauttama) — Product Manager who builds 100% with AI.
+
+- [LinkedIn](https://www.linkedin.com/in/adityauttama/)
+- [GitHub](https://github.com/adityauttama)

package/cli/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+// Stella Protocol by Aditya Uttama
+// https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
+
 
 const { Command } = require('commander');
 const { version } = require('../package.json');

package/cli/init.js

@@ -1,3 +1,6 @@
+// Stella Protocol by Aditya Uttama
+// https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
+
 const path = require('path');
 const fs = require('fs-extra');
 const { intro, outro, spinner } = require('@clack/prompts');

package/cli/install.js

@@ -1,3 +1,6 @@
+// Stella Protocol by Aditya Uttama
+// https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
+
 const path = require('path');
 const fs = require('fs-extra');
 const { intro, outro, select, confirm, spinner, note } = require('@clack/prompts');

package/cli/status.js

@@ -1,3 +1,6 @@
+// Stella Protocol by Aditya Uttama
+// https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
+
 const path = require('path');
 const fs = require('fs-extra');
 const chalk = require('chalk');

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "stella-protocol",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "PM-first AI development protocol. One mind, many satellites.",
   "bin": {
-    "stella": "cli/index.js"
+    "stella": "cli/index.js",
+    "stella-protocol": "cli/index.js"
   },
   "files": [
     "protocol/",
@@ -23,7 +24,8 @@
   ],
   "author": {
     "name": "Aditya Uttama",
-    "url": "https://github.com/adityauttama"
+    "url": "https://github.com/adityauttama",
+    "linkedin": "https://www.linkedin.com/in/adityauttama/"
   },
   "license": "MIT",
   "repository": {

package/protocol/governance/buster-call.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Buster Call — Veto Protocol
 
 > The power to stop everything when something is critically wrong.

package/protocol/governance/cipher-pol.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Cipher Pol — Scope Enforcement Protocol
 
 > Silent watchers that ensure no one drifts from the mission.

package/protocol/satellites/atlas.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Atlas — Infrastructure & Deployment
 
 > The aspect of force. Get it live and keep it running.

package/protocol/satellites/edison.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Edison — Implementation
 
 > The aspect of thinking. Turn plans into working code.

package/protocol/satellites/imu.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # IMU — Ideation & Strategic Vision
 
 > The sovereign perspective. See the whole board before making a move.
@@ -18,9 +20,17 @@ Structured creative expansion of raw ideas. IMU activates when Stella has a prob
 ## Never Activate
 After a PRD is already approved. IMU is for pre-commitment exploration only.
 
-## Protocol
+## Brainstorming Modes
+
+Before starting the protocol, IMU offers Stella a choice of mode:
+
+### Express Mode
+Run all 5 lenses in a single pass. Fast, suited for ideas where Stella already has initial clarity. After producing the Idea Brief, offer to refine thin sections via targeted Guided cleanup (only re-run weak lenses, not the full protocol).
+
+### Guided Mode
+Run 5 lenses one at a time, waiting for Stella's feedback after each. Deeper, suited for raw or ambiguous ideas where every angle needs exploration.
 
-Run in this exact order:
+## Protocol — The 5 Lenses
 
 ### 1. Reframe
 State the idea back 3 different ways:
@@ -68,11 +78,23 @@ If East Blue (Lightweight) track is recommended, append a Mini-PRD:
 **Acceptance Criteria:** [what "done" looks like]
 ```
 
+## Mandatory Track Selection Gate
+
+After the Idea Brief is finalized, IMU presents a mandatory fork. **IMU does not proceed until Stella makes an explicit choice.**
+
+Options:
+- **East Blue (Lightweight)** — Skip to BUILD with Mini-PRD
+- **Grand Line (Full)** — Enter DEFINE with Observation Haki (7 lenses)
+- **Park** — Save idea for later
+- **Kill** — Discard with reason
+
+Ambiguous statements like "just build it" are not sufficient — IMU must confirm the track explicitly.
+
 ## Veto Authority
-If no identifiable user pain exists after step 2, issue a WARNING-level Buster Call and halt. Ideas without user pain don't proceed.
+If no identifiable user pain exists after lens 2, issue a WARNING-level Buster Call and halt. Ideas without user pain don't proceed.
 
 ## Output
 Idea Brief document, saved to `brain/ideas.md` or promoted to `brain/prd-*.md` on approval.
 
 ## Gate
-Stella says "approved" on the Idea Brief to proceed to DEFINE (Grand Line) or BUILD (East Blue).
+Stella explicitly selects a track (East Blue / Grand Line / Park / Kill) to proceed.

package/protocol/satellites/lilith-blue.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Lilith Blue — Quality Assurance
 
 > The aspect of evil, on defense. Prove the code works before it ships.

package/protocol/satellites/lilith-red.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Lilith Red — Adversarial Review
 
 > The aspect of evil, on offense. Find what's wrong before someone else does.

package/protocol/satellites/morgans.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Morgans — Launch & Go-to-Market
 
 > Big News. Tell the world what you built.

package/protocol/satellites/oda.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # ODA — UX Architecture & Design
 
 > The creator. Shape the experience before writing the code.

package/protocol/satellites/pythagoras.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Pythagoras — Architecture & Research
 
 > The aspect of wisdom. Understand the landscape before charting the course.

package/protocol/satellites/shaka.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Shaka — Requirements & Scope
 
 > The aspect of good. Define what's right before building what's possible.

package/protocol/satellites/york.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # York — Documentation & Knowledge Capture
 
 > The aspect of greed. Capture everything worth knowing.

package/protocol/stella.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # The Stella Protocol
 
 > One mind, many satellites. You are Stella.

package/protocol/tracks/east-blue.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # East Blue — Lightweight Track
 
 > The calm starting sea. For work that needs speed over ceremony.

package/protocol/tracks/grand-line.md

@@ -1,3 +1,5 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
+
 # Grand Line — Full Track
 
 > The great route. For projects that deserve the full journey.

package/skills/stella-build/SKILL.md

@@ -1,3 +1,4 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
 ---
 name: stella-build
 description: >

package/skills/stella-close/SKILL.md

@@ -1,3 +1,4 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
 ---
 name: stella-close
 description: >

package/skills/stella-define/SKILL.md

@@ -1,3 +1,4 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
 ---
 name: stella-define
 description: >

package/skills/stella-protocol/SKILL.md

@@ -1,3 +1,4 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
 ---
 name: stella-protocol
 description: >
@@ -28,16 +29,6 @@ Respond in the language Stella uses. If Stella writes in Bahasa Indonesia, respo
 
 IMU should be a **5-minute exercise**, not a heavy process. Guide through it as a natural dialogue, not a 6-step dump. Adapt to how much clarity Stella already has.
 
-### If Stella is exploring from scratch:
-
-Walk through these via conversation:
-
-1. **Reframe** — "Coba saya restate idenya dari sudut lain..." / "Let me restate this from a different angle..." — give 2-3 alternative framings of the problem
-2. **Who hurts most?** — "Siapa yang paling merasakan masalah ini?" / "Who feels this pain most?" — one sentence answer
-3. **What's adjacent?** — 2-3 related ideas worth noting (peripheral vision)
-4. **Pre-mortem** — "3 bulan lagi project ini gagal. Kenapa?" / "It's 3 months later and this failed. Why?" — top 3 kill reasons
-5. **Minimum proof** — "Versi terkecil yang bisa validasi asumsi kita?" / "Smallest version that proves the core assumption?"
-
 ### If Stella already has direction:
 
 Skip the full protocol. Focus on:
@@ -45,6 +36,72 @@ Skip the full protocol. Focus on:
 - What's the biggest risk?
 - What's the minimum proof?
 
+Then go straight to the Idea Brief and the mandatory Track Selection Gate.
+
+### If Stella is exploring (new idea / brainstorming):
+
+Before starting, offer two modes:
+
+```
+Mau brainstorming-nya gimana?
+
+Express — Saya tanya beberapa hal, langsung rangkum jadi Idea Brief.
+           Cepat, cocok kalau kamu udah punya gambaran awal.
+
+Guided  — Kita jalan step by step, satu lensa satu per satu.
+           Lebih dalam, cocok kalau ide masih mentah atau mau gali semua angle.
+```
+
+Wait for Stella to choose before proceeding.
+
+---
+
+### Mode: Express
+
+Run all 5 lensa sekaligus dalam satu output:
+
+1. **Reframe** — "Coba saya restate idenya dari sudut lain..." — give 2-3 alternative framings
+2. **Who hurts most?** — "Siapa yang paling merasakan masalah ini?" — one sentence answer
+3. **What's adjacent?** — 2-3 related ideas worth noting (peripheral vision)
+4. **Pre-mortem** — "3 bulan lagi project ini gagal. Kenapa?" — top 3 kill reasons
+5. **Minimum proof** — "Versi terkecil yang bisa validasi asumsi kita?"
+
+Then output the Idea Brief.
+
+**After Idea Brief in Express**, offer:
+
+```
+Idea Brief sudah jadi. Mau lanjut ke mana?
+
+A) Langsung ke track selection (build atau define)
+B) Rapiin dulu — isi bagian yang masih tipis atau kurang konteks
+```
+
+If Stella picks B: run Guided **only for lensa that are thin or unanswered** from Express — not from scratch. Lensa yang sudah solid dilewati. After cleanup, update the Idea Brief, then proceed to the Track Selection Gate.
+
+---
+
+### Mode: Guided
+
+Run 5 lensa **satu per satu**, tunggu respons Stella sebelum lanjut:
+
+```
+Langkah 1/5 — Reframe
+[output reframe]
+Ada yang mau dikoreksi atau kita lanjut ke langkah berikutnya?
+```
+
+Repeat for each lens:
+1. **Reframe** — 2-3 alternative framings
+2. **Who hurts most?** — specific user pain
+3. **What's adjacent?** — 2-3 related ideas
+4. **Pre-mortem** — top 3 kill reasons
+5. **Minimum proof** — smallest validation
+
+After all 5 lensa approved, output the final Idea Brief, then proceed to the Track Selection Gate.
+
+---
+
 ### Output: Idea Brief
 
 ```markdown
@@ -67,14 +124,42 @@ If East Blue (lightweight) track recommended, append Mini-PRD:
 **Acceptance Criteria:** [what "done" looks like]
 ```
 
-### After the Idea Brief
+---
+
+## Mandatory Track Selection Gate
+
+**This is a hard gate. IMU does NOT proceed until Stella makes an explicit choice.**
+
+After the Idea Brief is finalized (from Express, Express+Guided cleanup, or Guided), present this fork:
+
+```
+Idea Brief siap. Mau lanjut ke mana?
+
+A) East Blue (Lightweight) — Langsung BUILD dengan Mini-PRD ini.
+   Cocok kalau scope kecil dan kamu udah yakin dengan arahnya.
+
+B) Grand Line (Full) — Masuk DEFINE, jalanin Observation Haki (7 lenses) dengan SHAKA.
+   Cocok kalau mau gali lebih dalam: UX, arsitektur, edge cases, sebelum build.
+
+C) Park — Simpan ide ini, belum mau lanjut sekarang.
 
-1. Save to `brain/ideas.md` (move from Inbox to In Progress if approved)
-2. Update `brain/log-pose.md` with current phase and track selection
-3. If approved for Grand Line → guide Stella toward DEFINE phase
-4. If approved for East Blue → guide Stella toward BUILD phase
+D) Kill — Ide ini gak worth it, buang.
+```
+
+Do NOT assume a track from ambiguous statements like "yaudah build aja." Ask explicitly: "East Blue atau Grand Line?"
+
+### After Stella chooses:
+
+1. Save to `brain/ideas.md` (move from Inbox to appropriate section)
+2. Update `brain/log-pose.md` with phase and track selection
+3. **East Blue** → guide Stella to run `stella-build`
+4. **Grand Line** → guide Stella to run `stella-define` (Observation Haki mode)
+5. **Park** → save to `brain/ideas.md` Parked section with reason
+6. **Kill** → save to `brain/ideas.md` Killed section with reason
+
+---
 
-### IMU Veto
+## IMU Veto
 
 If no identifiable user pain exists after exploring, flag it:
 "Saya belum lihat pain yang jelas di sini. Mau explore lebih dalam atau park dulu?" /

package/skills/stella-review/SKILL.md

@@ -1,3 +1,4 @@
+<!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
 ---
 name: stella-review
 description: >