Cognotik | CognitiveMode

⚙️ OrchestrationConfig.json

{
  "mode": "AdaptivePlanningMode",
  "schema_strategy": "ScientificMethod",
  "auto_fix": true,
  "model_config": {
    "smart": "gpt-4-turbo",
    "fast": "gpt-3.5-turbo"
  }
}

→

🧠 Live Transcript

State: Hypothesis Testing

graph TD A[Analyze Error] --> B{Hypothesis?} B -->|Network| C[Check DNS] B -->|Code| D[Run Linter] C --> E[Refute Hypothesis] E --> A

Thinking: Network checks passed. Switching strategy to Code Analysis.

Executing: RunCodeTask...

Architectural Patterns

Mode Name	Architecture	Best Use Case
WaterfallMode	`Plan -> Review -> Execute`	Well-defined problems where the user must approve the entire roadmap.
ConversationalMode	`Listen -> Act -> Reply`	Interactive debugging or simple "Chat with Code" workflows.
AdaptivePlanningMode	`Loop(Think -> Act -> Reflect)`	Complex, ambiguous goals requiring research and self-correction.
HierarchicalPlanningMode	`Tree(Decompose -> Delegate)`	Massive projects requiring sub-goal decomposition.

Strategy	Internal State	Reasoning Style
Project Manager	`ReasoningState`	Generalist. Tracks short-term vs. long-term goals.
Scientific Method	`ScientificState`	Debugger. Formulates hypotheses and attempts to falsify theories.
Agile Developer	`AgileState`	Coder. Follows TDD loop: Test Failing -> Implementing -> Refactoring.
Critical Auditor	`AuditState`	Security. Adversarial mindset designed to find flaws.

Implementation Skeleton

To create a custom mode, extend CognitiveMode and implement the handleUserMessage loop.

class MyCustomMode(
    config: OrchestrationConfig,
    session: Session,
    user: User
) : CognitiveMode<MyConfig>(config, session, user) {

    override fun handleUserMessage(userMessage: String, task: SessionTask) {
        // 1. Initialize Strategy (The "Brain")
        val strategy = CognitiveSchemaStrategy.ScientificMethod
        var state = strategy.initialize(userMessage, orchestrationConfig.smartModel)

        // 2. Execution Loop
        while (!state.isComplete()) {
            val guidance = strategy.getTaskSelectionGuidance(state)
            
            // Select & Execute Task
            val tool = enabledTasks.first { it.canHandle(guidance) }
            val result = tool.execute(task, guidance)

            // Update State (Reflection)
            state = strategy.update(state, result)

            // Observability: Write to transcript
            task.transcript()?.write("## Step Complete: ${state.currentPhase}\n".toByteArray())
        }
    }
}

Integration Guide

Configuration

Reference your mode in the OrchestrationConfig.

val config = OrchestrationConfig(
    mode = CognitiveModeType.AdaptivePlanningMode,
    overrides = mapOf("schema_strategy" to "AgileDeveloper"),
    autoFix = true
)

Observability Standards