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, working-tree encodings, and submodule gitlinks can report unchanged content asdrifted(both sides read CRLF text as LF, socore.autocrlfdoes not). 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.