wtf-p 0.1.0

package/commands/wtfp/create-outline.md

@@ -0,0 +1,275 @@
+---
+name: wtfp:create-outline
+description: Create document outline, section roadmap, and state tracking
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+
+<objective>
+Create the document outline and section roadmap for an initialized paper.
+
+Creates ROADMAP.md (section breakdown), STATE.md (writing memory), and section directories.
+
+This establishes the structure before section-by-section planning begins.
+</objective>
+
+<execution_context>
+@~/.claude/write-the-f-paper/workflows/create-outline.md
+@~/.claude/write-the-f-paper/templates/roadmap.md
+@~/.claude/write-the-f-paper/templates/state.md
+@~/.claude/write-the-f-paper/references/imrad-structure.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: Outline already exists. Use /wtfp:progress" && exit 1
+```
+
+</step>
+
+<step name="load">
+**Load project context:**
+
+- Read `.planning/PROJECT.md` for paper vision, core argument, requirements
+- Read `.planning/config.json` for document type and workflow mode
+- Read `.planning/structure/outline.md` for initial structure sketch
+- Read `.planning/structure/argument-map.md` for logical structure
+</step>
+
+<step name="structure">
+**Determine document structure:**
+
+Based on document type from config.json:
+
+**Research Paper (IMRaD):**
+- Abstract
+- Introduction
+- Methods (or Materials and Methods)
+- Results
+- Discussion
+- Conclusion (sometimes combined with Discussion)
+- References
+
+**Grant Proposal (NSF-style):**
+- Specific Aims
+- Background and Significance
+- Preliminary Data
+- Research Design and Methods
+- Timeline
+- Budget Justification
+
+**Grant Proposal (NIH-style):**
+- Specific Aims
+- Significance
+- Innovation
+- Approach
+- Timeline and Milestones
+
+**Thesis Chapter:**
+- Introduction
+- Literature Review
+- Methodology
+- Results/Findings
+- Discussion
+- Conclusion
+
+Use AskUserQuestion if structure needs customization:
+- header: "Structure"
+- question: "The standard structure for [type] is [list]. Any modifications?"
+- options:
+  - "Use standard structure" — Apply typical [type] structure
+  - "Customize sections" — I have specific sections in mind
+  - "Show me options" — What alternatives exist?
+
+</step>
+
+<step name="roadmap">
+**Create ROADMAP.md:**
+
+```markdown
+# Document Roadmap
+
+## Document: [Paper Title]
+## Type: [Paper Type]
+## Target: [Venue if known]
+
+## Sections
+
+### 1. [Section Name]
+- **Goal:** [What this section accomplishes]
+- **Word Target:** [X words]
+- **Status:** Not started
+- **Dependencies:** [Any prerequisites]
+
+### 2. [Section Name]
+- **Goal:** [What this section accomplishes]
+- **Word Target:** [X words]
+- **Status:** Not started
+- **Dependencies:** [Section 1 must establish X]
+
+[... continue for all sections ...]
+
+## Progress
+
+| # | Section | Goal | Words | Status |
+|---|---------|------|-------|--------|
+| 1 | [Name] | [1-liner] | 0/[target] | - |
+| 2 | [Name] | [1-liner] | 0/[target] | - |
+| ... | | | | |
+
+## Word Budget
+
+| Section | Target | Current | % |
+|---------|--------|---------|---|
+| [Name] | [X] | 0 | 0% |
+| ... | | | |
+| **Total** | **[X]** | **0** | **0%** |
+
+---
+*Last updated: [date] after outline creation*
+```
+
+</step>
+
+<step name="state">
+**Create STATE.md:**
+
+```markdown
+# Writing State
+
+## Project Reference
+- Project: .planning/PROJECT.md
+- Roadmap: .planning/ROADMAP.md
+- Config: .planning/config.json
+
+## Current Position
+- Section: 1 of [total]
+- Plan: 0 (not yet planned)
+- Status: Ready to plan first section
+
+## Progress
+- Sections: 0/[total] complete
+- Words: 0/[target] ([0]%)
+- Plans executed: 0
+
+## Argument Strength
+- Core claim: [from PROJECT.md]
+- Supporting claims: [from argument-map.md]
+- Evidence status: Not yet written
+
+## Key Decisions
+| Decision | Rationale | Section |
+|----------|-----------|---------|
+
+## Open Questions
+- [Questions from PROJECT.md that need resolution]
+
+## Deferred
+- [Nothing yet]
+
+## Session Continuity
+- Last session: [date]
+- Handoff: None
+
+---
+*Living document — updated after each writing session*
+```
+
+</step>
+
+<step name="directories">
+**Create section directories:**
+
+```bash
+mkdir -p .planning/sections
+```
+
+For each section in ROADMAP.md, create directory:
+
+```bash
+mkdir -p .planning/sections/01-[section-name-slug]
+mkdir -p .planning/sections/02-[section-name-slug]
+# ... for all sections
+```
+
+Use lowercase, hyphenated names (e.g., `01-introduction`, `02-methods`, `03-results`).
+
+</step>
+
+<step name="commit">
+**Commit outline:**
+
+```bash
+git add .planning/ROADMAP.md .planning/STATE.md .planning/sections/
+git commit -m "$(cat <<'EOF'
+docs: create document outline
+
+[N] sections, [X] word target
+
+Sections: [list section names]
+EOF
+)"
+```
+
+</step>
+
+<step name="done">
+**Present completion:**
+
+```
+Outline created:
+
+- Roadmap: .planning/ROADMAP.md ([N] sections, [X] words target)
+- State: .planning/STATE.md
+- Sections: .planning/sections/ ([N] directories)
+
+## Section Structure
+
+| # | Section | Words |
+|---|---------|-------|
+[table from ROADMAP.md]
+
+---
+
+## ▶ Next Up
+
+**Section 1: [Name]** — [goal]
+
+`/wtfp:plan-section 1`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/wtfp:discuss-section 1` — gather context first
+- `/wtfp:research-gap 1` — investigate literature needs
+
+---
+```
+
+</step>
+
+</process>
+
+<output>
+- `.planning/ROADMAP.md`
+- `.planning/STATE.md`
+- `.planning/sections/XX-name/` directories
+</output>
+
+<success_criteria>
+- [ ] ROADMAP.md has all sections with goals and word targets
+- [ ] STATE.md initialized with correct position
+- [ ] Section directories created
+- [ ] Word budget totals match target
+- [ ] All committed to git
+</success_criteria>

package/commands/wtfp/discuss-section.md

@@ -0,0 +1,71 @@
+---
+name: wtfp:discuss-section
+description: Gather section context through adaptive questioning before planning
+argument-hint: "[section-number]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+<objective>
+Gather section context through collaborative thinking before planning.
+
+Purpose: Help the user articulate their vision for how a section should read, what it needs to accomplish, and what makes it effective.
+Output: CONTEXT.md file in the section directory capturing vision, essential content, and boundaries.
+</objective>
+
+<execution_context>
+@~/.claude/write-the-f-paper/workflows/discuss-section.md
+@~/.claude/write-the-f-paper/templates/context.md
+</execution_context>
+
+<context>
+Section number: $ARGUMENTS (required)
+
+**Load project state first:**
+@.planning/STATE.md
+
+**Load roadmap:**
+@.planning/ROADMAP.md
+
+**Load structure documents:**
+@.planning/structure/argument-map.md
+@.planning/structure/outline.md
+</context>
+
+<process>
+
+<step name="verify">
+1. Check .planning/ directory exists (error if not - user should run /wtfp:new-paper)
+2. Validate section number provided via $ARGUMENTS
+3. Validate section exists in roadmap
+</step>
+
+<step name="execute_workflow">
+Execute the discuss-section workflow from execution_context.
+
+The workflow will:
+- Validate section against roadmap
+- Check for existing CONTEXT.md
+- Gather vision through AskUserQuestion (not interrogation)
+- Write CONTEXT.md capturing user's vision
+- Commit to git
+</step>
+
+<step name="done">
+Workflow outputs next steps to user (typically: research or plan the section).
+</step>
+
+</process>
+
+<success_criteria>
+- Section validated against roadmap
+- Vision gathered through collaborative thinking
+- CONTEXT.md created in section directory
+- CONTEXT.md committed to git
+- User knows next steps
+</success_criteria>

package/commands/wtfp/export-latex.md

@@ -0,0 +1,216 @@
+---
+name: wtfp:export-latex
+description: Export paper to LaTeX format
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Glob
+  - AskUserQuestion
+---
+
+<objective>
+Export the paper to LaTeX format.
+
+Generates:
+- paper.tex from markdown sections
+- references.bib from literature index
+- Applies journal/conference template
+
+Outputs to paper/ directory.
+</objective>
+
+<process>
+
+<step name="verify">
+**Verify content exists:**
+
+```bash
+[ ! -d paper ] && echo "ERROR: No paper/ directory found. Write sections first." && exit 1
+ls paper/*.md 2>/dev/null || echo "WARNING: No markdown content in paper/"
+```
+
+</step>
+
+<step name="template">
+**Select template:**
+
+Use AskUserQuestion:
+- header: "LaTeX Template"
+- question: "Which LaTeX template should we use?"
+- options:
+  - "Article (generic)" — Standard article class
+  - "IEEE" — IEEE conference/journal format
+  - "ACM" — ACM conference format
+  - "Custom" — I have a specific template
+  - "None" — Plain LaTeX, no special template
+
+If "Custom":
+- Ask for template path or template name
+</step>
+
+<step name="gather">
+**Gather content:**
+
+- Read all section files from paper/
+- Read PROJECT.md for title, authors (if specified)
+- Read sources/literature.md for bibliography
+- Identify figures referenced
+</step>
+
+<step name="convert">
+**Convert to LaTeX:**
+
+Create paper/paper.tex:
+
+```latex
+% Generated by WTF-P
+% [timestamp]
+
+\documentclass[template-options]{article-or-template}
+
+% Packages
+\usepackage[utf8]{inputenc}
+\usepackage{amsmath}
+\usepackage{graphicx}
+\usepackage{hyperref}
+\usepackage{cite}
+
+\title{[Title from PROJECT.md]}
+\author{[Author if specified]}
+\date{[Date]}
+
+\begin{document}
+
+\maketitle
+
+% Abstract
+\begin{abstract}
+[Abstract content]
+\end{abstract}
+
+% Sections
+\section{Introduction}
+[Introduction content converted to LaTeX]
+
+\section{Methods}
+[Methods content]
+
+% ... remaining sections ...
+
+% References
+\bibliographystyle{[style]}
+\bibliography{references}
+
+\end{document}
+```
+
+Conversion rules:
+- `## Heading` → `\section{Heading}`
+- `### Subheading` → `\subsection{Subheading}`
+- `**bold**` → `\textbf{bold}`
+- `*italic*` → `\textit{italic}`
+- `[citation]` → `\cite{citation}`
+- `![figure](path)` → `\includegraphics{path}` with figure environment
+- Math: `$inline$` → `$inline$`, `$$display$$` → equation environment
+
+</step>
+
+<step name="bibliography">
+**Generate bibliography:**
+
+Create paper/references.bib from sources/literature.md:
+
+```bibtex
+@article{key1,
+  author = {Author Name},
+  title = {Paper Title},
+  journal = {Journal Name},
+  year = {2024},
+  volume = {1},
+  pages = {1-10}
+}
+
+% ... additional entries ...
+```
+
+</step>
+
+<step name="compile_check">
+**Optional: Test compilation:**
+
+Use AskUserQuestion:
+- header: "Compile"
+- question: "Try to compile the LaTeX?"
+- options:
+  - "Yes, compile" — Run pdflatex
+  - "No, just export" — Skip compilation
+
+If yes:
+```bash
+cd paper && pdflatex paper.tex && bibtex paper && pdflatex paper.tex && pdflatex paper.tex
+```
+
+Report any errors.
+
+</step>
+
+<step name="commit">
+```bash
+git add paper/paper.tex paper/references.bib
+git commit -m "$(cat <<'EOF'
+export: generate LaTeX output
+
+Template: [template]
+Sections: [N]
+References: [N]
+EOF
+)"
+```
+
+</step>
+
+<step name="done">
+**Present completion:**
+
+```
+LaTeX export complete:
+
+- Document: paper/paper.tex
+- Bibliography: paper/references.bib
+- Template: [template]
+
+## Files Generated
+- paper.tex: [N] sections, [X] words
+- references.bib: [N] entries
+[If compiled:] - paper.pdf: Generated successfully
+
+## Manual Steps
+1. Review paper/paper.tex for any conversion issues
+2. Add any custom LaTeX packages needed
+3. Compile: `cd paper && pdflatex paper.tex && bibtex paper && pdflatex paper.tex`
+
+---
+
+## ▶ Next Up
+
+**Review output** — check formatting and fix issues
+
+Or if ready:
+`/wtfp:submit-milestone "draft-1"` — archive this version
+
+---
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] All sections converted to LaTeX
+- [ ] Bibliography generated
+- [ ] Template applied correctly
+- [ ] Figures referenced properly
+- [ ] Citations converted
+- [ ] Committed to git
+</success_criteria>