Skip to content

ADR-277: Refactor Step protocol — get_actions/handle_results + ParallelSteps#32

Merged
jodavis merged 4 commits into
feature/ADR-269-agent-orchestrationfrom
dev/claude/ADR-277-Step-refactor
Jun 12, 2026
Merged

ADR-277: Refactor Step protocol — get_actions/handle_results + ParallelSteps#32
jodavis merged 4 commits into
feature/ADR-269-agent-orchestrationfrom
dev/claude/ADR-277-Step-refactor

Conversation

@jodavis-claude

Copy link
Copy Markdown
Collaborator

Summary

  • Introduces get_actions() -> list[dict] and handle_results(results) -> str abstract methods on Step; deprecates run() with NotImplementedError
  • Adds ParallelSteps composite that concatenates children's actions and splits results back by count, with configurable combine_results() precedence
  • Decomposes SignoffStep into ReviewerSignOffStep, ResearcherSignOffStep, and BuildValidationStep composed via ParallelSteps
  • Adds --results CLI argument to dev_team.py; updates dev-team.md to pass results back on each invocation
  • Adds test coverage for ParallelSteps, inline step dispatch, infinite-loop guard, and --results parsing

Test plan

  • pytest plugins/dev-team/scripts/test_dev_team.py passes
  • TestParallelStepsGetActions — flat action list equals concatenation of children
  • TestParallelStepsHandleResults — split by action count; combine_results precedence (failed > changes_requested > first)
  • TestInlineStepDispatch — inline step advances without exit_with_actions; infinite-loop guard fires
  • TestResultsParsing--results comma-split and whitespace stripping

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Jun 12, 2026

Copy link
Copy Markdown

build-and-test: Python test results

Status: ✅ Passed

Test log

@jodavis jodavis changed the base branch from main to feature/ADR-269-agent-orchestration June 12, 2026 02:26

@jodavis jodavis left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the direction this is going. It's much cleaner than the previous implementation. There are a few things that would make it even better.

Comment thread plugins/dev-team/scripts/dev_team.py Outdated
Comment thread plugins/dev-team/scripts/dev_team.py Outdated
Comment thread plugins/dev-team/scripts/dev_team.py Outdated
Comment thread plugins/dev-team/scripts/dev_team.py Outdated
Comment thread plugins/dev-team/scripts/dev_team.py Outdated
- Delete Step.run() shim
- Remove redundant print() status calls from step methods
- Remove results parameter from handle_results() and --results CLI arg
- Split reviewing state into creating-pr + reviewing; delete _REDISPATCH
- Make combine_results abstract on ParallelSteps
- Update workflow files and dev-team.md orchestration docs accordingly

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

@jodavis jodavis left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks even better.

jodavis added 2 commits June 12, 2026 07:17
Increment the version in the plugin JSON file for the dev-team plugin by 0.0.1 in each task.
@jodavis jodavis merged commit c9beb96 into feature/ADR-269-agent-orchestration Jun 12, 2026
1 check passed
@jodavis jodavis deleted the dev/claude/ADR-277-Step-refactor branch June 12, 2026 14:20
jodavis added a commit that referenced this pull request Jun 19, 2026
…elSteps (#32)

* ADR-277: uncommitted changes at validation

* ADR-277: Address PR review comments

- Delete Step.run() shim
- Remove redundant print() status calls from step methods
- Remove results parameter from handle_results() and --results CLI arg
- Split reviewing state into creating-pr + reviewing; delete _REDISPATCH
- Make combine_results abstract on ParallelSteps
- Update workflow files and dev-team.md orchestration docs accordingly

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Bump dev-tools version from 1.2.1 to 1.2.2

* Increment plugin version in dev-team plugin JSON

Increment the version in the plugin JSON file for the dev-team plugin by 0.0.1 in each task.

---------

Co-authored-by: Joe Davis <ElwoodMoves@hotmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Joe Davis <jodasoft@outlook.com>
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.

3 participants