docs: close out phase 0 workflow foundation
This commit is contained in:
@ -37,7 +37,8 @@ Use this sequence on a new machine:
|
||||
- `docs/WORKFLOW.md`
|
||||
- `docs/MACHINE_SETUP.md`
|
||||
- `docs/TASK_TEMPLATE.md`
|
||||
5. Create a task branch from `develop`.
|
||||
5. Run `make doctor`.
|
||||
6. Create a task branch from `develop`.
|
||||
|
||||
## Validation Checklist
|
||||
|
||||
@ -48,12 +49,15 @@ A machine is ready for repository work when:
|
||||
- `AGENTS.md` is present
|
||||
- `.codex/config.toml` is present
|
||||
- `.codex/agents/` is present
|
||||
- docs are present
|
||||
- `.agents/skills/` is present
|
||||
- `docs/WORKFLOW.md` is present
|
||||
- `docs/MACHINE_SETUP.md` is present
|
||||
- `docs/TASK_TEMPLATE.md` is present
|
||||
- `make doctor` works
|
||||
|
||||
## Local Checks
|
||||
|
||||
Run `make doctor` to verify the repository bootstrap and local working assumptions.
|
||||
Run `make doctor` during bootstrap to verify the repository bootstrap and local working assumptions.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
||||
@ -80,6 +80,7 @@ Example feature branch flow:
|
||||
```bash
|
||||
git checkout develop
|
||||
git pull
|
||||
# if git pull fails, continue using local branch state and say so explicitly
|
||||
git checkout -b feature/example-task
|
||||
# make focused changes
|
||||
git commit -m "docs: describe example task flow"
|
||||
|
||||
Reference in New Issue
Block a user