Initial commit

README.md

@@ -0,0 +1,73 @@
+# codex-bootstrap
+
+A repository template for AI-assisted development with Codex.
+
+This template defines a repeatable workflow for using Codex as an autonomous coding agent that can create branches, modify code, run Docker-based tests, update documentation, write ADRs, and commit changes using Conventional Commits.
+
+## Purpose
+
+Use this template to bootstrap repositories where Codex must operate with clear rules, minimal changes, pragmatic TDD, security guardrails, and explicit documentation requirements.
+
+## Repository structure
+
+```text
+.
+├── AGENTS.md
+├── README.md
+├── .codex/
+│   ├── project.md
+│   ├── workflow.md
+│   ├── security.md
+│   ├── quality.md
+│   ├── orchestration.md
+│   ├── prompts/
+│   │   ├── task.md
+│   │   ├── bugfix.md
+│   │   ├── refactor.md
+│   │   ├── security-review.md
+│   │   └── documentation.md
+│   ├── agents/
+│   │   ├── architect.md
+│   │   ├── developer.md
+│   │   ├── reviewer.md
+│   │   ├── security-reviewer.md
+│   │   ├── test-engineer.md
+│   │   └── documentation-writer.md
+│   └── profiles/
+│       ├── docker.md
+│       ├── ansible.md
+│       └── python.md
+└── docs/
+    ├── adr/
+    │   └── 0000-template.md
+    ├── architecture.md
+    ├── deployment.md
+    ├── operations.md
+    ├── security.md
+    ├── testing.md
+    └── runbook.md
+```
+
+## How to use
+
+1. Copy this template into a new or existing repository.
+2. Edit `.codex/project.md` and configure:
+   - project mode;
+   - enabled profiles;
+   - Docker-based test command;
+   - branch naming rules if needed.
+3. Add project-specific details to the documentation under `docs/`.
+4. When asking Codex to work on a task, use one of the prompt templates under `.codex/prompts/`.
+
+## Core rules
+
+Codex must:
+
+- start work from `develop`;
+- create a dedicated `feature/`, `fix/`, or `hotfix/` branch;
+- use pragmatic TDD;
+- keep changes minimal and focused;
+- run the configured Docker-based test command before completion;
+- update documentation and ADRs when needed;
+- produce a final report with summary, tests, risks, and rollback notes;
+- commit using Conventional Commits.