get-research-done 1.1.0

package/commands/grd/progress.md

@@ -0,0 +1,364 @@
+---
+name: grd:progress
+description: Check project progress, show context, and route to next action (execute or plan)
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - SlashCommand
+---
+
+<objective>
+Check project progress, summarize recent work and what's ahead, then intelligently route to the next action - either executing an existing plan or creating the next one.
+
+Provides situational awareness before continuing work.
+</objective>
+
+
+<process>
+
+<step name="verify">
+**Verify planning structure exists:**
+
+Use Bash (not Glob) to check—Glob respects .gitignore but .planning/ is often gitignored:
+
+```bash
+test -d .planning && echo "exists" || echo "missing"
+```
+
+If no `.planning/` directory:
+
+```
+No planning structure found.
+
+Run /grd:new-project to start a new project.
+```
+
+Exit.
+
+If missing STATE.md: suggest `/grd:new-project`.
+
+**If ROADMAP.md missing but PROJECT.md exists:**
+
+This means a milestone was completed and archived. Go to **Route F** (between milestones).
+
+If missing both ROADMAP.md and PROJECT.md: suggest `/grd:new-project`.
+</step>
+
+<step name="load">
+**Load full project context:**
+
+- Read `.planning/STATE.md` for living memory (position, decisions, issues)
+- Read `.planning/ROADMAP.md` for phase structure and objectives
+- Read `.planning/PROJECT.md` for current state (What This Is, Core Value, Requirements)
+- Read `.planning/config.json` for settings (model_profile, workflow toggles)
+  </step>
+
+<step name="recent">
+**Gather recent work context:**
+
+- Find the 2-3 most recent SUMMARY.md files
+- Extract from each: what was accomplished, key decisions, any issues logged
+- This shows "what we've been working on"
+  </step>
+
+<step name="position">
+**Parse current position:**
+
+- From STATE.md: current phase, plan number, status
+- Calculate: total plans, completed plans, remaining plans
+- Note any blockers or concerns
+- Check for CONTEXT.md: For phases without PLAN.md files, check if `{phase}-CONTEXT.md` exists in phase directory
+- Count pending todos: `ls .planning/todos/pending/*.md 2>/dev/null | wc -l`
+- Check for active debug sessions: `ls .planning/debug/*.md 2>/dev/null | grep -v resolved | wc -l`
+  </step>
+
+<step name="report">
+**Present rich status report:**
+
+```
+# [Project Name]
+
+**Progress:** [████████░░] 8/10 plans complete
+**Profile:** [quality/balanced/budget]
+
+## Recent Work
+- [Phase X, Plan Y]: [what was accomplished - 1 line]
+- [Phase X, Plan Z]: [what was accomplished - 1 line]
+
+## Current Position
+Phase [N] of [total]: [phase-name]
+Plan [M] of [phase-total]: [status]
+CONTEXT: [✓ if CONTEXT.md exists | - if not]
+
+## Key Decisions Made
+- [decision 1 from STATE.md]
+- [decision 2]
+
+## Blockers/Concerns
+- [any blockers or concerns from STATE.md]
+
+## Pending Todos
+- [count] pending — /grd:check-todos to review
+
+## Active Debug Sessions
+- [count] active — /grd:debug to continue
+(Only show this section if count > 0)
+
+## What's Next
+[Next phase/plan objective from ROADMAP]
+```
+
+</step>
+
+<step name="route">
+**Determine next action based on verified counts.**
+
+**Step 1: Count plans, summaries, and issues in current phase**
+
+List files in the current phase directory:
+
+```bash
+ls -1 .planning/phases/[current-phase-dir]/*-PLAN.md 2>/dev/null | wc -l
+ls -1 .planning/phases/[current-phase-dir]/*-SUMMARY.md 2>/dev/null | wc -l
+ls -1 .planning/phases/[current-phase-dir]/*-UAT.md 2>/dev/null | wc -l
+```
+
+State: "This phase has {X} plans, {Y} summaries."
+
+**Step 1.5: Check for unaddressed UAT gaps**
+
+Check for UAT.md files with status "diagnosed" (has gaps needing fixes).
+
+```bash
+# Check for diagnosed UAT with gaps
+grep -l "status: diagnosed" .planning/phases/[current-phase-dir]/*-UAT.md 2>/dev/null
+```
+
+Track:
+- `uat_with_gaps`: UAT.md files with status "diagnosed" (gaps need fixing)
+
+**Step 2: Route based on counts**
+
+| Condition | Meaning | Action |
+|-----------|---------|--------|
+| uat_with_gaps > 0 | UAT gaps need fix plans | Go to **Route E** |
+| summaries < plans | Unexecuted plans exist | Go to **Route A** |
+| summaries = plans AND plans > 0 | Phase complete | Go to Step 3 |
+| plans = 0 | Phase not yet planned | Go to **Route B** |
+
+---
+
+**Route A: Unexecuted plan exists**
+
+Find the first PLAN.md without matching SUMMARY.md.
+Read its `<objective>` section.
+
+```
+---
+
+## ▶ Next Up
+
+**{phase}-{plan}: [Plan Name]** — [objective summary from PLAN.md]
+
+`/grd:execute-phase {phase}`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+---
+
+**Route B: Phase needs planning**
+
+Check if `{phase}-CONTEXT.md` exists in phase directory.
+
+**If CONTEXT.md exists:**
+
+```
+---
+
+## ▶ Next Up
+
+**Phase {N}: {Name}** — {Goal from ROADMAP.md}
+<sub>✓ Context gathered, ready to plan</sub>
+
+`/grd:plan-phase {phase-number}`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+**If CONTEXT.md does NOT exist:**
+
+```
+---
+
+## ▶ Next Up
+
+**Phase {N}: {Name}** — {Goal from ROADMAP.md}
+
+`/grd:discuss-phase {phase}` — gather context and clarify approach
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/grd:plan-phase {phase}` — skip discussion, plan directly
+- `/grd:list-phase-assumptions {phase}` — see Claude's assumptions
+
+---
+```
+
+---
+
+**Route E: UAT gaps need fix plans**
+
+UAT.md exists with gaps (diagnosed issues). User needs to plan fixes.
+
+```
+---
+
+## ⚠ UAT Gaps Found
+
+**{phase}-UAT.md** has {N} gaps requiring fixes.
+
+`/grd:plan-phase {phase} --gaps`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/grd:execute-phase {phase}` — execute phase plans
+- `/grd:verify-work {phase}` — run more UAT testing
+
+---
+```
+
+---
+
+**Step 3: Check milestone status (only when phase complete)**
+
+Read ROADMAP.md and identify:
+1. Current phase number
+2. All phase numbers in the current milestone section
+
+Count total phases and identify the highest phase number.
+
+State: "Current phase is {X}. Milestone has {N} phases (highest: {Y})."
+
+**Route based on milestone status:**
+
+| Condition | Meaning | Action |
+|-----------|---------|--------|
+| current phase < highest phase | More phases remain | Go to **Route C** |
+| current phase = highest phase | Milestone complete | Go to **Route D** |
+
+---
+
+**Route C: Phase complete, more phases remain**
+
+Read ROADMAP.md to get the next phase's name and goal.
+
+```
+---
+
+## ✓ Phase {Z} Complete
+
+## ▶ Next Up
+
+**Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
+
+`/grd:discuss-phase {Z+1}` — gather context and clarify approach
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/grd:plan-phase {Z+1}` — skip discussion, plan directly
+- `/grd:verify-work {Z}` — user acceptance test before continuing
+
+---
+```
+
+---
+
+**Route D: Milestone complete**
+
+```
+---
+
+## 🎉 Milestone Complete
+
+All {N} phases finished!
+
+## ▶ Next Up
+
+**Complete Milestone** — archive and prepare for next
+
+`/grd:complete-milestone`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/grd:verify-work` — user acceptance test before completing milestone
+
+---
+```
+
+---
+
+**Route F: Between milestones (ROADMAP.md missing, PROJECT.md exists)**
+
+A milestone was completed and archived. Ready to start the next milestone cycle.
+
+Read MILESTONES.md to find the last completed milestone version.
+
+```
+---
+
+## ✓ Milestone v{X.Y} Complete
+
+Ready to plan the next milestone.
+
+## ▶ Next Up
+
+**Start Next Milestone** — questioning → research → requirements → roadmap
+
+`/grd:new-milestone`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+</step>
+
+<step name="edge_cases">
+**Handle edge cases:**
+
+- Phase complete but next phase not planned → offer `/grd:plan-phase [next]`
+- All work complete → offer milestone completion
+- Blockers present → highlight before offering to continue
+- Handoff file exists → mention it, offer `/grd:resume-work`
+  </step>
+
+</process>
+
+<success_criteria>
+
+- [ ] Rich context provided (recent work, decisions, issues)
+- [ ] Current position clear with visual progress
+- [ ] What's next clearly explained
+- [ ] Smart routing: /grd:execute-phase if plans exist, /grd:plan-phase if not
+- [ ] User confirms before any action
+- [ ] Seamless handoff to appropriate gsd command
+      </success_criteria>

package/commands/grd/quick-explore.md

@@ -0,0 +1,236 @@
+---
+name: grd:quick-explore
+description: Fast EDA producing console summary for quick data familiarization decisions
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+
+Fast exploratory data analysis that outputs a console-friendly summary for quick decisions and team sharing.
+
+Unlike `/grd:explore` which produces a comprehensive DATA_REPORT.md, quick-explore prioritizes speed and readability:
+- Completes in under 60 seconds
+- Outputs formatted summary to console (copy-paste ready)
+- Highlights critical issues with visual indicators
+- Generates minimal DATA_REPORT.md marked as "Quick Explore Mode"
+
+**Creates:**
+- Console output with TL;DR, column summary, distribution highlights
+- `.planning/DATA_REPORT.md` — marked as Quick Explore Mode (run full explore for rigor)
+
+**Use cases:**
+- First look at a new dataset
+- Quick check before a meeting
+- Sharing data overview with team (copy-paste console output)
+- Deciding whether to invest time in full exploration
+
+**After this command:**
+- For quick decisions: Use the console summary
+- For modeling: Run `/grd:explore` for comprehensive analysis
+
+</objective>
+
+<execution_context>
+
+@~/.claude/get-research-done/templates/data-report.md
+
+</execution_context>
+
+<process>
+
+## Phase 1: Setup and Data Path Resolution
+
+**Check if project initialized:**
+
+```bash
+[ ! -f .planning/PROJECT.md ] && echo "ERROR: Project not initialized. Run /grd:new-project first." && exit 1
+```
+
+**Determine data path:**
+
+If [path] argument provided:
+- Use it directly
+- Validate path exists
+
+If no argument:
+- Check for common data directories (./data/, ./datasets/, ./raw/)
+- If found, list contents and ask user to select
+- If not found, ask user to provide path interactively
+
+**Validate data source:**
+
+```bash
+# Check if path exists
+if [ -f "$DATA_PATH" ]; then
+    echo "Single file: $DATA_PATH"
+elif [ -d "$DATA_PATH" ]; then
+    echo "Directory: $DATA_PATH"
+    find "$DATA_PATH" -type f \( -name "*.csv" -o -name "*.parquet" -o -name "*.json" \) | head -10
+else
+    echo "ERROR: Path not found: $DATA_PATH"
+    exit 1
+fi
+```
+
+## Phase 2: Spawn Explorer Agent (Quick Mode)
+
+Display quick explore banner:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► QUICK EXPLORE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Analyzing: [data_path]
+Mode: Quick (< 60 seconds)
+```
+
+Spawn grd-explorer agent with quick mode context:
+
+```
+Task(prompt="
+<data_source>
+Path: [data_path]
+Type: [file | directory]
+</data_source>
+
+<profiling_mode>quick</profiling_mode>
+
+<quick_mode_instructions>
+Quick explore mode priorities:
+1. Speed: Complete analysis in < 60 seconds
+2. Console output: Format results for terminal display
+3. Visual indicators: Use emoji and formatting for quick scanning
+4. Critical issues: Surface blocking problems prominently
+
+Skip in quick mode:
+- Detailed correlation analysis
+- Comprehensive leakage detection (do basic checks only)
+- Full distribution histograms
+- Percentile calculations beyond quartiles
+
+Include in quick mode:
+- Row/column counts, memory usage
+- Column types and missing value percentages
+- Basic distribution indicators (skewness direction, outlier flags)
+- Top 3 most concerning data quality issues
+- Quick leakage red flags (obvious column name patterns)
+
+Output format:
+1. Print formatted TL;DR to console
+2. Print column summary table to console
+3. Print distribution highlights to console
+4. Print quality warnings to console
+5. Write DATA_REPORT.md with 'Quick Explore Mode' header
+</quick_mode_instructions>
+
+<project_context>
+@.planning/PROJECT.md
+
+Extract:
+- What this project is about
+- What the target variable might be (if ML project)
+</project_context>
+
+<console_output_format>
+Use Rich-style formatting for console output:
+
+## TL;DR
+- Rows: X | Columns: Y | Memory: Z MB
+- Missing: X% overall | Y columns have nulls
+- Types: X numeric, Y categorical, Z datetime
+- Issues: [emoji] [count] [severity] items need attention
+
+## Column Summary (one line per column)
+| Column | Type | Missing | Distribution |
+|--------|------|---------|--------------|
+| age    | int  | 0%      | ▁▂▃▅▇ normal |
+| income | float| 5%      | ▁▁▁▁▇ right-skewed |
+
+## Distribution Highlights
+- [column]: [skewness indicator] [outlier flag]
+
+## Quality Warnings
+- [emoji] [severity]: [description]
+</console_output_format>
+
+<output>
+1. Print formatted analysis to console
+2. Write .planning/DATA_REPORT.md with Quick Explore header
+3. Return summary of findings
+</output>
+", subagent_type="grd-explorer", model="sonnet", description="Quick explore data")
+```
+
+## Phase 3: Present Results
+
+After agent completes, display footer:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ GRD ► QUICK EXPLORE COMPLETE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Quick report: .planning/DATA_REPORT.md (Quick Explore Mode)
+
+───────────────────────────────────────────────────────────────
+
+**For comprehensive analysis:** /grd:explore [path]
+**To proceed with hypothesis:** /grd:architect
+
+Note: Quick explore provides fast insights but skips thorough
+leakage detection. Run full explore before modeling.
+
+───────────────────────────────────────────────────────────────
+```
+
+</process>
+
+<arguments>
+
+**[path]** (required)
+- Path to data file or directory
+- Examples: `./data/train.csv`, `./datasets/`
+
+</arguments>
+
+<examples>
+
+**Quick look at CSV:**
+```
+/grd:quick-explore ./data/train.csv
+```
+
+**Quick look at dataset directory:**
+```
+/grd:quick-explore ./datasets/
+```
+
+</examples>
+
+<output>
+
+**Console output:**
+- TL;DR summary (row/column counts, types, issues)
+- Column summary table with distribution sparklines
+- Quality warnings with severity indicators
+
+**File output:**
+- `.planning/DATA_REPORT.md` — marked as Quick Explore Mode
+
+</output>
+
+<success_criteria>
+
+- [ ] Data path resolved
+- [ ] grd-explorer spawned with quick mode context
+- [ ] Console summary printed with formatted output
+- [ ] DATA_REPORT.md created with Quick Explore Mode header
+- [ ] Analysis completed in < 60 seconds
+- [ ] User informed about full explore option
+
+</success_criteria>