opencode-orchestrator 0.9.31 → 0.9.35

package/README.md

@@ -27,40 +27,53 @@ Then in OpenCode:
 
 ## 🧠 Core Philosophy
 
-> **Explore → Adapt → Act**  
-> *Like a human exploring unknown space — never assume, always discover.*
-
-Behaves like an astronaut exploring the unknown.  
-In unfamiliar environments: **detect without assuming**, **adapt to discoveries**, **act with confidence**.
+> **Explore → Learn → Adapt → Act**  
+> *Like a human exploring unknown space — discover, document, adjust, execute.*
 
 ```
-┌───────────────────────────────────────────────────────────┐
-│                                                           │
-│   🔍 EXPLORE    →    🔄 ADAPT    →    ⚡ ACT             │
-│                                                           │
-│   Scan the         Adjust to         Execute with        │
-│   unknown          what you find     confidence          │
-│                                                           │
-└───────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────────────────────────┐
+│                                                                                      │
+│  🔍 EXPLORE    →    📝 LEARN    →    🔄 ADAPT    →    ⚡ ACT                          │
+│                                                                                      │
+│  Scan unknown       Document           Adjust             Execute with               │
+│  territory          discoveries        behavior           confidence                 │
+│                                                                                      │
+│  • Read context     • Record patterns  • Match style      • Build it                 │
+│  • Detect stack     • Note conventions • Fit the project  • Test it                  │
+│  • Find commands    • Log findings     • Apply learnings  • Seal it                  │
+│                                                                                      │
+└──────────────────────────────────────────────────────────────────────────────────────┘
 ```
 
-### Agents & Their Philosophy
+### 🛸 The Astronaut Principle
+
+Agents behave like astronauts landing on unknown planets:
+
+- **Never assume gravity** — Always detect the environment first
+- **Document everything** — Record discoveries for future missions
+- **Adapt to atmosphere** — Adjust behavior based on learnings  
+- **Act with confidence** — Execute precisely once the terrain is mapped
 
-| Agent | Role | Philosophy |
-|:-----:|:-----|:-----------|
-| 🎯 **Commander** | Orchestrator | Discover project → Delegate intelligently → Loop until sealed |
-| 📋 **Planner** | Strategist | Research docs → Plan with parallelism → Document findings |
-| 🔨 **Worker** | Implementer | Observe patterns → Learn conventions → Implement with fit |
-| ✅ **Reviewer** | Gatekeeper | Read standards → Run tests → Approve with evidence |
+This is **real-time adaptation**. Not pre-programmed scripts, but **living intelligence that transforms based on context**.
+
+### 🎭 Agents & Their Adaptive Behavior
+
+| Agent | Mission | Adaptive Behavior |
+|:-----:|:--------|:------------------|
+| 🎯 **Commander** | Orchestration | Discover project reality → Delegate dynamically → Loop until sealed |
+| 📋 **Planner** | Strategy | Research actual docs → Plan parallel paths → Document findings |
+| 🔨 **Worker** | Implementation | Observe patterns → Learn conventions → Implement with fit |
+| ✅ **Reviewer** | Verification | Read real standards → Run actual tests → Approve with evidence |
 
 ### Guiding Principles
 
-| Principle | Practice |
-|:----------|:---------|
-| 🔍 **Discover, Don't Assume** | Read `context.md`, detect tech stack, find build/test commands |
-| 📚 **Evidence Over Memory** | Cite docs, run actual commands, complete only with proof |
-| 🔄 **Adapt to the Project** | Match existing patterns, follow discovered conventions |
-| 🤝 **Separation of Concerns** | Each agent does one thing excellently |
+| Principle | Adaptive Practice |
+|:----------|:------------------|
+| 🔍 **Discover, Don't Assume** | Read `context.md`, detect stack, find actual commands |
+| 📝 **Learn & Document** | Record patterns, conventions, and findings for reuse |
+| 📚 **Evidence Over Memory** | Cite docs, run commands, complete only with proof |
+| 🔄 **Transform with Context** | Behavior evolves based on documented learnings |
+| 🤝 **Separation of Concerns** | Each agent masters one domain excellently |
 
 ---
 
@@ -106,6 +119,7 @@ In unfamiliar environments: **detect without assuming**, **adapt to discoveries*
 | 🔗 **Real-Time Sync** | Shared `.opencode/` state across all agents |
 | 🛡️ **Auto Verification** | E2E tests, import checks, integration validation |
 | 🩹 **Self-Healing** | Auto-recovery with 3 retries per session |
+| 🧬 **Adaptive Intelligence** | Agents evolve behavior based on discoveries |
 
 ### Self-Healing Details
 
@@ -141,14 +155,6 @@ In unfamiliar environments: **detect without assuming**, **adapt to discoveries*
 
 ---
 
-## 🗑️ Uninstall
-
-```bash
-npm uninstall -g opencode-orchestrator
-```
-
----
-
 ## 🎹 Developer's Words
 
 <div align="center">

package/dist/agents/prompts/commander/role.d.ts

@@ -1,6 +1,6 @@
 /**
  * Commander Role Definition
  *
- * The orchestrator who explores, adapts, and acts.
+ * The orchestrator who explores, learns, adapts, and acts.
  */
 export declare const COMMANDER_ROLE: string;

package/dist/agents/prompts/common/core-philosophy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core Philosophy
+ *
+ * The fundamental principle all agents share:
+ * Explore → Learn → Adapt → Act
+ *
+ * Learn = Document. What you discover, you record for future use.
+ */
+export declare const CORE_PHILOSOPHY: string;

package/dist/agents/prompts/common/index.d.ts

@@ -9,3 +9,4 @@ export { TODO_RULES } from "./todo-rules.js";
 export { SHARED_WORKSPACE } from "./shared-workspace.js";
 export { MISSION_SEAL_RULES } from "./mission-seal.js";
 export { VERIFICATION_REQUIREMENTS } from "./verification.js";
+export { CORE_PHILOSOPHY } from "./core-philosophy.js";

package/dist/agents/prompts/planner/role.d.ts

@@ -1,6 +1,6 @@
 /**
  * Planner Role
  *
- * The strategist who researches before planning.
+ * The strategist who explores and learns before planning.
  */
 export declare const PLANNER_ROLE: string;

package/dist/agents/prompts/worker/role.d.ts

@@ -1,6 +1,6 @@
 /**
  * Worker Role
  *
- * The implementer who observes before coding.
+ * The implementer who adapts and acts.
  */
 export declare const WORKER_ROLE: string;

package/dist/index.js

@@ -403,6 +403,7 @@ var PROMPT_TAGS = {
   TODO_RULES: { open: "<todo_rules>", close: "</todo_rules>" },
   MISSION_SEAL: { open: "<mission_seal>", close: "</mission_seal>" },
   SHARED_WORKSPACE: { open: "<shared_workspace>", close: "</shared_workspace>" },
+  CORE_PHILOSOPHY: { open: "<core_philosophy>", close: "</core_philosophy>" },
   // === Commander ===
   TOOLS: { open: "<tools>", close: "</tools>" },
   AGENTS: { open: "<agents>", close: "</agents>" },
@@ -530,6 +531,17 @@ var WORK_STATUS = {
   }
 };
 
+// src/shared/prompt/constants/philosophy.ts
+var PHILOSOPHY_PHASES = {
+  EXPLORE: "EXPLORE",
+  LEARN: "LEARN",
+  ADAPT: "ADAPT",
+  ACT: "ACT"
+};
+var PHILOSOPHY_TAGLINE = "Explore \u2192 Learn \u2192 Adapt \u2192 Act";
+var PHILOSOPHY_QUOTE = "Like an astronaut landing on unknown planets \u2014 never assume, always discover.";
+var PHILOSOPHY_LEARN_PRINCIPLE = "LEARN = DOCUMENT: What you discover, you record. Your learnings become the team's knowledge.";
+
 // src/core/agents/consts/task-status.const.ts
 var TASK_STATUS = {
   PENDING: "pending",
@@ -13302,19 +13314,39 @@ var VERIFICATION_REQUIREMENTS = `${PROMPT_TAGS.VERIFICATION.open}
 ONLY mark complete after ALL checks pass!
 ${PROMPT_TAGS.VERIFICATION.close}`;
 
+// src/agents/prompts/common/core-philosophy.ts
+var CORE_PHILOSOPHY = `${PROMPT_TAGS.CORE_PHILOSOPHY.open}
+## \u{1F9E0} Core Philosophy: ${PHILOSOPHY_TAGLINE}
+
+> ${PHILOSOPHY_QUOTE}
+
+| Phase | Action | Key Behavior |
+|:-----:|:-------|:-------------|
+| \u{1F50D} **${PHILOSOPHY_PHASES.EXPLORE}** | Scan unknown territory | Detect environment, never assume |
+| \u{1F4DD} **${PHILOSOPHY_PHASES.LEARN}** | Document discoveries | Record patterns for future use |
+| \u{1F504} **${PHILOSOPHY_PHASES.ADAPT}** | Adjust to findings | Match project's style and context |
+| \u26A1 **${PHILOSOPHY_PHASES.ACT}** | Execute with confidence | Build, test, seal |
+
+**${PHILOSOPHY_LEARN_PRINCIPLE}**
+
+### Agent Focus:
+- \u{1F3AF} **${AGENT_NAMES.COMMANDER}**: All phases (orchestrate the full cycle)
+- \u{1F4CB} **${AGENT_NAMES.PLANNER}**: ${PHILOSOPHY_PHASES.EXPLORE} \u2192 ${PHILOSOPHY_PHASES.LEARN} (research and document)
+- \u{1F528} **${AGENT_NAMES.WORKER}**: ${PHILOSOPHY_PHASES.ADAPT} \u2192 ${PHILOSOPHY_PHASES.ACT} (implement with fit)
+- \u2705 **${AGENT_NAMES.REVIEWER}**: ${PHILOSOPHY_PHASES.EXPLORE} \u2192 ${PHILOSOPHY_PHASES.LEARN} \u2192 ${PHILOSOPHY_PHASES.ACT} (verify with evidence)
+${PROMPT_TAGS.CORE_PHILOSOPHY.close}`;
+
 // src/agents/prompts/commander/role.ts
 var COMMANDER_ROLE = `${PROMPT_TAGS.ROLE.open}
 You are ${AGENT_NAMES.COMMANDER}. Autonomous mission controller.
 
-## Core Philosophy: EXPLORE \u2192 ADAPT \u2192 ACT
-1. **EXPLORE** - Discover project structure, environment, and context
-2. **ADAPT** - Adjust strategy based on what you find
-3. **ACT** - Execute with parallel delegation
+## Core Philosophy: ${PHILOSOPHY_TAGLINE}
+(See CORE_PHILOSOPHY for full details - you orchestrate ALL phases)
 
 ## Your Identity
-- You ORCHESTRATE - delegate, coordinate, and verify
+- You ORCHESTRATE - explore, learn, delegate, verify
 - You NEVER stop until the mission is SEALED
-- You READ ${PATHS.CONTEXT} to understand each project's unique needs
+- You READ and WRITE ${PATHS.CONTEXT} to share learnings
 - You ADAPT your approach to what the project requires
 ${PROMPT_TAGS.ROLE.close}`;
 
@@ -13725,15 +13757,13 @@ ${PROMPT_TAGS.SYNC_ISSUE_HANDLING.close}`;
 var PLANNER_ROLE = `${PROMPT_TAGS.ROLE.open}
 You are ${AGENT_NAMES.PLANNER}. Strategic planner and researcher.
 
-## Core Philosophy: RESEARCH \u2192 PLAN \u2192 DOCUMENT
-1. **RESEARCH** - Find official docs, verify syntax, check versions
-2. **PLAN** - Create TODO with parallel execution groups
-3. **DOCUMENT** - Cache research to ${PATHS.DOCS}/
+## Core Philosophy: ${PHILOSOPHY_TAGLINE}
+(Your focus: ${PHILOSOPHY_PHASES.EXPLORE} \u2192 ${PHILOSOPHY_PHASES.LEARN} \u2014 research and document)
 
 ## Your Identity
 - You NEVER guess - you VERIFY with official documentation
 - You READ ${PATHS.CONTEXT} to understand project's tech stack
-- You ADAPT plans to match project's existing patterns
+- You DOCUMENT findings to ${PATHS.DOCS}/ for future use
 - You CREATE ${PATHS.TODO} with maximum parallelism
 ${PROMPT_TAGS.ROLE.close}`;
 
@@ -14011,10 +14041,8 @@ ${PROMPT_TAGS.TODO_SYNC.close}`;
 var WORKER_ROLE = `${PROMPT_TAGS.ROLE.open}
 You are ${AGENT_NAMES.WORKER}. Implementation specialist.
 
-## Core Philosophy: OBSERVE \u2192 LEARN \u2192 IMPLEMENT
-1. **OBSERVE** - Study existing code patterns before writing
-2. **LEARN** - Understand project conventions and standards
-3. **IMPLEMENT** - Write code that fits naturally into the codebase
+## Core Philosophy: ${PHILOSOPHY_TAGLINE}
+(Your focus: ${PHILOSOPHY_PHASES.ADAPT} \u2192 ${PHILOSOPHY_PHASES.ACT} \u2014 implement with fit)
 
 ## Your Identity
 - You READ ${PATHS.CONTEXT} to understand build/test commands
@@ -14400,15 +14428,13 @@ ${PROMPT_TAGS.FILE_ASSIGNMENT.close}`;
 var REVIEWER_ROLE = `${PROMPT_TAGS.ROLE.open}
 You are ${AGENT_NAMES.REVIEWER}. Verification specialist.
 
-## Core Philosophy: UNDERSTAND \u2192 VERIFY \u2192 APPROVE
-1. **UNDERSTAND** - Read ${PATHS.CONTEXT} to know project's standards
-2. **VERIFY** - Run actual build/test commands, compare with docs
-3. **APPROVE** - Mark [x] ONLY with concrete evidence
+## Core Philosophy: ${PHILOSOPHY_TAGLINE}
+(Your focus: ${PHILOSOPHY_PHASES.EXPLORE} \u2192 ${PHILOSOPHY_PHASES.LEARN} \u2192 ${PHILOSOPHY_PHASES.ACT} \u2014 verify with evidence)
 
 ## Your Identity
 - You are the GATEKEEPER - nothing passes without evidence
 - You READ ${PATHS.CONTEXT} to know correct build/test commands
-- You COMPARE code with ${PATHS.DOCS}/ for correctness
+- You DOCUMENT findings to ${PATHS.SYNC_ISSUES} for fixes
 - ONLY YOU can mark [x] in ${PATHS.TODO} after verification
 ${PROMPT_TAGS.ROLE.close}`;
 
@@ -14791,6 +14817,7 @@ ${PROMPT_TAGS.SYNC_VERIFICATION.close}`;
 
 // src/agents/commander.ts
 var systemPrompt = [
+  CORE_PHILOSOPHY,
   COMMANDER_ROLE,
   COMMANDER_IDENTITY,
   COMMANDER_FORBIDDEN,
@@ -14819,6 +14846,7 @@ var commander = {
 
 // src/agents/subagents/planner.ts
 var systemPrompt2 = [
+  CORE_PHILOSOPHY,
   PLANNER_ROLE,
   PLANNER_FORBIDDEN,
   PLANNER_REQUIRED,
@@ -14842,6 +14870,7 @@ var planner = {
 
 // src/agents/subagents/worker.ts
 var systemPrompt3 = [
+  CORE_PHILOSOPHY,
   WORKER_ROLE,
   WORKER_FORBIDDEN,
   WORKER_REQUIRED,
@@ -14866,6 +14895,7 @@ var worker = {
 
 // src/agents/subagents/reviewer.ts
 var systemPrompt4 = [
+  CORE_PHILOSOPHY,
   REVIEWER_ROLE,
   REVIEWER_FORBIDDEN,
   REVIEWER_REQUIRED,

package/dist/shared/prompt/constants/index.d.ts

@@ -3,3 +3,4 @@
  */
 export { PROMPT_TAGS, wrapTag } from "./tags.js";
 export { WORK_STATUS } from "./status.js";
+export { PHILOSOPHY_PHASES, PHILOSOPHY_TAGLINE, PHILOSOPHY_QUOTE, PHILOSOPHY_LEARN_PRINCIPLE } from "./philosophy.js";

package/dist/shared/prompt/constants/philosophy.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Core Philosophy Phases
+ *
+ * The 4-phase cycle: Explore → Learn → Adapt → Act
+ */
+export declare const PHILOSOPHY_PHASES: {
+    readonly EXPLORE: "EXPLORE";
+    readonly LEARN: "LEARN";
+    readonly ADAPT: "ADAPT";
+    readonly ACT: "ACT";
+};
+/**
+ * Core philosophy tagline
+ */
+export declare const PHILOSOPHY_TAGLINE = "Explore \u2192 Learn \u2192 Adapt \u2192 Act";
+export declare const PHILOSOPHY_QUOTE = "Like an astronaut landing on unknown planets \u2014 never assume, always discover.";
+export declare const PHILOSOPHY_LEARN_PRINCIPLE = "LEARN = DOCUMENT: What you discover, you record. Your learnings become the team's knowledge.";

package/dist/shared/prompt/constants/tags.d.ts

@@ -45,6 +45,10 @@ export declare const PROMPT_TAGS: {
         readonly open: "<shared_workspace>";
         readonly close: "</shared_workspace>";
     };
+    readonly CORE_PHILOSOPHY: {
+        readonly open: "<core_philosophy>";
+        readonly close: "</core_philosophy>";
+    };
     readonly TOOLS: {
         readonly open: "<tools>";
         readonly close: "</tools>";

package/package.json

@@ -2,7 +2,7 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
-  "version": "0.9.31",
+  "version": "0.9.35",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {