diff --git a/docs/taskplane-overview/01-origin-timeline.html b/docs/taskplane-overview/01-origin-timeline.html index dc80ef98..ead0025b 100644 --- a/docs/taskplane-overview/01-origin-timeline.html +++ b/docs/taskplane-overview/01-origin-timeline.html @@ -147,4 +147,14 @@

The road to Taskplane

Taskplane
today · deterministic orchestration
Four agents. Verbose packets. File-backed state. Worktree isolation. Cross-model reviews. Semantic merges. A web-based dashboard to drive observability.
-
rule → < \ No newline at end of file +
rule → Autonomy is fine. Inspectable autonomy is the goal.
+
+ + + + + + + diff --git a/docs/taskplane-overview/02-light-factory-vs-dark.html b/docs/taskplane-overview/02-light-factory-vs-dark.html index 74bdc875..77c0af6c 100644 --- a/docs/taskplane-overview/02-light-factory-vs-dark.html +++ b/docs/taskplane-overview/02-light-factory-vs-dark.html @@ -130,4 +130,15 @@

Light factory vs dark factory

  • File-backed state. .DONE, STATUS.md, batch-state.json. Resume from any crash.
  • Worktree isolation. Every lane is its own checkout. No collisions, ever.
  • Cross-model reviews. Different family on the other side. Independent quality gate.
  • -
  • Dashboard reads disk. SSE-streamed truth. Cannot lie. Doesn't decide.
    Dashboard reads disk. SSE-streamed truth. Cannot lie. Doesn't decide.
  • + +
    visibility → full · recoverability → atomic · operator clarity → first-class
    + + + + + + + diff --git a/docs/taskplane-overview/03-agent-quartet.html b/docs/taskplane-overview/03-agent-quartet.html index 5d56509b..1039527f 100644 --- a/docs/taskplane-overview/03-agent-quartet.html +++ b/docs/taskplane-overview/03-agent-quartet.html @@ -189,4 +189,8 @@

    The agent quartet

    - supervisor spawns workersupervisor spawns worker per lane worker calls reviewer at step boundaries wave completes merger combines lanes next wave +
    + + + diff --git a/docs/taskplane-overview/04-task-packet-anatomy.html b/docs/taskplane-overview/04-task-packet-anatomy.html index ed1ed4a8..77789191 100644 --- a/docs/taskplane-overview/04-task-packet-anatomy.html +++ b/docs/taskplane-overview/04-task-packet-anatomy.html @@ -190,4 +190,3 @@

    Anatomy of a Taskplane task packet

    - \ No newline at end of file diff --git a/docs/taskplane-overview/05-determinism-spectrum.html b/docs/taskplane-overview/05-determinism-spectrum.html index d5e01028..738e1d0d 100644 --- a/docs/taskplane-overview/05-determinism-spectrum.html +++ b/docs/taskplane-overview/05-determinism-spectrum.html @@ -176,4 +176,15 @@

    Where Taskplane sits on the determinism spectrum

  • Supervisor steeringwhen / what to inject
  • Discovery hydrationcheckbox expansion at runtime
  • Verify-then-fixtest failures post-merge
  • -
  • Exit inter \ No newline at end of file +
  • Exit interceptionsupervisor re-steer up to 2×
  • + + + + +
    + Two runs of the same batch produce the same waves, the same lanes, the same branch names —
    + only the contents of the model's tokens differ. +
    + + + diff --git a/docs/taskplane-overview/06-cross-model-review.html b/docs/taskplane-overview/06-cross-model-review.html index bd951380..5051dc95 100644 --- a/docs/taskplane-overview/06-cross-model-review.html +++ b/docs/taskplane-overview/06-cross-model-review.html @@ -258,4 +258,15 @@

    Cross-model reviews

    UNAVAILABLE
    -
    Reviewer crashed / timed out. Worker proceeds cautiously. Logged for the operator.
    Reviewer crashed / timed out. Worker proceeds cautiously. Logged for the operator.
    + + + + + + + + diff --git a/docs/taskplane-overview/07-mailbox-protocol.html b/docs/taskplane-overview/07-mailbox-protocol.html index 86eed5e5..27934e66 100644 --- a/docs/taskplane-overview/07-mailbox-protocol.html +++ b/docs/taskplane-overview/07-mailbox-protocol.html @@ -203,4 +203,13 @@

    The file-based mailbox

    bidirectional
    -
    agents reply into \ No newline at end of file +
    agents reply into outbox/ — the engine polls and surfaces alerts to the supervisor.
    +
    +
    +
    portable
    +
    windows, macOS, linux — same protocol. no sockets, no named pipes, no daemon.
    +
    +
    + + + diff --git a/docs/taskplane-overview/08-waves-lanes-worktrees.html b/docs/taskplane-overview/08-waves-lanes-worktrees.html index 9e996ea4..4d80f112 100644 --- a/docs/taskplane-overview/08-waves-lanes-worktrees.html +++ b/docs/taskplane-overview/08-waves-lanes-worktrees.html @@ -297,4 +297,13 @@

    Batch, waves, lanes, worktrees, tasks

    Lanes are parallel
    -
    Up to max_lanes within a \ No newline at end of file +
    Up to max_lanes within a wave. Each lane is one subprocess worker against one worktree against one branch.
    +
    +
    +
    Tasks share lanes when scopes overlap
    +
    Affinity-first assignment. Overlapping ## File Scope entries collapse onto the same lane and run serially.
    +
    +
    + + + diff --git a/docs/taskplane-overview/09-branching-lifecycle.html b/docs/taskplane-overview/09-branching-lifecycle.html index ba1dc298..74efb145 100644 --- a/docs/taskplane-overview/09-branching-lifecycle.html +++ b/docs/taskplane-overview/09-branching-lifecycle.html @@ -244,4 +244,21 @@

    How Taskplane uses branches

    wave merge
    After each wave, a merge agent combines lane branches back into orch. Next wave sees the previous wave's merged changes.
    -
    +
    4
    +
    all waves complete
    +
    Orch branch now holds the full batch result. Your working branch is still untouched.
    +
    +
    +
    5
    +
    /orch-integrate
    +
    Fast-forward, merge commit, or open a PR. Your choice. Always an explicit step.
    +
    + + +
    + your working branch is sacred — never touched until /orch-integrate +
    + + + diff --git a/docs/taskplane-overview/10-semantic-merge.html b/docs/taskplane-overview/10-semantic-merge.html index 758b071d..a86addcd 100644 --- a/docs/taskplane-overview/10-semantic-merge.html +++ b/docs/taskplane-overview/10-semantic-merge.html @@ -200,4 +200,14 @@

    Semantic merge vs git merge

    5
    result.json
    -
    Engine polls. Counters u \ No newline at end of file +
    Engine polls. Counters update. Next wave provisions.
    +
    +
    + + +
    + merge health monitor polls every 2 min · stale at 10 · stuck at 20 · emits events, never kills autonomously +
    + + + diff --git a/docs/taskplane-overview/11-polyrepo-segments.html b/docs/taskplane-overview/11-polyrepo-segments.html index 1a4af69d..2b6734a1 100644 --- a/docs/taskplane-overview/11-polyrepo-segments.html +++ b/docs/taskplane-overview/11-polyrepo-segments.html @@ -274,4 +274,12 @@

    Polyrepo: tasks decompose into segments

    Segment isolation
    Workers read across all repos for planning. They write only to the active segment repo + the packet home.
    -
    \ No newline at end of file + +
    +
    Per-repo orch branches
    +
    An orch/… branch is created in every repo with work. /orch-integrate loops over all of them.
    +
    + + + + diff --git a/docs/taskplane-overview/12-dashboard-visibility.html b/docs/taskplane-overview/12-dashboard-visibility.html index a467250b..72ee4f37 100644 Binary files a/docs/taskplane-overview/12-dashboard-visibility.html and b/docs/taskplane-overview/12-dashboard-visibility.html differ