diff --git a/grill-me/SKILL.md b/grill-me/SKILL.md new file mode 100644 index 0000000..1073f36 --- /dev/null +++ b/grill-me/SKILL.md @@ -0,0 +1 @@ +Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. diff --git a/prd-to-issues/SKILL.md b/prd-to-issues/SKILL.md index 21dfd35..bbe6b0b 100644 --- a/prd-to-issues/SKILL.md +++ b/prd-to-issues/SKILL.md @@ -6,26 +6,24 @@ Break a PRD into independently-grabbable GitHub issues using vertical slices (tr ### 1. Locate the PRD -Ask the user for the PRD GitHub issue number (or URL). Fetch it with `gh issue view `. Read and internalize the full PRD content (with all comments). +Ask the user for the PRD GitHub issue number (or URL). -### 2. Explore the codebase +If the PRD is not already in your context window, fetch it with `gh issue view ` (with comments). -Read the key modules and integration layers referenced in the PRD. Identify: +### 2. Explore the codebase (optional) -- The distinct integration layers the feature touches (e.g. DB/schema, API/backend, UI, tests, config) -- Existing patterns for similar features -- Natural seams where work can be parallelized +If you have not already explored the codebase, do so to understand the current state of the code. ### 3. Draft vertical slices Break the PRD into **tracer bullet** issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer. +Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible. + - Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests) - A completed slice is demoable or verifiable on its own - Prefer many thin slices over few thick ones -- The first slice should be the simplest possible end-to-end path (the "hello world" tracer bullet) -- Later slices add breadth: edge cases, additional user stories, polish ### 4. Quiz the user @@ -33,7 +31,7 @@ Break the PRD into **tracer bullet** issues. Each issue is a thin vertical slice Present the proposed breakdown as a numbered list. For each slice, show: - **Title**: short descriptive name -- **Layers touched**: which integration layers this slice cuts through +- **Type**: HITL / AFK - **Blocked by**: which other slices (if any) must complete first - **User stories covered**: which user stories from the PRD this addresses @@ -42,8 +40,7 @@ Ask the user: - Does the granularity feel right? (too coarse / too fine) - Are the dependency relationships correct? - Should any slices be merged or split further? -- Is the ordering right for the first tracer bullet? -- Are there any slices missing? +- Are the correct slices marked as HITL and AFK? Iterate until the user approves the breakdown. @@ -80,15 +77,7 @@ Reference by number from the parent PRD: - User story 3 - User story 7 - -After creating all issues, print a summary table: - -``` -| # | Title | Blocked by | Status | -|---|-------|-----------|--------| -| 42 | Basic widget creation | None | Ready | -| 43 | Widget listing | #42 | Blocked | -``` + Do NOT close or modify the parent PRD issue.