37 lines
767 B
Markdown
37 lines
767 B
Markdown
# Machine Setup
|
|
|
|
## Goal
|
|
|
|
Bring a new machine to a usable Codex development state with minimal local-only setup.
|
|
|
|
## Local-only prerequisites
|
|
|
|
Not stored in the repo:
|
|
- Codex authentication
|
|
- personal shell setup
|
|
- secrets/API keys
|
|
- local editor preferences
|
|
|
|
## Repository bootstrap
|
|
|
|
1. Clone the repository
|
|
2. Checkout `develop`
|
|
3. Read:
|
|
- AGENTS.md
|
|
- docs/WORKFLOW.md
|
|
- docs/TASK_TEMPLATE.md
|
|
4. Ensure Codex can see:
|
|
- AGENTS.md
|
|
- .codex/config.toml
|
|
- .codex/agents/*
|
|
- .agents/skills/*
|
|
|
|
## Validation checklist
|
|
|
|
A machine is considered ready when:
|
|
- repo is cloned
|
|
- correct branch is checked out
|
|
- Codex authentication is working
|
|
- AGENTS.md is present at repo root
|
|
- .codex/config.toml is present
|
|
- task branches can be created from develop |