Structured Workflows, Local State, and Why We Built It

Meitar Bruner

Maintainer of Cognetivy

Recent updates to Cognetivy - templates, Studio UX, traceability, and the run engine - aren't just feature drops. They're a bet on how we think the world of AI coding agents is heading: structured workflows, local-first state, and auditability.

The shift from ad-hoc prompts to structured engineering

Industry observers have called out the same bottleneck: the limit isn't model capability, it's workflow design. Treating agents as smart autocompleters leads to context fragmentation and no traceability (Dypsis). Real-world AI-assisted development is moving toward multi-phase flows: plan → implement → validate, with clear structure instead of one-off prompts.

Local-first state and auditability

Cloud-only agent state is brittle and opaque. The trend is local-first observability and auditability - agent memory and execution logs on your machine, with deterministic replay and no required cloud (SochDB / local-first agents). Cognetivy fits that: everything lives in .cognetivy/ (workflows, runs, events, collections). No LLMs in the engine; you inspect everything in Studio.

Cognetivy's recent changes highlight traceability (citations, derived_from, reasoning on every collection kind) and the Studio UX (schema drawer, run canvas, version diff). That's not decoration - it's so you can see where outputs came from and how the run behaved.

What we shipped lately

  • Templates: Interactive picker, apply-by-id, mandatory template choice at install, and templates with real parallel DAG lanes.
  • Run engine: Clear next_step (run_node, run_nodes_parallel, complete_node, complete_run), so agents follow the hint instead of guessing.
  • Studio: Schema drawer, run detail improvements, collection-node affordances, and version diff on the workflow canvas.
  • Traceability: Optional citations and derived_from on collection items so outputs are traceable to sources and chain of thinking.

Sources: Dypsis – structured engineering, 2025 reality check, DTX – practitioners guide, MCP guide, Microsoft Copilot MCP, Local-first observability.