feat(codex): add support for codex openai#153
feat(codex): add support for codex openai#153dineshSajwan wants to merge 21 commits intoawslabs:mainfrom
Conversation
dineshSajwan
requested review from
a team,
Copilot,
harmjeff,
raj-jain-aws,
scottschreckengaust and
spraja08
There was a problem hiding this comment.
Pull request overview
Adds documentation/support references for using AI-DLC with OpenAI Codex by leveraging Codex’s AGENTS.md convention while keeping the existing .aidlc-rule-details/ rule-details resolution approach.
Changes:
- Document OpenAI Codex setup steps in the README (including verification and directory layout).
- Update the core workflow docs to list OpenAI Codex among agents that use
.aidlc-rule-details/.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| aidlc-rules/aws-aidlc-rules/core-workflow.md | Adds OpenAI Codex to the documented .aidlc-rule-details/ consumers list. |
| README.md | Adds an OpenAI Codex section and TOC entry with setup/verify instructions using AGENTS.md. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Update the note about the AGENTS.md file size limit.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
harmjeff
left a comment
harmjeff
left a comment
There was a problem hiding this comment.
CodeX was unreliable in using the isntructions until I added a prefix to the core rules in AGENT.md
## Project Bootstrap Instructions
Before doing software development work in this repository:
1. Read this file completely.
2. Resolve the rule details directory by checking these paths in order and using the first one that exists:
- `.aidlc-rule-details/`
- `.kiro/aws-aidlc-rule-details/`
- `.amazonq/aws-aidlc-rule-details/`
3. If none of those directories exist, stop and report the missing dependency. Do not silently substitute another path.
4. Load these required common files from the resolved rule details directory before continuing:
- `common/process-overview.md`
- `common/session-continuity.md`
- `common/content-validation.md`
- `common/question-format-guide.md`
- `common/welcome-message.md`
5. Scan the resolved `extensions/` directory recursively:
- Load only `*.opt-in.md` files during startup.
- If an extension has no matching `*.opt-in.md`, load its full rule file immediately.
- If the `extensions/` directory does not exist, continue without optional extensions.
6. Ensure the documentation workspace exists:
- `aidlc-docs/`
- `aidlc-docs/aidlc-state.md`
- `aidlc-docs/audit.md`
7. Execute `inception/workspace-detection.md`.
## Startup Checklist
- [ ] Read `AGENTS.md`
- [ ] Resolve rule details directory
- [ ] Load required common files
- [ ] Display the welcome message once for a new workflow
- [ ] Scan extension opt-in files
- [ ] Ensure `aidlc-docs/` scaffold exists
- [ ] Check for existing `aidlc-docs/aidlc-state.md`
- [ ] Begin workspace detection
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
scottschreckengaust
added
the
codebuild
scottschreckengaust
had a problem deploying
to
codebuild
GitHub Actions
Failure
Tested AIDLC with codex session, this works as per the instructions shared on Readme.md 
|
|
|
||
| ### 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. |
There was a problem hiding this comment.
Sentence reads as if AI-DLC uses Codex only. Should be reworded to say that it is one of IDEs supported.
scottschreckengaust
added
rules
and removed
codebuild
scottschreckengaust
had a problem deploying
to
codebuild
GitHub Actions
Error
scottschreckengaust
requested a deployment
to
codebuild
GitHub Actions
Waiting
Summary
Adds OpenAI Codex as a supported coding agent for AIDLC. Codex uses AGENTS.md at the project root to load instructions, which maps cleanly onto the existing .aidlc-rule-details/ path resolution already used by Claude Code, Cursor, Cline, and GitHub Copilot, so no new path or rule changes were required.
Changes
README.md: Added OpenAI Codex to the Platform-Specific Setup table of contents and added a full ### OpenAI Codex setup section (between GitHub Copilot and Other Agents) with
User experience
Before: Users who wanted to use AIDLC with OpenAI Codex had no documented setup path and would need to figure out the AGENTS.md convention themselves.
After: Users can follow the new ### OpenAI Codex section in the README to set up AI-DLC in two commands. Codex sessions in the project will automatically load the full AIDLC three phase workflow (Inception → Construction → Operations) and resolve rule details from .aidlc-rule-details/.
Checklist
If your change doesn't seem to apply, please leave them unchecked.
Test Plan
Acknowledgment
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.