Skip to content

[Work Governance / Research] Calibrate adaptive scouting, decomposition, and delegation policy #94

Description

@Sequela02

Objective

Determine and benchmark when Kiln should keep scouting and execution in the primary agent, delegate a bounded investigation, or use a coordinated multi-agent topology. Replace the current assumption that non-trivial work benefits from orchestration by default with a measured, provider-neutral decision policy if the evidence supports that change.

This issue authorizes research, fixtures, and evaluation design. It does not authorize changing the production default before the promotion gate passes.

Related work

Decision questions

  1. Should the primary agent perform a minimal repository orientation before any delegation?
  2. Which measurable task properties justify a delegated scout: search breadth, context pressure, independent questions, specialization, latency, or another signal?
  3. When does delegated scouting with the same model or a cheaper model improve success, total cost, latency, or retained root context?
  4. What is the correct decomposition unit: independently testable and reviewable result, file count, estimated duration, or another contract?
  5. Which dependency, write-overlap, tool-density, and shared-state conditions require direct or sequential execution?
  6. When does a reviewer add value beyond deterministic tests, typecheck, lint, builds, invariants, and diff inspection?
  7. Which context envelope should a child receive: full fork, curated contract, or isolated task plus durable resources?
  8. Which fan-out, depth, retry, and budget limits prevent coordination pathologies without suppressing useful parallelism?

Current evidence

The evidence is conditional rather than supportive of one universal posture:

No searched source provides a controlled repository benchmark comparing primary-agent scouting with same-model and cheaper delegated scouts. Kiln must measure that locally.

Required benchmark

Use real, replayable Kiln tasks stratified by dependency shape, write overlap, tool count, repository familiarity, expected context volume, and single-agent baseline competence.

Compare:

  • scouting: primary-agent orientation, same-model delegated scout, cheaper-model delegated scout;
  • execution: direct/sequential, centralized manager-worker, independent parallel work;
  • verification: deterministic oracles only, reviewer plus deterministic oracles;
  • context: full fork, curated task envelope, isolated task plus resource references.

Run both fixed-budget and unconstrained observations, with at least 3?5 repetitions per admitted cell. Record deterministic task success first, then escaped defects, total provider tokens by class, coordinator turns, latency, retries, rework, merge conflicts, duplicated exploration, context/handoff loss, false approvals, child count/depth, and operator intervention. Unknown usage remains unknown.

Do not run meaningless Cartesian cells. Pre-register exclusions such as parallel mutation of a shared file or a reviewer condition without an external oracle.

Candidate policy shape

A candidate may be evaluated with these provisional rules:

  • direct execution is the baseline;
  • the primary agent performs only enough orientation to frame bounded questions and retain integration responsibility;
  • delegate scouting only for specific independent questions or context-heavy searches;
  • parallelize only independent work with non-overlapping mutable ownership;
  • use a centralized integrator when child outputs affect one final decision;
  • treat reviewer output as a hypothesis; completion requires available external oracles;
  • decompose by independently completable, testable, and reviewable outcome rather than a fixed file or LOC threshold;
  • cap fan-out, depth, retries, and total coordination budget.

These are hypotheses, not accepted defaults.

Acceptance criteria

  • Repository fixtures and strata are published with exact candidate/config/model/harness identities.
  • Baseline, candidate, and relevant ablations are replayable.
  • The scout comparison includes primary, same-model child, and cheaper-model child conditions.
  • Quality, cost, latency, coordination overhead, rework, and failed/omitted runs are reported.
  • Deterministic oracles remain separate from LLM reviewer judgments.
  • The decision policy uses measurable task properties and reports uncertainty or unsupported capability.
  • Any default change includes migration/deletion of the superseded path, without a compatibility variant.
  • Work Governance architecture, coordination architecture, instruction doctrine, skills, config descriptors, and native projections are updated together only after promotion.
  • Independent benchmark-readiness and architecture review have no unresolved high or medium findings.

Non-goals

  • No universal requirement to delegate scouting.
  • No universal preference for a cheap scout.
  • No fixed task size expressed solely as files, LOC, or minutes.
  • No mandatory Planner-Executor-Verifier topology.
  • No inference that more agents, more tokens, or more reviews imply better work.
  • No transfer of coordination-policy ownership into Roadmap 12 or skill prose.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions