docs: close out phase 0 workflow foundation

This commit is contained in:
bisco
2026-03-20 19:23:30 +01:00
parent d65a39fa51
commit 44aa06a3a8
5 changed files with 18 additions and 8 deletions

View File

@ -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

View File

@ -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"