Skip to content

docs: align sprint orchestration behavior with current execution flow - #756

Merged
numnx merged 1 commit into
feature/CODUX-44-qs-documentation-developer-surface-audit-2from
jules-7839629614823547377-ee604b90
Jul 7, 2026
Merged

docs: align sprint orchestration behavior with current execution flow#756
numnx merged 1 commit into
feature/CODUX-44-qs-documentation-developer-surface-audit-2from
jules-7839629614823547377-ee604b90

Conversation

@numnx

@numnx numnx commented Jul 7, 2026

Copy link
Copy Markdown
Owner

This PR brings the orchestration step documentation and UI reference pages into alignment with the existing implementation of src/domain/sprint/orchestrator/cycle-runner.ts and src/sprint/steps/protocol-step.ts.

It updates:

  1. docs/sprint-loop/atomic-loop.md to show the correct execution phases and replace outdated references to mergeProtocol and actionRequiredProtocol with protocol.
  2. docs-web/user/sprint-orchestration.md to sync with atomic-loop.md's cycle and state machine updates, particularly describing how a completed task fails into QA_REVIEW_FAILED correctly instead of an infinite wait.
  3. docs/architecture/quality-assurance-agent.md to ensure QA_REVIEW_FAILED hold behavior aligns tightly with current code.

PR created automatically by Jules for task 7839629614823547377 started by @numnx

- Replace `mergeProtocol` and `actionRequiredProtocol` with `protocol` in `atomic-loop.md` and `docs-web/user/sprint-orchestration.md`.
- Detail correct behavior of QA holding a task in `QA_REVIEW_FAILED` state on exhaustion.
- Re-align flowcharts and list steps in sprint loop.

Co-authored-by: numnx <1517214+numnx@users.noreply.github.com>
@google-labs-jules

Copy link
Copy Markdown

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@numnx
numnx merged commit 6ab8019 into feature/CODUX-44-qs-documentation-developer-surface-audit-2 Jul 7, 2026
6 checks passed
@numnx
numnx deleted the jules-7839629614823547377-ee604b90 branch July 7, 2026 01:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant