refactor: make instruction quality rules domain-agnostic#773
Closed
refactor: make instruction quality rules domain-agnostic#773
Conversation
Two changes to stop plan's over-detailed Expert Definitions from being blindly copied into perstack.toml instructions: 1. Plan: explicitly forbid deliverables/constraints in Architecture section — "write ONLY: name, one-line purpose, and role" 2. write-definition: new "How to Use plan.md" section — Architecture for tree structure only, Domain Knowledge for instruction content, Failure Conditions for verifier instruction 3. Verifier placement rule: must be direct child of coordinator, not nested under an executor Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The instruction quality rules and examples in create-expert were heavily biased toward coding (TypeScript, Jest, blessed/ink, file paths), causing generated experts to be overly code-focused even for non-coding domains. Replace coding-specific vocabulary with domain-neutral language across plan, write-definition, and verify-test so the pipeline produces experts appropriate for any task type. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2 tasks
Contributor
Author
|
Superseded by #774 which includes these changes plus the binary instruction checklist. |
auto-merge was automatically disabled
March 13, 2026 16:20
Pull request was closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Motivation
Generated experts were overly code-focused because the rules explaining "what not to put in instructions" used exclusively coding examples, causing write-definition to interpret everything through a coding lens.
Test plan
🤖 Generated with Claude Code