Skip to content

refactor: simplify create-expert — remove plan, must/should signals, direct delegation#792

Merged
FL4TLiN3 merged 1 commit intomainfrom
refactor/simplify-create-expert-pipeline
Mar 14, 2026
Merged

refactor: simplify create-expert — remove plan, must/should signals, direct delegation#792
FL4TLiN3 merged 1 commit intomainfrom
refactor/simplify-create-expert-pipeline

Conversation

@FL4TLiN3
Copy link
Contributor

Summary

Major simplification of create-expert pipeline (346→171 lines):

  • Remove plan expert — write handles planning + authoring, produces perstack.toml + test-spec.md
  • Flatten delegation — write delegates to review directly (soft signal as direct delegation pattern)
  • Simplify names — write, review, test, verify (drop -definition, -expert, -test suffixes)
  • Hard signal redesign:
    • Must: ONE signal, binary, core task completion. Always blocks sign-off.
    • Should: multiple signals, user value checks, threshold-based sign-off (e.g., "≤ N of M fail")
  • Remove domain knowledge principles — focus on signal design over task decomposition
  • Soft signal pattern — executors delegate to reviewers directly (recommended for generated experts too)

Structure

Before: create-expert → {plan, write-definition, review-definition, test-expert, verify-test}
After:  create-expert → {write → review, test, verify}

Test plan

  • Run create-expert and verify write produces both perstack.toml and test-spec.md
  • Verify test-spec.md has exactly ONE must signal and multiple should signals with threshold
  • Confirm verify only CONTINUEs on must signal failure
  • Check write delegates to review and addresses feedback before returning

🤖 Generated with Claude Code

@FL4TLiN3 FL4TLiN3 force-pushed the refactor/simplify-create-expert-pipeline branch 2 times, most recently from b1a2ce6 to 1d0ba8a Compare March 14, 2026 10:35
…cture

Major simplification of the create-expert pipeline:

- Remove plan expert — write handles both planning and authoring
- Write produces perstack.toml + test-spec.md (test query + signals)
- Write delegates to review directly (soft signal as direct delegation)
- Simplify delegate names: write, review, test, verify
- Remove domain knowledge design principles, focus on signal design
- Hard signal redesign:
  - Must: ONE signal, binary, core task completion. Always blocks.
  - Should: multiple signals, user value validation, threshold-based sign-off
- Soft signal: recommended pattern is executor delegates to reviewer directly

Before: create-expert → {plan, write-definition, review-definition, test-expert, verify-test}
After:  create-expert → {write → review, test, verify}

Version 1.0.22.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@FL4TLiN3 FL4TLiN3 force-pushed the refactor/simplify-create-expert-pipeline branch from 1d0ba8a to 7c00361 Compare March 14, 2026 10:39
@FL4TLiN3 FL4TLiN3 enabled auto-merge (squash) March 14, 2026 10:39
@FL4TLiN3 FL4TLiN3 merged commit 7467741 into main Mar 14, 2026
11 checks passed
@FL4TLiN3 FL4TLiN3 deleted the refactor/simplify-create-expert-pipeline branch March 14, 2026 10:40
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