codex-bootstrap is a starter template for a full-stack web application integrating a Python FastAPI backend with a React Vite frontend, with Codex agent task support.
- PRD and Task file creation within Codex via local IDE agent
- Task orchestration and managment in Codex or local IDE agent
- Agent managed local dev setup and application start up script
dev-init.sh
- Agent maintenance of dependencies, Codex environment startup script.
- Changes to
.codex/install.sh
must be manually propogated to teh Codex environment setup configuration, but required environment changes are saved to this file by the Codex agent.
- Changes to
- Backend: Python 3, FastAPI, Uvicorn
- Frontend: React 18, Vite, Tailwind CSS, React Router
- Pre-configured linting and testing scripts
Starting with any description of a feature, this project supplies tooling to automate creation of PRD and Task List files, and then Codex agent (or local IDE agent) will manage work from this list, updating it as needed. There are four phases:
- Add feature specs and background to
.project-management/current-prd/prd-background/
:feature-specification.md
containing feature specs with as much or little detail as needed. Mandatory for running PRD creation in Codex. For local IDE agent feature specs can be delivered via copilot.design-mock.html
Optional design mockup file.api-documentation.md
Optional documentation for feature techinical assistance.
- Create the PRD:
- Codex: Start task in Code mode with just the phrase CreatePrd
- or
- Local IDE agent: Give focus to
create-prd.md
file, enter specs (or just 'go' if background has full feature specs).
- There will be Q&A with the Agent, On Codex answer questions and resume in Code mode (Environment is spun up again)
- Result should be a PRD file in
.project-management/current-prd/
- Merge PR to target branch
- Create Task List File:
- Codex: Start task in Code mode with just the phrase CreateTasks
- or
- Local IDE agent: Give focus to
generate-tasks.md
file and send go message
- Q&A, answer and click code
- Result should be a task list file at
.project-management/current-prd/
- Merge PR to target branch
- Once
.project-management/tasks/current-tasks.md
is created, the TaskMaster message can be used. This will allow the agent to commit to one or more tasks in a session. The task list file will be updated as part of the PR, with completed tasks checked off and relevant files updated as needed. - Start Codex in Code mode using the phrase TaskMaster. This will corece the agent to reference `process-tasks-cloud.md' which picks one or more tasks to complete in the session.
- Alternatively, tasks can be executed by local agent with focus on `process-tasks-local.md' which will run one task at a time
- Perform final feature review
- Codex: Start task in Code mode with just the phrase ClosePrd
- or
- Local IDE agent: Give focus to
close-prd.md
file and send go message
- Review will either:
- Result in flagged changes - review and resubmit the close out
- Pass review and close the PRD - feature files are moved from
current-prd
toclosed-prd
AGENTS.md
: Instructions for Codex agents These files are under control and watch by the Codex agent and will be updated as project tasks demand.CHANGELOG.md
: Project change historyDEVELOPMENT.md
: Developer setup and local testing instructionsREADME.md
: Project overview and file descriptionsdev_init.sh
: Script to initialize development environment and start services.codex/install.sh
: Codex Environment Setup script for dependencies and environmentrun_tests.sh
: Initial script to run tests across backend and frontendbackend/requirements.txt
: Python dependencies with initial common pacakgesfrontend/
package.json
: npm dependencies and scripts for frontendeslint.config.js
: ESLint configuration(e.g., .NET)
.flake8
python flake8 configuration for linting
Project managment instruction prompts derived from snarktank/ai-dev-tasks under Apache License 2.0
.project-management/
create-prd.md
: Instructions and rules for generating a Product Requirements Document (PRD) via AI, including clarifying questions and output location.generate-tasks.md
: Instructions for generating a step-by-step task list from a PRD, including process and file naming conventions.process-tasks-cloud.md
: TaskMaster module rules for managing and marking tasks as committed or completed in a cloud workflow.process-tasks-local.md
: TaskMaster module rules for local task management, including sub-task completion protocol and user confirmation steps.close-prd.md
: Instructions and rules for generating a final PRD feature review, to either provide final cleanup or closeout.prd-background/
: Feature background and html design mockups for current featurearchive-prd/
: Archived PRDs and Task listsclose-prd/
: Closed PRDs and Task lists, but reviewed during subsequent PRD creation to provide previously completed dev contextcurrent-prd/
: Current PRD and Task list for the feature under active developmentprd-background/
: feature backgrounddesign-mock.html
,api-document.md
etc... If using Codex-cloud PRD creation, feature specification should be found atfeature-specification.md
- Python 3.x
- FastAPI
- Uvicorn
- React 18
- Vite
- Tailwind CSS
- React Router
Go to https://chatgpt.com/codex/settings/environments, select or create your github-connected environment then Edit -> Advanced and copy-paste install.sh into the startup script textbox. Save End of document