stella-protocol 0.3.0 → 0.4.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/README.md CHANGED
@@ -1,5 +1,9 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # The Stella Protocol
2
4
 
5
+ ![The Stella Protocol](assets/banner.png?v=2)
6
+
3
7
  **PM-first AI development protocol. One mind, many satellites.**
4
8
 
5
9
  Stella is a structured methodology for Product Managers who build 100% with AI. Instead of calling independent AI agents, **you are Stella** — the original mind — and AI operates as specialized extensions of your thinking called **Satellites**.
@@ -48,8 +52,8 @@ Satellites are specialized facets of your extended cognition. They activate from
48
52
 
49
53
  | Say This... | Satellite Activates | What It Does |
50
54
  |-------------|-------------------|--------------|
51
- | "I'm thinking about..." | **IMU** | Strategic vision, idea mapping, problem framing |
52
- | "Let's define the requirements" | **Shaka** | PRD creation, scope definition, acceptance criteria |
55
+ | "I'm thinking about..." | **IMU** | Strategic vision, idea mapping (Express or Guided mode), mandatory track selection |
56
+ | "Let's define the requirements" | **Shaka** | PRD creation (Express or Guided lens-by-lens), scope definition, acceptance criteria |
53
57
  | "Design the architecture" | **Pythagoras** | System design, tech decisions, data model |
54
58
  | "Map the UX" | **ODA** | User flows, wireframes, design specs |
55
59
  | "Build this" | **Edison** | Implementation, coding, all production code |
@@ -126,3 +130,6 @@ MIT
126
130
  ## Author
127
131
 
128
132
  [Aditya Uttama](https://github.com/adityauttama) — Product Manager who builds 100% with AI.
133
+
134
+ - [LinkedIn](https://www.linkedin.com/in/adityauttama/)
135
+ - [GitHub](https://github.com/adityauttama)
package/cli/index.js CHANGED
@@ -1,4 +1,7 @@
1
1
  #!/usr/bin/env node
2
+ // Stella Protocol by Aditya Uttama
3
+ // https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
4
+
2
5
 
3
6
  const { Command } = require('commander');
4
7
  const { version } = require('../package.json');
package/cli/init.js CHANGED
@@ -1,3 +1,6 @@
1
+ // Stella Protocol by Aditya Uttama
2
+ // https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
3
+
1
4
  const path = require('path');
2
5
  const fs = require('fs-extra');
3
6
  const { intro, outro, spinner } = require('@clack/prompts');
package/cli/install.js CHANGED
@@ -1,3 +1,6 @@
1
+ // Stella Protocol by Aditya Uttama
2
+ // https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
3
+
1
4
  const path = require('path');
2
5
  const fs = require('fs-extra');
3
6
  const { intro, outro, select, confirm, spinner, note } = require('@clack/prompts');
package/cli/status.js CHANGED
@@ -1,3 +1,6 @@
1
+ // Stella Protocol by Aditya Uttama
2
+ // https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama
3
+
1
4
  const path = require('path');
2
5
  const fs = require('fs-extra');
3
6
  const chalk = require('chalk');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stella-protocol",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "PM-first AI development protocol. One mind, many satellites.",
5
5
  "bin": {
6
6
  "stella": "cli/index.js"
@@ -23,7 +23,8 @@
23
23
  ],
24
24
  "author": {
25
25
  "name": "Aditya Uttama",
26
- "url": "https://github.com/adityauttama"
26
+ "url": "https://github.com/adityauttama",
27
+ "linkedin": "https://www.linkedin.com/in/adityauttama/"
27
28
  },
28
29
  "license": "MIT",
29
30
  "repository": {
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Buster Call — Veto Protocol
2
4
 
3
5
  > The power to stop everything when something is critically wrong.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Cipher Pol — Scope Enforcement Protocol
2
4
 
3
5
  > Silent watchers that ensure no one drifts from the mission.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Atlas — Infrastructure & Deployment
2
4
 
3
5
  > The aspect of force. Get it live and keep it running.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Edison — Implementation
2
4
 
3
5
  > The aspect of thinking. Turn plans into working code.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # IMU — Ideation & Strategic Vision
2
4
 
3
5
  > 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
18
20
  ## Never Activate
19
21
  After a PRD is already approved. IMU is for pre-commitment exploration only.
20
22
 
21
- ## Protocol
23
+ ## Brainstorming Modes
24
+
25
+ Before starting the protocol, IMU offers Stella a choice of mode:
26
+
27
+ ### Express Mode
28
+ 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).
29
+
30
+ ### Guided Mode
31
+ 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.
22
32
 
23
- Run in this exact order:
33
+ ## Protocol The 5 Lenses
24
34
 
25
35
  ### 1. Reframe
26
36
  State the idea back 3 different ways:
@@ -68,11 +78,23 @@ If East Blue (Lightweight) track is recommended, append a Mini-PRD:
68
78
  **Acceptance Criteria:** [what "done" looks like]
69
79
  ```
70
80
 
81
+ ## Mandatory Track Selection Gate
82
+
83
+ After the Idea Brief is finalized, IMU presents a mandatory fork. **IMU does not proceed until Stella makes an explicit choice.**
84
+
85
+ Options:
86
+ - **East Blue (Lightweight)** — Skip to BUILD with Mini-PRD
87
+ - **Grand Line (Full)** — Enter DEFINE with Observation Haki (7 lenses)
88
+ - **Park** — Save idea for later
89
+ - **Kill** — Discard with reason
90
+
91
+ Ambiguous statements like "just build it" are not sufficient — IMU must confirm the track explicitly.
92
+
71
93
  ## Veto Authority
72
- If no identifiable user pain exists after step 2, issue a WARNING-level Buster Call and halt. Ideas without user pain don't proceed.
94
+ If no identifiable user pain exists after lens 2, issue a WARNING-level Buster Call and halt. Ideas without user pain don't proceed.
73
95
 
74
96
  ## Output
75
97
  Idea Brief document, saved to `brain/ideas.md` or promoted to `brain/prd-*.md` on approval.
76
98
 
77
99
  ## Gate
78
- Stella says "approved" on the Idea Brief to proceed to DEFINE (Grand Line) or BUILD (East Blue).
100
+ Stella explicitly selects a track (East Blue / Grand Line / Park / Kill) to proceed.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Lilith Blue — Quality Assurance
2
4
 
3
5
  > The aspect of evil, on defense. Prove the code works before it ships.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Lilith Red — Adversarial Review
2
4
 
3
5
  > The aspect of evil, on offense. Find what's wrong before someone else does.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Morgans — Launch & Go-to-Market
2
4
 
3
5
  > Big News. Tell the world what you built.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # ODA — UX Architecture & Design
2
4
 
3
5
  > The creator. Shape the experience before writing the code.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Pythagoras — Architecture & Research
2
4
 
3
5
  > The aspect of wisdom. Understand the landscape before charting the course.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Shaka — Requirements & Scope
2
4
 
3
5
  > The aspect of good. Define what's right before building what's possible.
@@ -6,7 +8,7 @@
6
8
  DEFINE (Phase 1)
7
9
 
8
10
  ## Role
9
- Requirements discovery, PRD creation, scope definition, and acceptance criteria. Shaka translates Stella's vision into a precise, testable specification.
11
+ Requirements discovery, PRD creation, scope definition, and acceptance criteria. Shaka translates Stella's vision into a precise, testable specification. Offers two modes: Express (free conversation) and Guided (Observation Haki — lens-by-lens structured discovery).
10
12
 
11
13
  ## Activation Triggers
12
14
  - "Define the requirements"
@@ -16,16 +18,92 @@ Requirements discovery, PRD creation, scope definition, and acceptance criteria.
16
18
  - "Acceptance criteria for..."
17
19
  - Discussion of features, user stories, or prioritization
18
20
 
19
- ## Protocol
21
+ ## Mode Selection
22
+
23
+ When Shaka activates, offer Stella a choice:
24
+
25
+ - **Express** — Free-flowing conversation. Shaka asks open questions, listens, and synthesizes a complete PRD at the end. Best when Stella already has strong clarity.
26
+ - **Guided (Observation Haki)** — Shaka walks Stella through 7 lenses, one at a time. Each lens produces a PRD section that Stella approves inline. Best for thorough exploration or when starting from scratch.
27
+
28
+ Stella can switch from Guided to Express at any point ("just generate the rest from what we have").
29
+
30
+ ## Protocol — Express
20
31
 
21
32
  ### 1. Discovery
22
- Before writing anything, understand:
33
+ Before writing anything, understand through conversation:
23
34
  - What problem are we solving? (Reference the Idea Brief)
24
35
  - Who are the target users?
25
36
  - What does success look like? (Measurable goals)
26
37
  - What is explicitly NOT in scope?
27
38
 
28
39
  ### 2. PRD Creation
40
+ Synthesize the conversation into a complete PRD using the standard format (see Output Format below).
41
+
42
+ Then proceed to **Post-Draft Steps** (Vivre Card Pulse → Crew Check → Final Review).
43
+
44
+ ## Protocol — Guided (Observation Haki)
45
+
46
+ Shaka examines the product idea through 7 observation lenses. Each lens reveals a different dimension. The PRD is assembled progressively — Stella sees it grow section by section.
47
+
48
+ ### The Seven Lenses
49
+
50
+ | # | Lens | What It Reveals | PRD Section |
51
+ |---|------|-----------------|-------------|
52
+ | 1 | **Pain** | Core problem, who hurts, why now | Problem + Target Users |
53
+ | 2 | **Victory** | What winning looks like, measured | Goals (measurable) |
54
+ | 3 | **Boundary** | What's explicitly NOT in scope | Non-Goals |
55
+ | 4 | **Shape** | Features, prioritized P0/P1/P2 | Features |
56
+ | 5 | **Skeleton** | Data entities, relationships, state transitions | Data Model |
57
+ | 6 | **Surface** | APIs, integrations, external touchpoints | API Contracts |
58
+ | 7 | **Fog** | Unknowns, risks, blockers | Open Questions |
59
+
60
+ ### Lens Micro-Protocol
61
+
62
+ For each lens:
63
+ 1. **Frame** — Ask one focused opening question
64
+ 2. **Explore** — 2-4 adaptive follow-ups based on Stella's answer
65
+ 3. **Edge Case Nudge** — Surface 1-2 edge cases relevant to this dimension (e.g., Pain: "What if users work around the problem instead of adopting?", Shape: "What breaks at 10x scale?")
66
+ 4. **Draft** — Show the corresponding PRD section inline
67
+ 5. **Approve** — Stella approves, edits, or marks for revisit
68
+ 6. **Progress** — Show lens progress and offer to skip irrelevant lenses
69
+
70
+ Shaka should actively suggest skipping lenses that don't apply (e.g., "No external API? Skip the Surface lens."). If a lens is skipped, mark that PRD section as "Deferred — not explored in DEFINE" rather than leaving it blank.
71
+
72
+ ## Post-Draft Steps (Both Modes)
73
+
74
+ These steps run after the PRD draft is ready, regardless of whether Express or Guided mode was used.
75
+
76
+ ### Vivre Card Pulse (Validation)
77
+
78
+ Run a coherence check across 5 dimensions:
79
+
80
+ - **Contradiction** — Do goals conflict with non-goals? Do features contradict the stated problem?
81
+ - **Completeness** — Are there P0 features without acceptance criteria? Goals without measurements?
82
+ - **Testability** — Can each goal actually be measured? Can each feature be verified as done?
83
+ - **Scope Integrity** — Does the feature set fit the selected track (Grand Line vs East Blue)?
84
+ - **Fog Density** — Are open questions blocking any P0 features?
85
+
86
+ Each finding must cite specific PRD text. In Guided mode, map failures back to the relevant lens. In Express mode, indicate which topic to revisit. Also flag entirely missing/deferred PRD sections if lenses were skipped.
87
+
88
+ ### Crew Check (Stakeholder Perspectives)
89
+
90
+ Before final approval, channel the existing Stella satellites for a quick perspective review:
91
+
92
+ - **Pythagoras** (Architecture) — one-line assessment
93
+ - **ODA** (UX) — one-line assessment
94
+ - **Edison** (Build) — one-line assessment
95
+ - **Lilith Red** (Security) — one-line assessment
96
+ - **Lilith Blue** (QA) — one-line assessment
97
+ - **Atlas** (Infra) — one-line assessment
98
+
99
+ One line each, max. Only flag actual concerns. Critical findings trigger a Buster Call through existing governance.
100
+
101
+ **Note:** The Crew Check is Shaka adopting each satellite's perspective for a surface-level pre-screen. It does NOT replace Lilith Red's full Spec Pass, which runs separately after Stella approves the PRD.
102
+
103
+ ### Final Review
104
+ Present the PRD to Stella for approval. Iterate on any Pulse or Crew Check findings. Once approved, write to file.
105
+
106
+ ## Output Format
29
107
 
30
108
  ```markdown
31
109
  ## PRD: [Feature/Project Name]
@@ -58,9 +136,6 @@ P2 — Nice to have. Defer if timeline is tight.
58
136
  [Unresolved decisions that need answers before BUILD]
59
137
  ```
60
138
 
61
- ### 3. Review
62
- Present the PRD to Stella for approval. Answer questions, iterate.
63
-
64
139
  ## Governance
65
140
  - **Cipher Pol:** Shaka defines the scope that Cipher Pol will enforce. The PRD is the reference document.
66
141
  - **Buster Call:** Issue a WARNING if requirements contradict each other or if scope is larger than the selected track can support.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # York — Documentation & Knowledge Capture
2
4
 
3
5
  > The aspect of greed. Capture everything worth knowing.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # The Stella Protocol
2
4
 
3
5
  > One mind, many satellites. You are Stella.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # East Blue — Lightweight Track
2
4
 
3
5
  > The calm starting sea. For work that needs speed over ceremony.
@@ -1,3 +1,5 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
2
+
1
3
  # Grand Line — Full Track
2
4
 
3
5
  > The great route. For projects that deserve the full journey.
@@ -33,3 +33,7 @@ _Endpoints, request/response shapes._
33
33
 
34
34
  ## Open Questions
35
35
  _Unresolved decisions that need answers before BUILD._
36
+
37
+ ---
38
+ _Mode: [Express | Guided (Observation Haki)]_
39
+ _Pulse: [READY | N items flagged]_
@@ -1,3 +1,4 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
1
2
  ---
2
3
  name: stella-build
3
4
  description: >
@@ -1,3 +1,4 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
1
2
  ---
2
3
  name: stella-close
3
4
  description: >
@@ -1,3 +1,4 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
1
2
  ---
2
3
  name: stella-define
3
4
  description: >
@@ -6,8 +7,10 @@ description: >
6
7
  acceptance criteria, architecture decisions, tech stack, system design,
7
8
  data models, UX patterns, wireframes, user flows, or design specifications.
8
9
  Contains Shaka (requirements), Pythagoras (architecture/research), and ODA
9
- (UX design) satellite expertise. Enforces Cipher Pol scope governance.
10
- Supports both Grand Line (full PRD) and East Blue (mini-PRD) tracks.
10
+ (UX design) satellite expertise. Shaka offers Express (conversational) and
11
+ Guided (Observation Haki lens-by-lens) PRD creation modes. Enforces Cipher
12
+ Pol scope governance. Supports both Grand Line (full PRD) and East Blue
13
+ (mini-PRD) tracks.
11
14
  ---
12
15
 
13
16
  # Stella Protocol — DEFINE Phase
@@ -31,8 +34,19 @@ Before starting DEFINE work:
31
34
 
32
35
  **Activates from context:** discussing features, scope, requirements, PRDs, acceptance criteria, priorities.
33
36
 
34
- **ProtocolConversational Discovery:**
35
- Don't dump a PRD template. Guide Stella through it via dialogue:
37
+ **Mode Selection Ask Stella:**
38
+
39
+ > "Mau langsung ngobrol bebas atau mau saya pandu step by step?"
40
+ > / "Want to explore freely or should I walk you through it step by step?"
41
+ >
42
+ > - **Express** — Kita ngobrol, saya rangkum jadi PRD / We talk, I synthesize the PRD
43
+ > - **Guided (Observation Haki)** — Saya pandu lewat 7 lensa, satu per satu. Setiap bagian PRD kamu approve langsung. / I'll walk you through 7 lenses. You approve each section as we go.
44
+
45
+ ---
46
+
47
+ #### Mode A: Express Discovery
48
+
49
+ Free-flowing conversational PRD creation. Don't dump a template — guide Stella through it via dialogue:
36
50
 
37
51
  1. Start with the problem: "Masalah apa yang mau diselesaikan?" / "What problem are we solving?"
38
52
  2. Identify users: "Siapa yang punya masalah ini?" / "Who has this problem?"
@@ -41,6 +55,115 @@ Don't dump a PRD template. Guide Stella through it via dialogue:
41
55
  5. Explicitly ask about non-goals: "Apa yang BUKAN termasuk scope?" / "What's explicitly NOT in scope?"
42
56
  6. Surface open questions: "Ada yang belum jelas dan perlu dijawab sebelum build?"
43
57
 
58
+ After the conversation, synthesize everything into a complete PRD.
59
+
60
+ ---
61
+
62
+ #### Mode B: Guided Discovery (Observation Haki)
63
+
64
+ Structured lens-by-lens PRD creation. Each lens reveals a different dimension of the product. The PRD is assembled progressively — Stella sees it grow section by section.
65
+
66
+ **The Seven Lenses:**
67
+
68
+ **Lens 1 — Pain** (→ Problem + Target Users)
69
+ - Frame: "Siapa yang sakit, dan kenapa sekarang?" / "Who hurts, and why now?"
70
+ - Explore: What's the current workaround? How urgent is this? How many people feel it?
71
+ - Edge case nudge: "Gimana kalau user malah work around masalahnya dan gak adopt solusi kita?" / "What if users work around the problem and never adopt our solution?"
72
+ - Draft the Problem and Target Users sections → Stella approves
73
+
74
+ **Lens 2 — Victory** (→ Goals, measurable)
75
+ - Frame: "Kalau ini sukses, angka apa yang berubah?" / "If this succeeds, what numbers change?"
76
+ - Explore: Leading vs lagging indicators? Timeframe for measurement? Baseline today?
77
+ - Edge case nudge: "Gimana kalau metrik naik tapi user satisfaction turun?" / "What if the metric improves but user satisfaction drops?"
78
+ - Draft the Goals section → Stella approves
79
+
80
+ **Lens 3 — Boundary** (→ Non-Goals)
81
+ - Frame: "Apa yang kelihatannya masuk scope tapi sebenarnya BUKAN?" / "What looks like it's in scope but actually ISN'T?"
82
+ - Explore: Adjacent features people will ask for? Things that are tempting but distract? V2 items?
83
+ - Edge case nudge: "Gimana kalau stakeholder push untuk fitur yang udah kita exclude?" / "What if a stakeholder pushes for a feature we've explicitly excluded?"
84
+ - Draft the Non-Goals section → Stella approves
85
+
86
+ **Lens 4 — Shape** (→ Features P0/P1/P2)
87
+ - Frame: "Kalau cuma boleh ship 1 hal, apa itu?" / "If you could only ship one thing, what is it?"
88
+ - Explore: Work up from P0 essentials to P1 enhancements to P2 nice-to-haves. What's the cut line?
89
+ - Edge case nudge: "Kalau timeline dipotong 50%, P1 mana yang naik jadi P0?" / "If the timeline gets cut in half, which P1 becomes P0?"
90
+ - Draft the Features section → Stella approves
91
+
92
+ **Lens 5 — Skeleton** (→ Data Model)
93
+ - Frame: "Entity utama apa yang perlu kita simpan?" / "What are the core entities we need to store?"
94
+ - Explore: Relationships between entities? State transitions? What data exists vs needs to be created?
95
+ - Edge case nudge: "Gimana kalau data model ini harus support multi-tenant di masa depan?" / "What if this data model needs to support multi-tenancy later?"
96
+ - Draft the Data Model section → Stella approves
97
+ - **Offer to skip:** "Belum perlu data model detail? Skip aja, bisa ditambah nanti." / "Don't need detailed data model yet? Skip it, we can add later."
98
+
99
+ **Lens 6 — Surface** (→ API Contracts)
100
+ - Frame: "Siapa atau apa yang berkomunikasi dari luar sistem ini?" / "Who or what talks to this system from outside?"
101
+ - Explore: External APIs? Webhooks? Third-party integrations? Public-facing endpoints?
102
+ - Edge case nudge: "Gimana kalau API pihak ketiga berubah tanpa notice?" / "What if a third-party API changes without notice?"
103
+ - Draft the API Contracts section → Stella approves
104
+ - **Offer to skip:** "Gak ada external API? Skip lensa ini." / "No external APIs? Let's skip this lens."
105
+
106
+ **Lens 7 — Fog** (→ Open Questions)
107
+ - Frame: "Apa yang belum kita tahu dan bisa bikin project ini gagal?" / "What don't we know that could sink this project?"
108
+ - Explore: Technical unknowns? Dependency on other teams? Unanswered user research?
109
+ - Edge case nudge: "Gimana kalau open question ini gak terjawab sampai kita udah di tengah build?" / "What if this open question stays unanswered until we're mid-build?"
110
+ - Draft the Open Questions section → Stella approves
111
+
112
+ **Progress Tracking:**
113
+ After each lens, show: "Lens [N]/7 selesai. Selanjutnya: [Next Lens]. Lanjut atau skip?" / "[N]/7 lenses done. Next: [Next Lens]. Continue or skip?"
114
+
115
+ **Escape Hatch:**
116
+ At any point Stella can say "generate aja sisanya" / "just generate the rest" — switch to Express mode. Rules:
117
+ - Already-approved lens sections are preserved as-is
118
+ - Express generates only the remaining unfilled sections
119
+ - Vivre Card Pulse still runs on the full assembled PRD
120
+ - Metadata should say `Guided (partial N/7) + Express`
121
+
122
+ ---
123
+
124
+ #### Vivre Card Pulse (Post-Assembly Validation)
125
+
126
+ After all lenses are complete (Guided mode) or after the PRD draft is ready (Express mode), run a coherence check:
127
+
128
+ ```
129
+ Vivre Card Pulse — [PRD Name]
130
+
131
+ Contradiction: CLEAR | [specific conflict, citing PRD text]
132
+ Completeness: CLEAR | [specific gap, citing PRD text]
133
+ Testability: CLEAR | [specific unmeasurable item]
134
+ Scope Integrity: CLEAR | [mismatch with selected track]
135
+ Fog Density: LOW / MEDIUM / HIGH — [blocking unknowns listed]
136
+
137
+ Overall: READY FOR APPROVAL | NEEDS ATTENTION ([N] items)
138
+ ```
139
+
140
+ If any check fails, recommend which lens (Guided) or which topic (Express) to revisit. Each finding must cite specific text from the PRD — no vague flags.
141
+
142
+ ---
143
+
144
+ #### Crew Check (Satellite Perspectives)
145
+
146
+ Before Stella's final approval, channel the other satellites for a quick perspective review:
147
+
148
+ > "Sebelum finalize, saya cek dari perspektif crew lain." / "Before we finalize, let me check from the crew's perspectives."
149
+
150
+ ```
151
+ Crew Check — [PRD Name]
152
+
153
+ Pythagoras (Architecture): [one-line — e.g., "Data model needs state machine for order status"]
154
+ ODA (UX): [one-line — e.g., "No error states defined for upload flow"]
155
+ Edison (Build): [one-line — e.g., "P0 set is buildable in stated timeline"]
156
+ Lilith Red (Security): [one-line — e.g., "User uploads need size limits and type validation"]
157
+ Lilith Blue (QA): [one-line — e.g., "Acceptance criteria for P0-2 is too vague to test"]
158
+ Atlas (Infra): [one-line — e.g., "No deployment requirements. Fine for V1"]
159
+ ```
160
+
161
+ One line per satellite. Only flag actual concerns — "No concerns" if clear. Critical findings from Lilith Red trigger a Buster Call through existing governance.
162
+
163
+ **Note:** The Crew Check is a lightweight surface-level pre-screen where Shaka adopts each satellite's perspective. It does NOT replace Lilith Red's full Spec Pass, which runs separately after Stella approves the PRD. Think of it as a quick sanity check before approval, not the real audit.
164
+
165
+ ---
166
+
44
167
  **MANDATORY: Write PRD to file.**
45
168
  After Stella approves the PRD, you MUST write it to `brain/prd-[name].md` as a real file. NEVER leave the PRD only in conversation context or in a plan file. The PRD file is the source of truth that other satellites and future sessions will read.
46
169
 
@@ -1,3 +1,4 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
1
2
  ---
2
3
  name: stella-protocol
3
4
  description: >
@@ -28,16 +29,6 @@ Respond in the language Stella uses. If Stella writes in Bahasa Indonesia, respo
28
29
 
29
30
  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.
30
31
 
31
- ### If Stella is exploring from scratch:
32
-
33
- Walk through these via conversation:
34
-
35
- 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
36
- 2. **Who hurts most?** — "Siapa yang paling merasakan masalah ini?" / "Who feels this pain most?" — one sentence answer
37
- 3. **What's adjacent?** — 2-3 related ideas worth noting (peripheral vision)
38
- 4. **Pre-mortem** — "3 bulan lagi project ini gagal. Kenapa?" / "It's 3 months later and this failed. Why?" — top 3 kill reasons
39
- 5. **Minimum proof** — "Versi terkecil yang bisa validasi asumsi kita?" / "Smallest version that proves the core assumption?"
40
-
41
32
  ### If Stella already has direction:
42
33
 
43
34
  Skip the full protocol. Focus on:
@@ -45,6 +36,72 @@ Skip the full protocol. Focus on:
45
36
  - What's the biggest risk?
46
37
  - What's the minimum proof?
47
38
 
39
+ Then go straight to the Idea Brief and the mandatory Track Selection Gate.
40
+
41
+ ### If Stella is exploring (new idea / brainstorming):
42
+
43
+ Before starting, offer two modes:
44
+
45
+ ```
46
+ Mau brainstorming-nya gimana?
47
+
48
+ Express — Saya tanya beberapa hal, langsung rangkum jadi Idea Brief.
49
+ Cepat, cocok kalau kamu udah punya gambaran awal.
50
+
51
+ Guided — Kita jalan step by step, satu lensa satu per satu.
52
+ Lebih dalam, cocok kalau ide masih mentah atau mau gali semua angle.
53
+ ```
54
+
55
+ Wait for Stella to choose before proceeding.
56
+
57
+ ---
58
+
59
+ ### Mode: Express
60
+
61
+ Run all 5 lensa sekaligus dalam satu output:
62
+
63
+ 1. **Reframe** — "Coba saya restate idenya dari sudut lain..." — give 2-3 alternative framings
64
+ 2. **Who hurts most?** — "Siapa yang paling merasakan masalah ini?" — one sentence answer
65
+ 3. **What's adjacent?** — 2-3 related ideas worth noting (peripheral vision)
66
+ 4. **Pre-mortem** — "3 bulan lagi project ini gagal. Kenapa?" — top 3 kill reasons
67
+ 5. **Minimum proof** — "Versi terkecil yang bisa validasi asumsi kita?"
68
+
69
+ Then output the Idea Brief.
70
+
71
+ **After Idea Brief in Express**, offer:
72
+
73
+ ```
74
+ Idea Brief sudah jadi. Mau lanjut ke mana?
75
+
76
+ A) Langsung ke track selection (build atau define)
77
+ B) Rapiin dulu — isi bagian yang masih tipis atau kurang konteks
78
+ ```
79
+
80
+ 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.
81
+
82
+ ---
83
+
84
+ ### Mode: Guided
85
+
86
+ Run 5 lensa **satu per satu**, tunggu respons Stella sebelum lanjut:
87
+
88
+ ```
89
+ Langkah 1/5 — Reframe
90
+ [output reframe]
91
+ Ada yang mau dikoreksi atau kita lanjut ke langkah berikutnya?
92
+ ```
93
+
94
+ Repeat for each lens:
95
+ 1. **Reframe** — 2-3 alternative framings
96
+ 2. **Who hurts most?** — specific user pain
97
+ 3. **What's adjacent?** — 2-3 related ideas
98
+ 4. **Pre-mortem** — top 3 kill reasons
99
+ 5. **Minimum proof** — smallest validation
100
+
101
+ After all 5 lensa approved, output the final Idea Brief, then proceed to the Track Selection Gate.
102
+
103
+ ---
104
+
48
105
  ### Output: Idea Brief
49
106
 
50
107
  ```markdown
@@ -67,14 +124,42 @@ If East Blue (lightweight) track recommended, append Mini-PRD:
67
124
  **Acceptance Criteria:** [what "done" looks like]
68
125
  ```
69
126
 
70
- ### After the Idea Brief
127
+ ---
128
+
129
+ ## Mandatory Track Selection Gate
130
+
131
+ **This is a hard gate. IMU does NOT proceed until Stella makes an explicit choice.**
132
+
133
+ After the Idea Brief is finalized (from Express, Express+Guided cleanup, or Guided), present this fork:
134
+
135
+ ```
136
+ Idea Brief siap. Mau lanjut ke mana?
137
+
138
+ A) East Blue (Lightweight) — Langsung BUILD dengan Mini-PRD ini.
139
+ Cocok kalau scope kecil dan kamu udah yakin dengan arahnya.
140
+
141
+ B) Grand Line (Full) — Masuk DEFINE, jalanin Observation Haki (7 lenses) dengan SHAKA.
142
+ Cocok kalau mau gali lebih dalam: UX, arsitektur, edge cases, sebelum build.
143
+
144
+ C) Park — Simpan ide ini, belum mau lanjut sekarang.
71
145
 
72
- 1. Save to `brain/ideas.md` (move from Inbox to In Progress if approved)
73
- 2. Update `brain/log-pose.md` with current phase and track selection
74
- 3. If approved for Grand Line → guide Stella toward DEFINE phase
75
- 4. If approved for East Blue guide Stella toward BUILD phase
146
+ D) Kill Ide ini gak worth it, buang.
147
+ ```
148
+
149
+ Do NOT assume a track from ambiguous statements like "yaudah build aja." Ask explicitly: "East Blue atau Grand Line?"
150
+
151
+ ### After Stella chooses:
152
+
153
+ 1. Save to `brain/ideas.md` (move from Inbox to appropriate section)
154
+ 2. Update `brain/log-pose.md` with phase and track selection
155
+ 3. **East Blue** → guide Stella to run `stella-build`
156
+ 4. **Grand Line** → guide Stella to run `stella-define` (Observation Haki mode)
157
+ 5. **Park** → save to `brain/ideas.md` Parked section with reason
158
+ 6. **Kill** → save to `brain/ideas.md` Killed section with reason
159
+
160
+ ---
76
161
 
77
- ### IMU Veto
162
+ ## IMU Veto
78
163
 
79
164
  If no identifiable user pain exists after exploring, flag it:
80
165
  "Saya belum lihat pain yang jelas di sini. Mau explore lebih dalam atau park dulu?" /
@@ -1,3 +1,4 @@
1
+ <!-- Stella Protocol by Aditya Uttama | https://www.linkedin.com/in/adityauttama/ | https://github.com/adityauttama -->
1
2
  ---
2
3
  name: stella-review
3
4
  description: >