From c33534bfc7ac8e8de88e00e2b0a658325335f8a1 Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 12:55:29 -0400 Subject: [PATCH 01/16] feat(codex): add support for codex openai --- README.md | 52 ++++++++++++++++++++ aidlc-rules/aws-aidlc-rules/core-workflow.md | 2 +- 2 files changed, 53 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 3deef869..f2504db7 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,7 @@ AI-DLC is an intelligent software development workflow that adapts to your needs - [Cline](#cline) - [Claude Code](#claude-code) - [GitHub Copilot](#github-copilot) + - [OpenAI Codex](#openai-codex) --- @@ -433,6 +434,57 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- --- +### OpenAI Codex + +AI-DLC uses [Codex AGENTS.md](https://developers.openai.com/codex/guides/agents-md) to implement its intelligent workflow. Codex automatically discovers and loads `AGENTS.md` from your project root when you start a session. + +The commands below assume you extracted the zip to your `Downloads` folder. If you used a different location, replace `Downloads` with your actual folder path. + +**Unix/Linux/macOS:** +```bash +cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./AGENTS.md +mkdir -p .aidlc-rule-details +cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/ +``` + +**Windows PowerShell:** +```powershell +Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md" +New-Item -ItemType Directory -Force -Path ".aidlc-rule-details" +Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -Recurse +``` + +**Windows CMD:** +```cmd +copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md" +mkdir .aidlc-rule-details +xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /I +``` + +**Verify Setup:** +1. Start a Codex session in your project directory +2. Ask Codex: "What development workflow are you following for this project?" +3. Codex should describe the AI-DLC three-phase workflow (Inception → Construction → Operations) + +> [!NOTE] +> The `AGENTS.md` file (~24 KB) fits comfortably within Codex's default 32 KiB instruction budget. If you add project-specific content to `AGENTS.md` that pushes the total over 32 KiB, increase the limit in `~/.codex/config.toml`: +> ```toml +> project_doc_max_bytes = 65536 +> ``` + +**Directory Structure:** +``` +/ +├── AGENTS.md +└── .aidlc-rule-details/ + ├── common/ + ├── inception/ + ├── construction/ + └── operations/ +``` + +--- + ### Other Agents AI-DLC works with any coding agent that supports project-level rules or steering files. The general approach: diff --git a/aidlc-rules/aws-aidlc-rules/core-workflow.md b/aidlc-rules/aws-aidlc-rules/core-workflow.md index aafd6c24..8edd4a1a 100644 --- a/aidlc-rules/aws-aidlc-rules/core-workflow.md +++ b/aidlc-rules/aws-aidlc-rules/core-workflow.md @@ -12,7 +12,7 @@ The AI model intelligently assesses what stages are needed based on: ## MANDATORY: Rule Details Loading **CRITICAL**: When performing any phase, you MUST read and use relevant content from rule detail files. Check these paths in order and use the first one that exists: -- `.aidlc-rule-details/` (Cursor, Cline, Claude Code, GitHub Copilot) +- `.aidlc-rule-details/` (Cursor, Cline, Claude Code, GitHub Copilot, OpenAI Codex) - `.kiro/aws-aidlc-rule-details/` (Kiro IDE and CLI) - `.amazonq/aws-aidlc-rule-details/` (Amazon Q Developer) From b3f2dfd53501752d0584beb9f88d112b53e19af5 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 13:28:47 -0400 Subject: [PATCH 02/16] chore(docs): update README with directory structure information --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index f2504db7..6a8ef776 100644 --- a/README.md +++ b/README.md @@ -473,6 +473,7 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > ``` **Directory Structure:** + ``` / ├── AGENTS.md From 377c88fdb87085698bd5bd8951d55ca088540ab9 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 13:29:50 -0400 Subject: [PATCH 03/16] chore(docs): updated docs Update the note about the AGENTS.md file size limit. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6a8ef776..3a4181e1 100644 --- a/README.md +++ b/README.md @@ -470,7 +470,7 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > The `AGENTS.md` file (~24 KB) fits comfortably within Codex's default 32 KiB instruction budget. If you add project-specific content to `AGENTS.md` that pushes the total over 32 KiB, increase the limit in `~/.codex/config.toml`: > ```toml > project_doc_max_bytes = 65536 -> ``` +``` **Directory Structure:** From 4137e91ff774b61ef39c02aa945918bdc2bd07a6 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 13:31:17 -0400 Subject: [PATCH 04/16] chore(docs): updated markdown syntax --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3a4181e1..6d6d0370 100644 --- a/README.md +++ b/README.md @@ -468,8 +468,8 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file (~24 KB) fits comfortably within Codex's default 32 KiB instruction budget. If you add project-specific content to `AGENTS.md` that pushes the total over 32 KiB, increase the limit in `~/.codex/config.toml`: -> ```toml -> project_doc_max_bytes = 65536 +```toml +project_doc_max_bytes = 65536 ``` **Directory Structure:** From 34e6d3accf0d42df3cb90b2e2df43a4cb8f7a1a3 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 13:37:03 -0400 Subject: [PATCH 05/16] chore(docs) : update the limit messaging Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 6d6d0370..ec9dc463 100644 --- a/README.md +++ b/README.md @@ -467,9 +467,9 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- 3. Codex should describe the AI-DLC three-phase workflow (Inception → Construction → Operations) > [!NOTE] -> The `AGENTS.md` file (~24 KB) fits comfortably within Codex's default 32 KiB instruction budget. If you add project-specific content to `AGENTS.md` that pushes the total over 32 KiB, increase the limit in `~/.codex/config.toml`: +> The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): ```toml -project_doc_max_bytes = 65536 +project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project ``` **Directory Structure:** From 2e48eccf5d5ac00862b31386448c176469c0e9c1 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 13:42:43 -0400 Subject: [PATCH 06/16] chore(docs): update readme Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ec9dc463..c7fa4237 100644 --- a/README.md +++ b/README.md @@ -468,9 +468,9 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): -```toml -project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project -``` +> ```toml +> project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project +> ``` **Directory Structure:** From c9d70af3ae686b230752114174c2c1f12f54d1ed Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 13:47:41 -0400 Subject: [PATCH 07/16] feat(codex): add support for codex openai --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c7fa4237..bcbd2b10 100644 --- a/README.md +++ b/README.md @@ -468,9 +468,10 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): -> ```toml -> project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project -> ``` + +``` + project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project +``` **Directory Structure:** From dd33da4fb4e07bd510543c41fbfe111c01bf20f6 Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 13:59:55 -0400 Subject: [PATCH 08/16] feat(codex): add support for codex openai --- README.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index bcbd2b10..43a94e21 100644 --- a/README.md +++ b/README.md @@ -468,10 +468,9 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): - -``` - project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project -``` +>``` +> project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project +> ``` **Directory Structure:** From df137c8bb70ef5fdd862b87ffd4d65c669c6bd10 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 14:32:11 -0400 Subject: [PATCH 09/16] chore(docs) : update the limit messaging Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 43a94e21..c7fa4237 100644 --- a/README.md +++ b/README.md @@ -468,7 +468,7 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): ->``` +> ```toml > project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project > ``` From 3e5341732f43d2345153259432af89e292c22bcd Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 14:46:08 -0400 Subject: [PATCH 10/16] feat(codex): add other agents back in readme --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5b9c2e35..61f23e8d 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,7 @@ AI-DLC is an intelligent software development workflow that adapts to your needs - [Claude Code](#claude-code) - [GitHub Copilot](#github-copilot) - [OpenAI Codex](#openai-codex) + - [Other Agents](#other-agents) --- From 1e505e1b2a51086c5652eccb09c2cbbca95e7398 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 15:24:11 -0400 Subject: [PATCH 11/16] chore(doc): apply suggestion from @scottschreckengaust Co-authored-by: Scott Schreckengaust --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 61f23e8d..8c832781 100644 --- a/README.md +++ b/README.md @@ -492,8 +492,8 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): > ```toml -> project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project -> ``` +>project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project +>``` **Directory Structure:** From 366defcfaaca33d3c45fb7cd4de99bd4bbe64411 Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 15:48:07 -0400 Subject: [PATCH 12/16] feat(codex): add other agents back in readme --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 8c832781..01cb62c2 100644 --- a/README.md +++ b/README.md @@ -504,6 +504,7 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- ├── common/ ├── inception/ ├── construction/ + ├── extensions/ └── operations/ ``` From 5f4b6c549cc58bb7b3760c17cffaad0a40fb0f40 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 15:50:18 -0400 Subject: [PATCH 13/16] chore(doc): update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 01cb62c2..c249c717 100644 --- a/README.md +++ b/README.md @@ -505,6 +505,7 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- ├── inception/ ├── construction/ ├── extensions/ + ├── extensions/ └── operations/ ``` From 5ae1f66a67c6d8ed85e6faad209a95d6fd0482a5 Mon Sep 17 00:00:00 2001 From: Dinesh Sajwan Date: Mon, 30 Mar 2026 15:50:34 -0400 Subject: [PATCH 14/16] chore(doc): update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c249c717..a54597fb 100644 --- a/README.md +++ b/README.md @@ -492,8 +492,8 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- > [!NOTE] > The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file): > ```toml ->project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project ->``` +> project_doc_max_bytes = 65536 # Example value; choose a limit appropriate for your project +> ``` **Directory Structure:** From 7a3ae58d68de35f3da922c0cd3c6b3a437c6f13d Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 15:53:05 -0400 Subject: [PATCH 15/16] feat(codex): updated docs --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index a54597fb..bd5dfe8a 100644 --- a/README.md +++ b/README.md @@ -505,7 +505,6 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- ├── inception/ ├── construction/ ├── extensions/ - ├── extensions/ └── operations/ ``` From 41de243afc24a830df52f2899a34236b9ffc9cec Mon Sep 17 00:00:00 2001 From: dinsajwa Date: Mon, 30 Mar 2026 16:21:44 -0400 Subject: [PATCH 16/16] feat(codex): updated verify set up for codex --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bd5dfe8a..ec18da3b 100644 --- a/README.md +++ b/README.md @@ -486,7 +486,7 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule- **Verify Setup:** 1. Start a Codex session in your project directory -2. Ask Codex: "What development workflow are you following for this project?" +2. Ask Codex: For existing project - "Using AIDLC analyse the project?" or For new project "Using Aidlc what workflow do you see" . 3. Codex should describe the AI-DLC three-phase workflow (Inception → Construction → Operations) > [!NOTE]