AI-DLC Workflows 2.0 - Roadmap
Status as of 2026-09-11.
- The latest stable release is 2.8.2 (tag
v2.8.2, commit355903d6). The currentorigin/maintip is0a21d7fband contains unreleased work merged after that tag. Release-preparation pull requests own release metadata changes. - AI-DLC Workflows 2.0 is GA. Users install and update from the latest
stable GitHub Release;
mainis the active development branch. The earlier implementation is maintained separately onv1. - Native binaries, installers, version selection, project configuration and
release provenance shipped through #722 and #756. GitHub marks
v2.8.2as Latest. Stable and preview publication use separate release paths (#1008, #1127, #1129). - PR validation now includes the deterministic integration and end-to-end tiers in addition to smoke, unit, packaging, typecheck and lint (#791).
Published version ranges below identify the release where work became
available. Rows marked as post-release identify work already on main but not
yet included in a stable release. Future themes and open pull requests are
directional, not committed release promises.
North star reference
The seven functional goals of the AI-DLC Workflows 2.0 North Star, verbatim in intent:
- Mimic what we practice in the real world - a stage executed by a configurable ensemble (Owner, Collaborator, Verifier) with consistent semantics across harnesses.
- Customization of behaviour - encode new behaviours, policies, or constraints in no more than two targeted changes, reusable across harnesses without tool-specific rewrites.
- Adaptiveness of workflows - scale in (report triage to compact Fix, Test, PR) and scale out (decide next stages at boundaries); composition not hard-wired.
- Verifier as a true adversary - adversarial quality gate; may use a different LLM than the producer; validates against machine-checkable evidence; budgeted self-heal loop escalating to HITL.
- Support for cyclic, directional flows - forward progression plus governed, directional feedback loops.
- Preserve artefact traceability - downstream stages enrich upstream artefacts rather than spawning disconnected ones.
- Organizational, not project-local, artefact repository - shared org knowledge layer across projects, intents, and repos; six named scenarios.
Strategic delivery pillars
Two strategic pillars shape how the North Star reaches users and evolves:
- Productization and lifecycle (#722) - the native distribution baseline is shipped. Current work focuses on provider-neutral configuration, filesystem safety, project migration and release-channel hardening.
- Plugin ecosystem and marketplace (#723) - make trusted extensions discoverable, installable and reusable, with a clear path from external plugin to first-party capability.
Goal scorecard
| # | Goal | Status | Delivered by | Remaining work |
|---|---|---|---|---|
| 1 | Real-world ensemble | Shipped | 2.5.0 independent collaborators and selectable topologies (#568), enforced reviewer receipts (#569), batch-parallel per-unit waves (#617), team-owned parallel Units (#879) | Harness-native live-team transports remain an enhancement |
| 2 | Customization | Shipped, with follow-ups | 2.3.0 plugin seam, 2.3.5 content projection/selection (#550), deterministic rule delivery (#658), plugin scopes (#664), reusable plugin test kit (#792), plugin doctor extensions (#797), standalone authoring toolchain (#892) | Marketplace delivery is active in #1104; stage ordering (#1100), stage-specific rules and when: evaluation remain open |
| 3 | Adaptiveness | Shipped | 2.2.0 composer, entropy-scored composition (#595), deterministic ARS (#644), unit-major Code Generation (#705), Classic/Express scopes and conditional protocol modules (#767), per-session workflow bindings (#858) | First-class amendment and feedback ingestion (#1122-#1124) and on-demand Construction autonomy (#1142) are open extensions |
| 4 | Verifier as adversary | Shipped | 2.4.0 adversarial evidence contract (#566), gate-and-completion enforcement (#569, #551), reviewer-class cost dial (#718), turn/recovery backstops (#613, #758), gate-bound blocking sensors (#836) | Pull-request-level adversarial review (#799) and explicit producer/reviewer verification disciplines (#1134, #1136) remain open |
| 5 | Cyclic flows | Partial | Within-stage review/revision loops, bounded recovery mechanics, explicit human-authorized forward/backward/redo stage jumps, and bounded Build & Test to Code Generation loop-back (#616) | General governed cross-stage feedback loops remain unbuilt |
| 6 | Traceability | Partial | Artefact graph, upstream coverage, per-stage enforcement (#401), claim provenance (#647, #686), shared CodeKB safeguards (#670), domain/contract boundaries (#711), stale-result propagation (#716), source-bound and per-Unit review receipts (#646, #813), commit-to-intent resolution (#1052) | Progressive in-place enrichment, cross-unit discovery propagation (#299) and one-byte commit-provenance fidelity |
| 7 | Org repository | Shipped | 2.1.0 spaces/intents/org-KB, declared multi-repo manifest and sync (#674), clone-safe active-space cursor (#709), DocumentKB indexing and citations (#731), summaries and tags (#894) | Auditable supplemental-knowledge selection remains an active extension (#694) |
Delivered
| Version | Capability | Goal | Key PRs |
|---|---|---|---|
| 2.0.0 - 2.0.2 | GA preview: reviewer mechanism, multi-harness core, agent roster | 1, 4 | v2 baseline |
| 2.1.0 | Per-intent workspace: spaces, intents, multi-repo, org-KB | 7 | #429 |
| 2.1.2 | Per-unit for_each iteration |
3 | #444 |
| 2.1.3 - 2.1.8 | Loop integrity and reviewer wiring across harnesses | 1, 4, 5 | #405, #443, #466, #482 |
| 2.2.0 - 2.2.19 | Adaptive workflows, composer, scale-in and Construction hardening | 3 | #477, #491, #509-#512, #520-#522, #525 |
| 2.3.0 - 2.3.5 | Plugin mechanism, agent tiers, install-time plugin selection and content projection | 2, 4 | #475, #546, #550 |
| 2.3.6 - 2.3.11 | Phase progress, citation-aware upstream coverage, pinned lint and gate accounting | 4, 6 | #562, #563, #572, #573 |
| 2.4.0 | Reviewer-as-verifier: adversarial, evidence-grounded review | 4 | #566 |
| 2.4.2 - 2.4.6 | Whole-root packaging, native dispatcher/binaries, documentation parity and opencode harness | 1, 2 | #560, #571, #577, #578, #581 |
| 2.5.0 | Three-role ensemble: independent collaborators, pipeline, mob and hub-and-spoke | 1 | #568 |
| 2.5.1, 2.5.25 | Entropy-scored minimum workflow composition and deterministic ARS | 3 | #595, #644 |
| 2.5.2 | Redacted /aidlc --doctor --export diagnostic bundle |
- | #576 |
| 2.5.5, 2.5.39, 2.5.41, 2.5.54-2.5.55 | Reviewer receipts, review freeze, plan-before-code guard, reviewer classes and authorization receipts | 1, 4 | #569, #677, #692, #702, #718 |
| 2.5.11, 2.5.38, 2.5.57-2.5.58 | Claim provenance, pre-generation confirmation and project-language grounding | 6 | #647, #686, #703, #707 |
| 2.5.33 - 2.5.36 | Deterministic steering delivery, plugin scopes, CodeKB preservation and workspace manifest/sync | 2, 7 | #658, #664, #670, #674 |
| 2.5.40, 2.5.53 | Per-stage token/cost accounting, opt-in metrics and usage-tracking kill switch | - | #673, #720 |
| 2.5.56 | Code Generation joins the unit-major Construction walk | 3 | #705 |
| 2.5.60 | GitHub Copilot harness for Copilot CLI and VS Code agent mode | 1, 2 | #657 |
| 2.5.63 | Cursor harness | 1, 2 | #661 |
| 2.5.67 | Batch-parallel per-unit waves and foreground reviewers | 1, 4 | #617 |
| 2.5.71 - 2.5.75 | Per-stage traceability enforcement, design-stage code boundaries, test-instruction ownership and first-class observability artifacts | 4, 6 | #401-#404 |
| 2.6.1 - 2.6.2 | Domain/contract design restructuring, consolidated infrastructure design and follow-up guards | 1, 6 | #711, #751 |
| 2.6.8 - 2.6.9 | Reviewer turn backstop and bounded stale-receipt recovery | 4 | #613, #758 |
| 2.6.12 - 2.6.14 | Copilot continuation stability, gate authorship enforcement and audit timestamp normalization | 1, 4 | #749, #750, #759 |
| 2.6.15 | DocumentKB S1 indexing and citation delivery | 7 | #731 |
| 2.6.16 | Code Generation plans bound to the affirmed Testing Posture | 4, 6 | #772 |
| 2.6.17 | Reusable plugin test kit and plugin-author testing tiers | 2 | #792 |
| 2.6.18 | Classic and Express scopes, Classic implicit default and conditional protocol modules | 2, 3 | #767 |
| 2.6.20 | Bounded Build & Test to Code Generation failure loop-back | 5 | #616 |
| 2.6.37 | Code Generation review receipts bound to workspace source state | 4, 6 | #646 |
| 2.6.51 - 2.6.64 | Continuation cursor, Kiro reliability, plugin-extensible doctor checks, stage-validity receipts and native Kiro IDE surfaces | 1, 2, 4, 6 | #822, #788, #797, #716, #824 |
| 2.6.69 | Per-Unit source attribution for Code Generation review receipts | 4, 6 | #813 |
| 2.6.72 - 2.6.74 | Gate-bound blocking sensors and binding quality-target verification | 4, 6 | #836, #842 |
| 2.6.80 | Per-session workflow bindings for concurrent intents in one space | 3, 7 | #858 |
| 2.6.87 | DocumentKB summaries and tags | 7 | #894 |
| 2.6.105 | Standalone plugin create, validate, build and test toolchain | 2 | #892 |
| 2.6.107 | Team-owned Units and parallel Construction across teams | 1, 3 | #879 |
| 2.6.114 | No-DAG per-Unit review continuity | 1, 4 | #947 |
| 2.6.121 - 2.6.124 | Immutable reviewer evidence, Git-independent source binding and portable workflow state paths | 4, 6 | #888, #904, #962 |
| 2.7.0 - 2.8.0 | Native binaries, installers, project configuration, version selection, update and tag-bound release provenance | - | #756, #993, #1050 |
| 2.7.1 - 2.8.2 | Plan Approval and Change Control hardening, cross-harness native-hook repairs, config wizard fixes and stable/preview release channels | 1, 3, 4 | #997, #1000, #1054, #1064, #1065, #1067, #1008, #1097, #1111, #1127, #1129 |
Post-2.8.2 on main |
Commit-to-intent provenance resolution | 6 | #1052 |
Post-2.8.2 on main |
Intent archive/unarchive lifecycle | - | #1033 |
Open implementation tracks
Selected open work is listed without version claims. This is not the complete pull-request backlog. Each linked pull request is authoritative for review and merge state.
| PR | Work | Theme |
|---|---|---|
| #1104 | Registered plugin marketplaces, search, verified install/update and graduation support | Plugins and marketplace |
| #1101 | Preserve the current model provider unless the user selects Bedrock | Configuration |
| #1107 | Preserve existing .gitignore rules and report unsupported config filesystems |
Configuration |
| #1063 | Serve Kiro CLI and Kiro IDE from one maintained distribution | Harness parity |
| #1135, #1138 | Explicit verification disciplines for reviewer and producing personas | Verification |
| #1140 | Grant Construction autonomy on demand | Adaptive workflow |
| #1141 | Add visual direction and foundation-token contracts to Design | Design workflow |
Directional themes
These themes are supported by open RFCs, issues or implementation pull requests, but do not yet have committed release versions.
Traceability and progressive enrichment
- Per-stage upstream traceability enforcement shipped in #401. Source-bound review evidence shipped in #646, stale stage-result propagation shipped in #716, and per-Unit attribution shipped in #813.
- Cross-unit discovery propagation remains open (#299/#300).
- Preserve progressive enrichment as the North Star destination: downstream stages enrich upstream artefacts in place, with ADRs as a core design artefact.
- Commit-level provenance is implemented as content-derived attribution:
reviewed-source evidence is committed into the intent record and
aidlc attest resolvemaps any commit or diff range back to its owning units, intents, and drift status — receipts and evidence are read out of a git tree, so no hooks, trailers, session state, or local record state are required (see Commit Provenance). Resolution reports integrity; authority over the record is the verifier's to supply, via--record-ref(a record source the change cannot write) and--require-trust(a gate on the report's own basis).SOURCE_COMMITTEDanchoring is enrichment and stays explicit (attest anchor), with an opt-in session-start sweep behindAIDLC_SESSION_ANCHOR=1. - One commit-provenance fidelity gap stays open behind that foundation,
reported in
resolve'swarnings[]today (see Commit Provenance §10): one byte form — review evidence hashes working-tree bytes while commit listings read repository blobs, so LFS,core.autocrlf, working-tree encodings, and submodule gitlinks can report unchanged content asdrifted. Reconciling them changes what theUnit Source Fingerprintis computed over, so it needs its own change with a migration story for existing receipts. Beyond it, richer trust roots remain future work: per-approval signatures and an identity policy for who may approve (today'ssignedlevel checks git's commit-level%G?on whoever last wrote each authority-bearing file — the receipt's audit shard and the evidence it selects — not a reviewer identity).
Governed feedback loops
- #616 shipped one bounded Build & Test to Code Generation return path for #611. It is an incremental loop, not a general cyclic graph engine.
- General cross-stage backward edges still need engine-level governance, stale artefact handling and explicit human authorization.
Plugins and marketplace
- The plugin mechanism, content projection, selection and plugin-contributed scopes are shipped; the plugin test kit and authoring tiers shipped in #792.
- Plugin-extensible doctor checks shipped in
#797. The offline plugin
CREATE, VALIDATE, BUILD, and TEST authoring tiers ship as
the standalone
aidlc-plugin-create.ts,aidlc-plugin-validate.ts,aidlc-plugin-build.ts, andaidlc-plugin-test.tstools. The top-levelplugin validateandplugin buildroutes also ship. Top-levelplugin createandplugin testroutes remain proposed in #723. Registered marketplaces, remote search, verified install/update, catalog emission and graduation tombstones are under implementation in #1104. Creating the first-party marketplace repository and completing the first graduation stay outside that pull request. Product discovery (#652, #782) and design (#527) are candidates for first-party plugins. aidlc-plugin-test.tsexercises composition against a disposable copy of an install for external plugin authors.
Knowledge and documents
- #731 shipped DocumentKB's first indexing and citation slice. Summaries and tags shipped in #894, completing that metadata slice of the tracked #714 RFC.
- #694 tracks intent-aware discovery and auditable supplemental-knowledge delivery across stage topologies.
Product discovery
- Core Ideation delivery remains under review in #526, with an external-handover contract in #586 and a plugin-shaped alternative in #652.
- The delivery surface, core versus first-party plugin, is not yet settled.
Intent lifecycle and iteration
aidlc intent archiveandaidlc intent unarchiveshipped onmainin #1033, closing #980. Archived intents leave active routing without deleting their records. Explicit unarchive restores them.- Warm re-scan, a first-class
amendscope and batch feedback ingestion are tracked in #1122, #1123 and #1124.
Installation, upgrades and releases
- The GA implementation and its active development line now live on
main. The earlier implementation remains onv1. - #722 and #756 delivered native binaries, installers, transactional project configuration, update/use/pin commands, release assets and tag-bound provenance. The earlier Bun dependency tracker #399 is closed as superseded.
- Stable releases are published from version tags, and GitHub Latest now points
to
v2.8.2, closing #635. The preview channel and isolation between stable and preview publication shipped in #1008, #1127 and #1129. - The main unresolved lifecycle work is safe behavior at configuration boundaries: provider-neutral defaults and cleanup in #1101, existing-file and filesystem handling in #1107, and the remaining enterprise compatibility-reporting scope in #636.
Harness expansion and parity
- GitHub Copilot support shipped in #657, and its RFC #472 is closed.
- Cursor support shipped in #661. Native Kiro IDE surfaces shipped in #824, closing #555, and hook matcher hardening shipped in #788.
- The earlier unified-Kiro proposal
#775 closed without
merging. Its maintained successor,
#1063, proposes one
kirodistribution for Kiro CLI and Kiro IDE. - Devin support has two open implementation proposals, #968 and #996.
- Antigravity setup is proposed in #690.
Evaluation and operations
- #684 proposes repeatable benchmarks for measuring AI-DLC outcomes. Evaluator work is active in #753; the earlier harness-evaluation tracker #223 closed as not planned for v1.
- Operations-phase steering remains a requested direction
(#221,
#473), not an active
mainimplementation stream.
Known gaps
- Stage-specific rules (
aidlc-stage-<slug>.md) are reserved but unbuilt. - Plugin
when:evaluation remains unbuilt. Marketplace discovery and trust are implemented in open PR #1104, not yet shipped. - Write-fired sensors remain advisory; gate-bound sensors support blocking severity and human-backed override.
- General cross-stage cycles and progressive in-place artefact enrichment remain North Star gaps.
- Provider-neutral project configuration remains blocked on the open findings in #1101.
- The unified Kiro distribution remains under review in #1063.
- Core and plugin product-discovery proposals remain open in #526 and #782 and need alignment on the delivery surface before either lands.