AI-DLC (AI-Driven Development Life Cycle) is een raamwerk dat AI-codeerassistenten omvormt tot gestructureerde en controleerbare workflows voor softwareontwikkeling. Het systeem is 'harness-neutraal', wat betekent dat het werkt met diverse tools zoals Claude Code, Cursor, Kiro IDE en GitHub Copilot.
De kernpunten van AI-DLC zijn:
- Structuur en Controle: Het vervangt ad-hoc coderen door een levenscyclus van 5 fasen en 33 stadia, inclusief menselijke goedkeuringspoorten (approval gates) en een uitgebreide audit-trail.
- Gespecialiseerde Agents: Het maakt gebruik van 14 verschillende agents, waaronder 11 domeinexperts en 2 reviewers, ondersteund door 11 specifieke workflow-profielen (bijv. voor bugfixes of security).
- Installatie en Configuratie: Het is eenvoudig te installeren op Windows, macOS en Linux via native installers, waarbij gebruikers per project een specifieke harness kunnen configureren.
- Technisch: Voor optimale resultaten wordt het model Claude Opus 4.8 aanbevolen. Het project is modulair opgebouwd met een harness-neutrale core en specifieke integraties per tool.
AI-DLC: Adaptieve workflow-sturingsregels voor AI-codeeragents
Snelstart
1. AI-DLC installeren
macOS, Linux of WSL:
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh
Windows PowerShell:
irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex
De installatieprogramma configureert alles wat AI-DLC nodig heeft: het native aidlc-commando en elke harness-runtime. Je hoeft geen Bun of Node.js te installeren; een native installatie voert hooks en commando's uit via aidlc en roept bun niet aan.
Belangrijke opmerkingen voor Windows:
- De installatie gebeurt voor het huidige account en registreert automatisch de bin-directory in de User PATH.
- Gebruik een normaal PowerShell-venster; bij gebruik van "Uitvoeren als administrator" verschijnt een waarschuwing, aangezien installatie als administrator minder veilig is.
- Open een nieuw terminalvenster als een bestaande sessie
aidlc niet kan vinden.
- Gebruik
-NoModifyPath om zowel persistente als huidige-proces PATH-wijzigingen over te slaan.
- De Windows-uninstaller verwijdert alleen de User PATH-vermelding die door de installer is aangemaakt.
macOS, Linux of WSL: Volg indien nodig de PATH-instructies van de installer.
Handmatige installatie: Indien je de projectbestanden zelf wilt beheren of geen native executable kunt installeren, is Bun vereist: installeer Bun, download aidlc-copy-runtime-X.Y.Z.tar.gz uit de release, en kopieer de volledige runtime/<harness>/ directory naar je project. Deze methode vereist het native aidlc-commando niet.
2. Een project configureren
Ga naar de root van het project en selecteer de harness die je gebruikt:
cd /path/to/your-project
aidlc config --harness claude
aidlc doctor
Vervang claude door kiro, kiro-ide, codex, cursor, opencode of copilot. Het uitvoeren van aidlc config zonder --harness start een interactieve setup (indien een terminal beschikbaar is).
Veiligheidswaarschuwing voor Kiro IDE: Wanneer je de terminal van Kiro IDE gebruikt in een projectmap die nog niet is vertrouwd, vraagt Kiro of je de map vertrouwt. Kies alleen voor "Trust Folder & Continue" bij je eigen projecten of projecten die je hebt gecontroleerd, omdat dit toestaat dat de .kiro hooks commando's op je machine uitvoeren. Kies anders voor "Cancel" en controleer de map eerst.
3. Een workflow starten
Open je harness in het geconfigureerde project en beschrijf de gewenste actie:
/aidlc Bouw een REST API voor voorraadbeheer
- Codex CLI: gebruikt
$aidlc in plaats van /aidlc.
- Kiro IDE: kies eerst
aidlc in de agent-picker van het chatpaneel.
AI-DLC selecteert een workflow op basis van het verzoek, vraagt om ontbrekende beslissingen en stopt bij goedkeuringspoorten (approval gates) voordat het verder gaat.
Harness Overzicht
| Harness | Configureren | Openen | Aanroepen | Gids |
|---|
| Claude Code | aidlc config --harness claude | claude | /aidlc | Getting Started |
| Kiro IDE >= 1.1.70 / Kiro CLI >= 2.24.1 (v3) | aidlc config --harness kiro-ide | Open project in Kiro IDE en kies aidlc in de agent-picker, of run kiro-cli | /aidlc | Kiro IDE / Kiro CLI |
| Kiro CLI >= 2.6 (legacy) | aidlc config --harness kiro | kiro-cli chat | /aidlc | Kiro CLI |
| Codex CLI >= 0.145.0 | aidlc config --harness codex | codex | $aidlc | Codex CLI |
| Cursor | aidlc config --harness cursor | Open Cursor of run agent | /aidlc | Cursor |
| opencode >= 1.17 | aidlc config --harness opencode | opencode | /aidlc | opencode |
| GitHub Copilot CLI >= 1.0.74 / VS Code >= 1.130 | aidlc config --harness copilot | Copilot CLI of VS Code | /aidlc | GitHub Copilot |
Aanvullende informatie over setup: De model-provider setup is onderdeel van de harness. De geleverde projectconfiguratie behoudt de provider en het model die door de gebruiker zijn geselecteerd. aidlc config providers kan Amazon Bedrock-instellingen toepassen op ondersteunde projectoppervlakken of handmatige setup vastleggen voor andere harnesses. Kiro CLI en Kiro IDE hebben geen provider-antwoord nodig omdat modeltoegang inbegrepen is bij Kiro. De methodologie zelf is onafhankelijk van de provider.
Aanbevolen Model
AI-DLC werkt optimaal met krachtige reasoning-modellen. Het huidige aanbevolen model is Claude Opus 4.8. Als Opus niet beschikbaar is, of als je niet weet waar je het model en de inspanning (effort) in je harness moet instellen, raadpleeg dan de sectie Choosing a Model and Effort.
Waarom AI-DLC?
Ad-hoc AI-coderen verliest context naarmate projecten groeien. AI-DLC houdt eisen, beslissingen, implementaties, tests en operationeel werk verbonden via één gecontroleerde levenscyclus:
- Structuur: 5 fasen en 33 stadia, van initialisatie tot operationeel beheer.
- Agents: 14 agents, bestaande uit 11 domeinexperts, 2 reviewers en een adaptieve composer.
- Workflow-profielen: 11 profielen voor functies, bugfixes, infrastructuur, beveiliging, proofs of concept, enterprise delivery en andere veelvoorkomende taken.
- Controle: Menselijke goedkeuringspoorten en bewijsvoering voor reviews die gebonden is aan de broncode.
- Audit: Een audit-trail van 119 gebeurtenissen plus persistente status, teamkennis en aangeleerde regels.
- Consistentie: Dezelfde deterministische engine over elke ondersteunde harness.
Belangrijk: Generatieve AI kan fouten maken. Controleer de gegenereerde output en de kosten voordat je actie onderneemt. Zie het AWS Responsible AI Policy.
Documentatie
| Gids | Wanneer te gebruiken |
|---|
| Getting Started | Installeren, configureren en het uitvoeren van je eerste workflow |
| User Guide | Gebruik van workflows, profielen, agents, kennis en goedkeuringspoorten |
| Harness guides | Omgaan met verschillen in providers, trust en runtimes |
| Install and Lifecycle | Updaten, vastpinnen, offline installeren, mirrors gebruiken of verwijderen |
| Harness Engineer Guide | Aanpassen van stadia, agents, regels, sensoren en kennis |
| Development and Releases | Een PR door AI-review, preview-testen en stabiele publicatie leiden |
| Developer Reference | Wijzigingen aanbrengen in de engine, hooks, packaging of tests |
Repository-structuur
core/ – Handmatig geschreven, harness-neutrale methodologie en engine.core/tools/ – 93 aidlc-*.ts engine- en authoring-tools.harness/<name>/ – Dunne, harness-specifieke manifesten en integraties.plugins/<name>/ – Optionele AIDLC-plugins.scripts/ – Tooling voor packaging, binaries, installer en releases.tests/ – Smoke-, unit-, integratie- en end-to-end tests.docs/ – Documentatie voor gebruikers, harness-engineers en ontwikkelaars.dist/ en dist-release/ – Gegenereerde lokale outputs (worden genegeerd).
Let op: Bewerk alleen core/ of harness/<name>/, nooit de gegenereerde dist output.*
Ontwikkeling
Installeer afhankelijkheden en genereer elke harness:
bun install --frozen-lockfile
bun scripts/package.ts
Handige commando's:
bun scripts/package.ts <name>: genereer één specifieke harness.bun scripts/package.ts --check: controleer op determinisme.bun tests/run-tests.ts --ci: voer smoke-, unit- en integratietests uit.bun tests/run-tests.ts --release: volledige acceptatietest voor release.
Raadpleeg de Contributing Guide voor de volledige ontwikkelworkflow en Porting to a New Harness om een nieuwe runtime toe te voegen.
Probleemoplossing
Voer eerst aidlc doctor uit vanuit de projectroot. Veelvoorkomende oplossingen:
| Symptoom | Oplossing |
|---|
aidlc wordt niet gevonden | Windows: Sluit en herstart de terminal of IDE, of gebruik het directe commando dat wordt getoond bij -NoModifyPath. Unix: Pas de PATH-instructies van de installer toe. |
| Project/runtime versie-verschil | Rond de actieve workflow af en voer vervolgens aidlc config uit. |
| Codex hooks worden niet uitgevoerd | Vertrouw de project-hooks zoals beschreven in de Codex-gids. |
| Bedrock-toegang mislukt | Schakel de geconfigureerde modellen in en verifieer AWS-credentials en regio. |
| Plugin-stadia verdwijnen na refresh | Voer /aidlc plugin sync uit. |
| Vernieuwde skills hebben geen effect | Start een nieuwe harness-sessie. |
Referenties
- AWS AI-DLC blogpost
- AI-DLC Method Definition Paper
AI-DLC: Adaptieve workflow-sturingsregels voor AI-codeeragents
Snelstart
1. AI-DLC installeren
macOS, Linux of WSL:
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh
Windows PowerShell:
irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex
De installatieprogramma configureert alles wat AI-DLC nodig heeft: het native aidlc-commando en elke harness-runtime. Je hoeft geen Bun of Node.js te installeren; een native installatie voert hooks en commando's uit via aidlc en roept bun niet aan.
Belangrijke opmerkingen voor Windows:
- De installatie gebeurt voor het huidige account en registreert automatisch de bin-directory in de User PATH.
- Gebruik een normaal PowerShell-venster; bij gebruik van "Uitvoeren als administrator" verschijnt een waarschuwing, aangezien installatie als administrator minder veilig is.
- Open een nieuw terminalvenster als een bestaande sessie
aidlc niet kan vinden.
- Gebruik
-NoModifyPath om zowel persistente als huidige-proces PATH-wijzigingen over te slaan.
- De Windows-uninstaller verwijdert alleen de User PATH-vermelding die door de installer is aangemaakt.
macOS, Linux of WSL: Volg indien nodig de PATH-instructies van de installer.
Handmatige installatie: Indien je de projectbestanden zelf wilt beheren of geen native executable kunt installeren, is Bun vereist: installeer Bun, download aidlc-copy-runtime-X.Y.Z.tar.gz uit de release, en kopieer de volledige runtime/<harness>/ directory naar je project. Deze methode vereist het native aidlc-commando niet.
2. Een project configureren
Ga naar de root van het project en selecteer de harness die je gebruikt:
cd /path/to/your-project
aidlc config --harness claude
aidlc doctor
Vervang claude door kiro, kiro-ide, codex, cursor, opencode of copilot. Het uitvoeren van aidlc config zonder --harness start een interactieve setup (indien een terminal beschikbaar is).
Veiligheidswaarschuwing voor Kiro IDE: Wanneer je de terminal van Kiro IDE gebruikt in een projectmap die nog niet is vertrouwd, vraagt Kiro of je de map vertrouwt. Kies alleen voor "Trust Folder & Continue" bij je eigen projecten of projecten die je hebt gecontroleerd, omdat dit toestaat dat de .kiro hooks commando's op je machine uitvoeren. Kies anders voor "Cancel" en controleer de map eerst.
3. Een workflow starten
Open je harness in het geconfigureerde project en beschrijf de gewenste actie:
/aidlc Bouw een REST API voor voorraadbeheer
- Codex CLI: gebruikt
$aidlc in plaats van /aidlc.
- Kiro IDE: kies eerst
aidlc in de agent-picker van het chatpaneel.
AI-DLC selecteert een workflow op basis van het verzoek, vraagt om ontbrekende beslissingen en stopt bij goedkeuringspoorten (approval gates) voordat het verder gaat.
Harness Overzicht
| Harness | Configureren | Openen | Aanroepen | Gids |
|---|
| Claude Code | aidlc config --harness claude | claude | /aidlc | Getting Started |
| Kiro IDE >= 1.1.70 / Kiro CLI >= 2.24.1 (v3) | aidlc config --harness kiro-ide | Open project in Kiro IDE en kies aidlc in de agent-picker, of run kiro-cli | /aidlc | Kiro IDE / Kiro CLI |
| Kiro CLI >= 2.6 (legacy) | aidlc config --harness kiro | kiro-cli chat | /aidlc | Kiro CLI |
| Codex CLI >= 0.145.0 | aidlc config --harness codex | codex | $aidlc | Codex CLI |
| Cursor | aidlc config --harness cursor | Open Cursor of run agent | /aidlc | Cursor |
| opencode >= 1.17 | aidlc config --harness opencode | opencode | /aidlc | opencode |
| GitHub Copilot CLI >= 1.0.74 / VS Code >= 1.130 | aidlc config --harness copilot | Copilot CLI of VS Code | /aidlc | GitHub Copilot |
Aanvullende informatie over setup: De model-provider setup is onderdeel van de harness. De geleverde projectconfiguratie behoudt de provider en het model die door de gebruiker zijn geselecteerd. aidlc config providers kan Amazon Bedrock-instellingen toepassen op ondersteunde projectoppervlakken of handmatige setup vastleggen voor andere harnesses. Kiro CLI en Kiro IDE hebben geen provider-antwoord nodig omdat modeltoegang inbegrepen is bij Kiro. De methodologie zelf is onafhankelijk van de provider.
Aanbevolen Model
AI-DLC werkt optimaal met krachtige reasoning-modellen. Het huidige aanbevolen model is Claude Opus 4.8. Als Opus niet beschikbaar is, of als je niet weet waar je het model en de inspanning (effort) in je harness moet instellen, raadpleeg dan de sectie Choosing a Model and Effort.
Waarom AI-DLC?
Ad-hoc AI-coderen verliest context naarmate projecten groeien. AI-DLC houdt eisen, beslissingen, implementaties, tests en operationeel werk verbonden via één gecontroleerde levenscyclus:
- Structuur: 5 fasen en 33 stadia, van initialisatie tot operationeel beheer.
- Agents: 14 agents, bestaande uit 11 domeinexperts, 2 reviewers en een adaptieve composer.
- Workflow-profielen: 11 profielen voor functies, bugfixes, infrastructuur, beveiliging, proofs of concept, enterprise delivery en andere veelvoorkomende taken.
- Controle: Menselijke goedkeuringspoorten en bewijsvoering voor reviews die gebonden is aan de broncode.
- Audit: Een audit-trail van 119 gebeurtenissen plus persistente status, teamkennis en aangeleerde regels.
- Consistentie: Dezelfde deterministische engine over elke ondersteunde harness.
Belangrijk: Generatieve AI kan fouten maken. Controleer de gegenereerde output en de kosten voordat je actie onderneemt. Zie het AWS Responsible AI Policy.
Documentatie
| Gids | Wanneer te gebruiken |
|---|
| Getting Started | Installeren, configureren en het uitvoeren van je eerste workflow |
| User Guide | Gebruik van workflows, profielen, agents, kennis en goedkeuringspoorten |
| Harness guides | Omgaan met verschillen in providers, trust en runtimes |
| Install and Lifecycle | Updaten, vastpinnen, offline installeren, mirrors gebruiken of verwijderen |
| Harness Engineer Guide | Aanpassen van stadia, agents, regels, sensoren en kennis |
| Development and Releases | Een PR door AI-review, preview-testen en stabiele publicatie leiden |
| Developer Reference | Wijzigingen aanbrengen in de engine, hooks, packaging of tests |
Repository-structuur
core/ – Handmatig geschreven, harness-neutrale methodologie en engine.core/tools/ – 93 aidlc-*.ts engine- en authoring-tools.harness/<name>/ – Dunne, harness-specifieke manifesten en integraties.plugins/<name>/ – Optionele AIDLC-plugins.scripts/ – Tooling voor packaging, binaries, installer en releases.tests/ – Smoke-, unit-, integratie- en end-to-end tests.docs/ – Documentatie voor gebruikers, harness-engineers en ontwikkelaars.dist/ en dist-release/ – Gegenereerde lokale outputs (worden genegeerd).
Let op: Bewerk alleen core/ of harness/<name>/, nooit de gegenereerde dist output.*
Ontwikkeling
Installeer afhankelijkheden en genereer elke harness:
bun install --frozen-lockfile
bun scripts/package.ts
Handige commando's:
bun scripts/package.ts <name>: genereer één specifieke harness.bun scripts/package.ts --check: controleer op determinisme.bun tests/run-tests.ts --ci: voer smoke-, unit- en integratietests uit.bun tests/run-tests.ts --release: volledige acceptatietest voor release.
Raadpleeg de Contributing Guide voor de volledige ontwikkelworkflow en Porting to a New Harness om een nieuwe runtime toe te voegen.
Probleemoplossing
Voer eerst aidlc doctor uit vanuit de projectroot. Veelvoorkomende oplossingen:
| Symptoom | Oplossing |
|---|
aidlc wordt niet gevonden | Windows: Sluit en herstart de terminal of IDE, of gebruik het directe commando dat wordt getoond bij -NoModifyPath. Unix: Pas de PATH-instructies van de installer toe. |
| Project/runtime versie-verschil | Rond de actieve workflow af en voer vervolgens aidlc config uit. |
| Codex hooks worden niet uitgevoerd | Vertrouw de project-hooks zoals beschreven in de Codex-gids. |
| Bedrock-toegang mislukt | Schakel de geconfigureerde modellen in en verifieer AWS-credentials en regio. |
| Plugin-stadia verdwijnen na refresh | Voer /aidlc plugin sync uit. |
| Vernieuwde skills hebben geen effect | Start een nieuwe harness-sessie. |
Referenties
- AWS AI-DLC blogpost
- AI-DLC Method Definition Paper
Groetjes,