Skip to content

spec: the developer council (2 to 5 heterogeneous models on one OpenSpec change) - #5

Merged
welsbach merged 2 commits into
mainfrom
spec-developer-council
Jul 23, 2026
Merged

spec: the developer council (2 to 5 heterogeneous models on one OpenSpec change)#5
welsbach merged 2 commits into
mainfrom
spec-developer-council

Conversation

@asdd-agent

@asdd-agent asdd-agent Bot commented Jul 23, 2026

Copy link
Copy Markdown

Disclosure (required: ASDD 1)

  • Authored or co-authored by an AI agent under human direction.

Agent identity: claude-code (Opus 4.8) - Instructed by (human handle): @welsbach

Change scope (required: ASDD framework-impact lens)

  • Non-normative: an optional operate-layer capability. It does not change the standard, and it does not weaken the independence rules (the council is a developer; review and test stay independent).

What this does

Adds the approved spec for the developer council: an optional produce-loop developer that implements an OpenSpec change with 2 to 5 heterogeneous models that propose, cross-critique, synthesize and verify against the spec's tests, and always return one result to the user.

Key decisions, locked with the maintainer:

  • Spec-and-test-grounded, not consensus (proposers draft against acceptance criteria; the verify stage reuses the existing test-author/test-runner agents on distinct models).
  • Fixed roles: proposers plus one lead synthesizer (the strongest model produces the answer).
  • 2 to 5 models, default 3; both provider modes (per-model tokens or one multi-model provider).
  • Runtime-neutral (asdd dev-council), so it works in every operator kit (Goose + bring-your-own).
  • The council's proposals, critiques, disagreements and synthesis rationale are recorded to the audit log, so corpus and knowledge derive from it and the system learns from the council's process over time.

This is the spec-driven first step. The implementation follows as its own PR against this spec.

Spec: docs/specs/developer-council.md.

Christoph added 2 commits July 23, 2026 07:54
…pec change)

The approved design for an optional produce-loop developer that implements an
OpenSpec change with 2 to 5 diverse models that propose, cross-critique,
synthesize and verify against the spec's tests, and always return one result.
Spec-and-test-grounded (not consensus), fixed proposer + lead-synthesizer roles,
both provider modes, reuses the test agents for verify, records the council's
reasoning to the audit log so the system learns from it, and runtime-neutral so
it works in every operator kit. Non-normative: the council is a developer;
review and test stay independent, and it never merges or reviews itself.

This is the spec-driven first step; the implementation follows against it.

Agent: claude-code (Opus 4.8)
Signed-off-by: Christoph <awchristoph@gmail.com>
Expand the acceptance criteria so "delivered in every operator kit" is testable,
not implied: the orchestrator ships with a self-test, the Goose kit wires it and
init copies it (completeness asserted), the bring-your-own runtime contract is
documented in agents/runtime.md, and every reference surface documents it.

Agent: claude-code (Opus 4.8)
Signed-off-by: Christoph <awchristoph@gmail.com>
@asdd-agent
asdd-agent Bot requested a review from welsbach as a code owner July 23, 2026 06:31
@asdd-agent asdd-agent Bot added the feature label Jul 23, 2026
@github-actions

Copy link
Copy Markdown

ASDD review - advisory (recommendation: comment)

Produced by an automated agent under human direction. Advisory only: a human approves and merges.
Nothing here merges automatically.

Dry-run: no agent runtime is wired yet, so this is a placeholder. The lenses become live once a runtime is connected.

Dry-run: the ASDD review pipeline ran but no agent runtime is wired (no runtime key (set ASDD_RUNTIME_TOKEN, or ASDD_RUNTIME_TOKEN__REVIEWER for this role)). Diff stats only. Security scan (deterministic + SAST): no new issues. Impact scan: 1 finding(s), 0 block.

CODE - skipped

No findings.

SECURITY - ok

No findings.

SPEC - skipped

No findings.

QUALITY - skipped

No findings.

IMPACT - ok

  • note: No normative text or behavioural surface touched; classified non-normative.

Generated by the ASDD advisory review. Mode: dry-run.

@welsbach welsbach left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Accepted

@welsbach
welsbach merged commit cb94d6b into main Jul 23, 2026
12 checks passed
@welsbach
welsbach deleted the spec-developer-council branch July 30, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant