Skip to content

Add harness vision & roadmap design doc - #63

Open
MuJiongan wants to merge 2 commits into
mainfrom
emdash/brainstorm-08ka9
Open

Add harness vision & roadmap design doc#63
MuJiongan wants to merge 2 commits into
mainfrom
emdash/brainstorm-08ka9

Conversation

@MuJiongan

Copy link
Copy Markdown
Owner

What

Adds docs/harness-vision.md — a design doc capturing the direction for evolving Ensemble from a workflow builder into a custom agent harness, and links it from the README.

Why

Direction-setting from a brainstorm. The doc is grounded in the current architecture (real file paths, table names, the node REGISTRY, null-propagation, the design invariants) so it stands on its own and stays useful when revisited.

Contents

  • The reframe — graph builder → agent-system compiler + runtime + registry, across three layers (authoring / execution semantics / distribution)
  • Where we are today — a grounded snapshot of the current system
  • Five workstreams, each as current state → gap → concrete moves:
    • Tool creation (synthesized tools, tool-from-workflow, policy wrappers)
    • Compaction (pluggable strategies, ctx.memory, compaction-as-hook)
    • LLM primitives (structured output, sample/judge/vote, classify/embed, spawn, budgets)
    • Hooks & loop control (lifecycle events, gate/mutate/repair, declarative stop conditions)
    • Packaging & reuse (subworkflow node, local library, orchestrator recruits)
  • Natural extensions — eval/regression, triggers, typed contracts, replay
  • Invariants to preserve — pull-not-push, plan-not-do, acyclic, isolation-≠-sandbox
  • A suggested arc and an open-decisions list

Notes

No code changes — documentation only.

🤖 Generated with Claude Code

Jiongan Mu added 2 commits June 19, 2026 19:23
Captures the direction for evolving Ensemble from a workflow builder into a
custom agent harness: tool creation, LLM primitives, hooks/loop control,
pluggable compaction, and packaging workflows as reusable subworkflows.
Grounded in the current architecture, with invariants and a suggested arc.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant