#684 - Split grill-with-docs into grilling + domain-modeling primitives#686
Draft
bracyw wants to merge 1 commit into
Draft
#684 - Split grill-with-docs into grilling + domain-modeling primitives#686bracyw wants to merge 1 commit into
bracyw wants to merge 1 commit into
Conversation
Adopt Matt Pocock's upstream split: grill-with-docs shrinks to an orchestrator delegating to two new skills. grilling carries the interview primitive with the facts-vs-decisions split and confirmation gate (fixing the self-grilling blanket line); domain-modeling carries the glossary/ADR discipline plus the CONTEXT-FORMAT/ADR-FORMAT files moved out of grill-with-docs. Repoint improve-codebase-architecture links, add ADR-0004, update CLAUDE.md pointers. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SdH2gxRtfjoqUWa5hG8SvF
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
2 participants
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.
Changes
Adopts Matt Pocock's upstream split of grill-with-docs into two reusable primitives, and fixes a regression the monolith carried.
grill-with-docs shrinks to an orchestrator that runs a grilling session using the domain-modeling skill. Two new skills:
Repointed the two format-file links in improve-codebase-architecture, added disable-model-invocation to grill-with-docs, added ADR-0004, and updated CLAUDE.md pointers.
Notes
Stacked on #685 — base is the 683-rename-to-spec-to-tickets branch, so this PR's diff shows only the grill-with-docs split. GitHub will retarget it to develop once #685 merges. Review/merge #685 first.
The regression: our monolith still had the blanket line "if a question can be answered by exploring the codebase, explore the codebase instead" — the wording upstream flagged as letting a grilling agent answer its own decisions and race ahead.
Test Cases
Checklist
Closes #684
Generated by Claude Code