Feat: midflight commands and updated documentation - #27
Conversation
SecondSkoll
commented
Aug 18, 2026
- Adds concept of "midflight" commands - none enabled by default
- Adds documentation / adopts Sphinx Stack
There was a problem hiding this comment.
@SecondSkoll, the documentation reorganization is generally clear and adds useful rollout and command-safety guidance. I found two broken cross-references that should be corrected before merge.
| the workflow release. Pin the remote bundle with a full commit SHA. | ||
|
|
||
| Use [Option C in the deployment guide](deploy-a-workflow.md#option-c-organization-managed-central-bundle) | ||
| for the canonical wrapper YAML and token requirements. |
There was a problem hiding this comment.
@SecondSkoll, this link targets examples/configuration-sources/central/, but that directory has no index page, so it is likely to produce a broken navigation target. Link to examples/configuration-sources/index.md (or a specific existing file) instead.
| for the canonical wrapper YAML and token requirements. | |
| [central example](examples/configuration-sources/index.md) |
| bounded output capture, phase-aware prompt handoffs, policy ceilings, and other | ||
| controls from `docs/developer/midflight-commands-plan.md` have already been | ||
| implemented. It does not reuse the current unsafe string-based preflight | ||
| implementation in `run_agentic_release_project_review.py`. |
There was a problem hiding this comment.
@SecondSkoll, this reference points to docs/developer/midflight-commands-plan.md, but the plan was added under docs/developer/plans/midflight-commands-plan.md. Update the path so readers can follow the dependency plan.
| implementation in `run_agentic_release_project_review.py`. | |
| `docs/developer/plans/midflight-commands-plan.md` |