wtf-p 0.1.0

package/commands/wtfp/research-gap.md

@@ -0,0 +1,235 @@
+---
+name: wtfp:research-gap
+description: Comprehensive literature/domain research for a section
+argument-hint: "[section]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - WebFetch
+  - WebSearch
+  - mcp__context7__*
+  - AskUserQuestion
+---
+
+<objective>
+Perform comprehensive literature/domain research for a specific section.
+
+Discovers:
+- Key citations needed
+- Standard approaches in the literature
+- Gaps in current research
+- How experts write about this topic
+
+Creates RESEARCH.md with "how experts write this" knowledge.
+
+Use for literature reviews, methodology justification, positioning your contribution.
+</objective>
+
+<execution_context>
+@~/.claude/write-the-f-paper/workflows/research-gap.md
+@~/.claude/write-the-f-paper/references/research-pitfalls.md
+</execution_context>
+
+<process>
+
+<step name="verify">
+**Verify project exists:**
+
+```bash
+[ ! -f .planning/PROJECT.md ] && echo "ERROR: No project found. Run /wtfp:new-paper first" && exit 1
+[ ! -f .planning/ROADMAP.md ] && echo "ERROR: No outline found. Run /wtfp:create-outline first" && exit 1
+```
+
+</step>
+
+<step name="load">
+**Load context:**
+
+- Read PROJECT.md for core argument and field
+- Read ROADMAP.md for section goal
+- Read argument-map.md for claims to support
+- Read sources/literature.md for existing citations
+</step>
+
+<step name="scope">
+**Define research scope:**
+
+Use AskUserQuestion:
+- header: "Research Focus"
+- question: "What specifically do you need to understand for [section]?"
+- options:
+  - "Key citations" — Who are the must-cite authors/papers?
+  - "Methodology" — How do others approach this method?
+  - "State of field" — What's the current consensus/debate?
+  - "Positioning" — How to differentiate from existing work?
+  - "All of the above" — Comprehensive research
+
+</step>
+
+<step name="research">
+**Conduct research:**
+
+Based on scope, investigate:
+
+**Key Citations:**
+- Identify foundational papers
+- Find recent high-impact work
+- Note methodological papers
+- Track disagreements/debates
+
+**Standard Approaches:**
+- How do others structure similar sections?
+- What's the typical argument flow?
+- What evidence is typically presented?
+
+**Gaps:**
+- What's missing in current literature?
+- Where does your work fit?
+- What questions remain unanswered?
+
+**Expert Writing Patterns:**
+- How do top papers in this area write about this?
+- What terminology is standard?
+- What level of detail is expected?
+
+</step>
+
+<step name="create_research">
+**Create RESEARCH.md:**
+
+```markdown
+---
+section: XX-name
+scope: [research scope]
+confidence: [high/medium/low]
+---
+
+# Research: [Section Name]
+
+## Summary
+[2-3 sentence overview of findings]
+
+## Key Citations
+
+### Foundational
+| Citation | Contribution | Relevance |
+|----------|--------------|-----------|
+| [Author (Year)] | [What they established] | [Why cite] |
+
+### Recent/High-Impact
+| Citation | Contribution | Relevance |
+|----------|--------------|-----------|
+
+### Methodology
+| Citation | Approach | Relevance |
+|----------|----------|-----------|
+
+## Standard Approaches
+[How others write about this topic]
+
+- Typical structure: [...]
+- Common arguments: [...]
+- Expected evidence: [...]
+
+## Field Consensus
+[What's generally agreed upon]
+
+## Active Debates
+[Where experts disagree]
+
+## Gaps in Literature
+- [Gap 1]: [your opportunity]
+- [Gap 2]: [your opportunity]
+
+## Your Positioning
+[How your work relates to existing literature]
+
+## Writing Recommendations
+- Terminology to use: [...]
+- Level of detail expected: [...]
+- Citations to definitely include: [...]
+- Arguments to make: [...]
+
+## Sources Consulted
+- [Source 1]
+- [Source 2]
+
+## Confidence Assessment
+- Key citations: [high/medium/low]
+- Field understanding: [high/medium/low]
+- Gap identification: [high/medium/low]
+
+## Open Questions
+- [Questions that need user input]
+
+---
+*Researched: [date]*
+```
+
+</step>
+
+<step name="update_literature">
+**Update literature index:**
+
+Add any new citations discovered to `.planning/sources/literature.md`.
+
+</step>
+
+<step name="commit">
+```bash
+git add .planning/sections/XX-name/XX-RESEARCH.md .planning/sources/literature.md
+git commit -m "$(cat <<'EOF'
+research(XX): [section name] literature review
+
+Scope: [scope]
+Citations found: [N]
+Confidence: [level]
+EOF
+)"
+```
+
+</step>
+
+<step name="done">
+**Present completion:**
+
+```
+Research complete:
+
+- Research: .planning/sections/XX-name/XX-RESEARCH.md
+- Citations added: [N] new references
+- Confidence: [level]
+
+## Key Findings
+[2-3 bullet summary]
+
+## Recommended Next Steps
+[Based on research]
+
+---
+
+## ▶ Next Up
+
+**Plan section** — create writing plan with research context
+
+`/wtfp:plan-section [section]`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Research scope defined with user
+- [ ] Key citations identified
+- [ ] Standard approaches documented
+- [ ] Gaps identified
+- [ ] Writing recommendations provided
+- [ ] literature.md updated
+- [ ] All committed to git
+</success_criteria>

package/commands/wtfp/resume-writing.md

@@ -0,0 +1,142 @@
+---
+name: wtfp:resume-writing
+description: Resume work from previous session with full context restoration
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - SlashCommand
+---
+
+<objective>
+Resume work from a previous session with full context restoration.
+
+Reads STATE.md and any .continue-here.md files to restore context.
+
+Shows current position, recent progress, and offers appropriate next actions.
+</objective>
+
+<process>
+
+<step name="verify">
+**Verify project exists:**
+
+```bash
+[ ! -f .planning/STATE.md ] && echo "ERROR: No project state found. Run /wtfp:new-paper first" && exit 1
+```
+
+</step>
+
+<step name="load">
+**Load project context:**
+
+- Read STATE.md for current position and session info
+- Read PROJECT.md for paper vision
+- Read ROADMAP.md for section structure
+- Check for .continue-here.md files in section directories
+</step>
+
+<step name="check_handoff">
+**Check for handoff file:**
+
+```bash
+find .planning/sections -name ".continue-here.md" 2>/dev/null | head -1
+```
+
+If handoff file exists:
+- Read it for detailed resumption context
+- Extract: current task, remaining work, next action, blockers
+</step>
+
+<step name="present">
+**Present resumption context:**
+
+**If handoff file exists:**
+
+```
+# Resuming: [Paper Title]
+
+## Where You Left Off
+Section [N]: [Name]
+Task [X] of [Y]: [task description]
+Status: [in_progress/blocked]
+
+## Completed in Last Session
+- [Task 1]: [done]
+- [Task 2]: [done]
+
+## Remaining Work
+- [Current task]: [in progress]
+- [Next tasks]: [pending]
+
+## Context Notes
+[Notes from .continue-here.md]
+
+## Blockers (if any)
+[Any blockers noted]
+
+---
+
+## ▶ Next Action
+
+[From .continue-here.md next_action]
+
+`/wtfp:[appropriate-command]`
+
+<sub>`/clear` first if context window is full</sub>
+
+---
+```
+
+**If no handoff file:**
+
+```
+# Resuming: [Paper Title]
+
+## Current Position
+Section [N] of [total]: [Name]
+Plan [X] of [section-total]: [status]
+Words: [current] / [target]
+
+## Recent Progress
+[From STATE.md or recent SUMMARY files]
+
+---
+
+## ▶ Next Up
+
+[Based on STATE.md current position]
+
+`/wtfp:[appropriate-command]`
+
+---
+
+For full status: `/wtfp:progress`
+
+---
+```
+
+</step>
+
+<step name="cleanup">
+**Clean up handoff file after resume:**
+
+If user proceeds with next action, the handoff file should be removed:
+
+```bash
+rm .planning/sections/XX-name/.continue-here.md
+git add .planning/sections/XX-name/
+git commit -m "docs: resume [section name] from handoff"
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] STATE.md read for current position
+- [ ] Handoff file detected if exists
+- [ ] Full context presented
+- [ ] Clear next action provided
+- [ ] Routes to appropriate command
+</success_criteria>