fix(rules): Unmix signals about question format (file/inline)#167
Closed
t1h0 wants to merge 1 commit intoawslabs:prompt-eng/review-aidlc-rulesfrom
Closed
fix(rules): Unmix signals about question format (file/inline)#167t1h0 wants to merge 1 commit intoawslabs:prompt-eng/review-aidlc-rulesfrom
t1h0 wants to merge 1 commit intoawslabs:prompt-eng/review-aidlc-rulesfrom
Conversation
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
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
Fixes the next highest-priority finding from #156
Problem: The question-format-guide and core-workflow rules sent contradictory signals — they stated "NEVER ask questions in chat" while other stage rules required inline stage-completion prompts and approval requests. AI agents following the workflow received conflicting instructions about when file-based vs. inline questions were appropriate.
Fix: Distinguish between question types: requirements-gathering and clarification questions must go in dedicated
.mdfiles, while stage-completion prompts and approval requests may be presented inline in chat. Updated all references to reflect this distinction.Changes
User experience
Before: An AI agent following AIDLC rules encounters "NEVER ask questions in chat" but is also told to present approval prompts inline. The agent either violates the blanket rule or awkwardly puts simple yes/no approval prompts into files.
After: The rules clearly separate question types. The agent knows to use files for requirements-gathering and clarification, and may present stage-completion prompts and approval requests inline — no contradiction.
Checklist
Test Plan
Acknowledgment
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.