wtf-p 0.1.0

package/commands/wtfp/help.md

@@ -0,0 +1,342 @@
+---
+name: wtfp:help
+description: Show available WTF-P commands and usage guide
+---
+
+<objective>
+Display the complete WTF-P command reference.
+
+Output ONLY the reference content below. Do NOT add:
+
+- Project-specific analysis
+- Git status or file context
+- Next-step suggestions
+- Any commentary beyond the reference
+</objective>
+
+<reference>
+# WTF-P Command Reference
+
+**WTF-P** (Write The F***ing Paper) creates hierarchical writing plans optimized for solo academic writing with Claude Code.
+
+## Quick Start
+
+1. `/wtfp:new-paper` - Initialize a new paper with vision
+2. `/wtfp:create-outline` - Create document outline and sections
+3. `/wtfp:plan-section <number>` - Create detailed plan for a section
+4. `/wtfp:write-section <path>` - Execute the writing plan
+
+## Core Workflow
+
+```
+Initialization -> Outlining -> Planning -> Writing -> Review
+```
+
+### Paper Initialization
+
+**`/wtfp:new-paper`**
+Initialize new paper project with deep context gathering.
+
+- Creates `.planning/PROJECT.md` (paper vision and requirements)
+- Creates `.planning/config.json` (workflow mode)
+- Creates structure docs (argument-map, outline, narrative-arc)
+- Asks about paper type, target venue, core argument
+- Commits initialization files to git
+
+Usage: `/wtfp:new-paper`
+
+**`/wtfp:create-outline`**
+Create section roadmap and state tracking for initialized paper.
+
+- Creates `.planning/ROADMAP.md` (section breakdown)
+- Creates `.planning/STATE.md` (writing memory)
+- Creates `.planning/sections/` directories
+- Establishes word budget per section
+
+Usage: `/wtfp:create-outline`
+
+**`/wtfp:map-project`**
+Map existing source materials for brownfield writing projects.
+
+- Indexes existing literature, data, and prior drafts
+- Creates `.planning/sources/` with organized references
+- Covers: literature.md, data.md, prior-drafts.md
+- Use before `/wtfp:new-paper` on existing writing projects
+
+Usage: `/wtfp:map-project`
+
+### Section Planning
+
+**`/wtfp:discuss-section <number>`**
+Help articulate your vision for a section before planning.
+
+- Captures how you imagine this section working
+- Creates CONTEXT.md with your vision, essentials, and boundaries
+- Use when you have ideas about how something should read/feel
+
+Usage: `/wtfp:discuss-section 2`
+
+**`/wtfp:research-gap <number>`**
+Comprehensive literature/domain research for a section.
+
+- Discovers standard approaches, key citations, gaps
+- Creates RESEARCH.md with "how experts write this" knowledge
+- Use for literature reviews, methodology justification, etc.
+
+Usage: `/wtfp:research-gap 3`
+
+**`/wtfp:list-assumptions <number>`**
+See what Claude is planning to write before it starts.
+
+- Shows Claude's intended approach for a section
+- Lets you course-correct if Claude misunderstood your vision
+- No files created - conversational output only
+
+Usage: `/wtfp:list-assumptions 3`
+
+**`/wtfp:plan-section <number>`**
+Create detailed writing plan for a specific section.
+
+- Generates `.planning/sections/XX-section-name/XX-YY-PLAN.md`
+- Breaks section into concrete writing tasks
+- Includes verification criteria and word targets
+- Multiple plans per section supported (XX-01, XX-02, etc.)
+
+Usage: `/wtfp:plan-section 1`
+Result: Creates `.planning/sections/01-introduction/01-01-PLAN.md`
+
+### Writing Execution
+
+**`/wtfp:write-section <path>`**
+Execute a PLAN.md file directly.
+
+- Writes section content following the plan
+- Creates SUMMARY.md after completion
+- Updates STATE.md with word counts and progress
+- Supports three modes: Co-Author, Scaffold, Reviewer
+
+Usage: `/wtfp:write-section .planning/sections/01-introduction/01-01-PLAN.md`
+
+### Outline Management
+
+**`/wtfp:add-section <description>`**
+Add new section to end of current structure.
+
+- Appends to ROADMAP.md
+- Uses next sequential number
+- Updates section directory structure
+
+Usage: `/wtfp:add-section "Add limitations subsection"`
+
+**`/wtfp:insert-section <after> <description>`**
+Insert urgent section between existing sections.
+
+- Creates intermediate section (e.g., 3.1 between 3 and 4)
+- Useful for discovered gaps that must be addressed
+- Maintains section ordering
+
+Usage: `/wtfp:insert-section 3 "Add methodology detail"`
+Result: Creates Section 3.1
+
+**`/wtfp:remove-section <number>`**
+Remove a future section and renumber subsequent sections.
+
+- Deletes section directory and all references
+- Renumbers all subsequent sections to close the gap
+- Only works on future (unwritten) sections
+- Git commit preserves historical record
+
+Usage: `/wtfp:remove-section 7`
+
+### Review & Revision
+
+**`/wtfp:review-section [number]`**
+User acceptance testing of written sections.
+
+- Runs 3-layer verification (Citation, Coherence, Rubric)
+- Identifies issues needing revision
+- Creates ISSUES.md if problems found
+
+Usage: `/wtfp:review-section 2`
+
+**`/wtfp:plan-revision <plan>`**
+Create fix plan from review issues.
+
+- Reads ISSUES.md for the section
+- Creates targeted revision plan
+- Addresses specific reviewer/verification comments
+
+Usage: `/wtfp:plan-revision 02-01`
+
+### Progress Tracking
+
+**`/wtfp:progress`**
+Check writing status and intelligently route to next action.
+
+- Shows visual progress bar and word count
+- Summarizes recent work from SUMMARY files
+- Displays current position and what's next
+- Offers to execute next plan or create it if missing
+
+Usage: `/wtfp:progress`
+
+### Session Management
+
+**`/wtfp:resume-writing`**
+Resume work from previous session with full context restoration.
+
+- Reads STATE.md for writing context
+- Shows current position and recent progress
+- Offers next actions based on project state
+
+Usage: `/wtfp:resume-writing`
+
+**`/wtfp:pause-writing`**
+Create context handoff when pausing work mid-section.
+
+- Creates .continue-here file with current state
+- Updates STATE.md session continuity section
+- Captures in-progress work context
+
+Usage: `/wtfp:pause-writing`
+
+### Export & Submission
+
+**`/wtfp:export-latex`**
+Export paper to LaTeX format.
+
+- Generates .tex file from markdown sections
+- Creates references.bib from literature index
+- Applies journal/conference template
+- Outputs to paper/ directory
+
+Usage: `/wtfp:export-latex`
+
+**`/wtfp:submit-milestone <version>`**
+Archive completed submission round.
+
+- Creates MILESTONES.md entry with stats
+- Archives full details to milestones/ directory
+- Prepares workspace for revision round
+
+Usage: `/wtfp:submit-milestone "initial-submission"`
+
+### Issue Management
+
+**`/wtfp:consider-gaps`**
+Review deferred issues and gaps.
+
+- Analyzes all open issues against current draft
+- Identifies resolved issues (can close)
+- Identifies urgent gaps (should address now)
+- Identifies natural fits for upcoming sections
+
+Usage: `/wtfp:consider-gaps`
+
+### Utility Commands
+
+**`/wtfp:help`**
+Show this command reference.
+
+## Files & Structure
+
+```
+.planning/
+├── PROJECT.md            # Paper vision
+├── ROADMAP.md            # Section breakdown
+├── STATE.md              # Writing memory & progress
+├── ISSUES.md             # Deferred enhancements
+├── config.json           # Workflow mode & settings
+├── structure/            # Document structure
+│   ├── argument-map.md   # Claim → Evidence → Conclusion
+│   ├── outline.md        # Section skeleton
+│   └── narrative-arc.md  # Story structure
+├── sources/              # Source materials
+│   ├── literature.md     # Bibliography index
+│   ├── data.md           # Figures, tables, evidence
+│   └── prior-drafts.md   # Existing material to incorporate
+├── grant/                # Grant-specific (if applicable)
+│   ├── specific-aims.md  # Goal hierarchy
+│   ├── budget.md         # Budget structure
+│   └── reviewer-framing.md  # Why fund this
+└── sections/
+    ├── 01-introduction/
+    │   ├── 01-01-PLAN.md
+    │   └── 01-01-SUMMARY.md
+    └── 02-methods/
+        ├── 02-01-PLAN.md
+        └── 02-01-SUMMARY.md
+
+paper/                    # Output files
+├── paper.tex             # LaTeX output
+├── paper.md              # Markdown output
+├── references.bib        # Bibliography
+└── figures/              # Figure files
+```
+
+## Writing Modes
+
+Claude adapts its role per section:
+
+**Co-Author Mode**
+- Claude drafts, you refine
+- Best for: Initial drafts, methods, boilerplate
+
+**Scaffold Mode**
+- Claude outlines, you write
+- Best for: Arguments, results interpretation
+
+**Reviewer Mode**
+- You write, Claude critiques
+- Best for: Abstract, discussion, conclusions
+
+## Verification Layers
+
+**1. Citation Check (Mechanical)**
+- All claims have citations
+- Citations formatted correctly
+- No broken references
+
+**2. Argument Coherence (Logical)**
+- Claims follow from evidence
+- No logical contradictions
+- Flow between paragraphs
+
+**3. Rubric Check (Requirements)**
+- All required sections present
+- Word/page limits met
+- Formatting requirements met
+
+## Common Workflows
+
+**Starting a new paper:**
+
+```
+/wtfp:new-paper
+/wtfp:create-outline
+/wtfp:plan-section 1
+/wtfp:write-section .planning/sections/01-introduction/01-01-PLAN.md
+```
+
+**Resuming work after a break:**
+
+```
+/wtfp:progress  # See where you left off and continue
+```
+
+**Handling reviewer comments:**
+
+```
+/wtfp:import-reviews   # Import reviewer comments
+/wtfp:plan-revision    # Plan fixes
+/wtfp:write-section    # Execute revisions
+/wtfp:respond-reviews  # Generate response doc
+```
+
+## Getting Help
+
+- Read `.planning/PROJECT.md` for paper vision
+- Read `.planning/STATE.md` for current context
+- Check `.planning/ROADMAP.md` for section status
+- Run `/wtfp:progress` to check where you're at
+</reference>

package/commands/wtfp/insert-section.md

@@ -0,0 +1,130 @@
+---
+name: wtfp:insert-section
+description: Insert urgent section between existing sections
+argument-hint: "<after> <description>"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - AskUserQuestion
+---
+
+<objective>
+Insert a new section between existing sections as a decimal phase.
+
+Creates intermediate section (e.g., 3.1 between sections 3 and 4).
+
+Useful for discovered gaps that must be addressed mid-draft.
+
+Maintains section ordering without renumbering.
+</objective>
+
+<process>
+
+<step name="parse">
+**Parse arguments:**
+
+Expect: `<after> <description>`
+- after: Section number to insert after (e.g., 3)
+- description: Brief description of new section
+
+Example: `/wtfp:insert-section 3 "Add methodology validation subsection"`
+</step>
+
+<step name="verify">
+**Verify project exists:**
+
+```bash
+[ ! -f .planning/ROADMAP.md ] && echo "ERROR: No roadmap found. Run /wtfp:create-outline first" && exit 1
+```
+
+Check that "after" section exists in ROADMAP.md.
+</step>
+
+<step name="determine_number">
+**Determine new section number:**
+
+Check for existing decimal sections after the target:
+- If 3.1 doesn't exist → new section is 3.1
+- If 3.1 exists but 3.2 doesn't → new section is 3.2
+- Continue until finding available slot
+</step>
+
+<step name="confirm">
+**Confirm with user:**
+
+Use AskUserQuestion:
+- header: "Insert Section"
+- question: "Insert Section [X.Y]: [description] after Section [X]?"
+- options:
+  - "Yes, create it" — Insert the section
+  - "Different position" — Let me specify another location
+  - "Cancel" — Don't insert
+
+</step>
+
+<step name="create">
+**Create section:**
+
+1. Create directory:
+```bash
+mkdir -p ".planning/sections/[XX.Y]-[section-name-slug]"
+```
+
+2. Update ROADMAP.md:
+- Insert new section entry after section [X]
+- Include goal, word target, status
+
+3. Update STATE.md if needed.
+
+</step>
+
+<step name="commit">
+```bash
+git add .planning/ROADMAP.md .planning/sections/
+git commit -m "$(cat <<'EOF'
+docs: insert Section [X.Y] - [name]
+
+[Description]
+
+Inserted between Section [X] and Section [X+1]
+EOF
+)"
+```
+
+</step>
+
+<step name="done">
+**Present completion:**
+
+```
+Section inserted:
+
+- Section [X.Y]: [Name]
+- Directory: .planning/sections/[XX.Y]-[name]/
+- ROADMAP.md updated
+
+---
+
+## ▶ Next Up
+
+**Plan new section** — create writing plan
+
+`/wtfp:plan-section [X.Y]`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] New section number determined (no conflicts)
+- [ ] Directory created
+- [ ] ROADMAP.md updated with new section
+- [ ] Ordering preserved
+- [ ] Committed to git
+</success_criteria>

package/commands/wtfp/list-assumptions.md

@@ -0,0 +1,109 @@
+---
+name: wtfp:list-assumptions
+description: See what Claude is planning to write before it starts
+argument-hint: "[section]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+<objective>
+Show Claude's intended approach for a section before planning begins.
+
+Lets you course-correct if Claude misunderstood your vision.
+
+No files created - conversational output only.
+</objective>
+
+<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 all relevant context:**
+
+- Read PROJECT.md for paper vision
+- Read ROADMAP.md for section goal
+- Read argument-map.md for relevant claims
+- Read outline.md for structure expectations
+- Read narrative-arc.md for story context
+- Read any prior SUMMARY.md files
+- Check for CONTEXT.md or RESEARCH.md in section directory
+</step>
+
+<step name="present">
+**Present assumptions in 5 areas:**
+
+```
+# Assumptions for Section [N]: [Name]
+
+## 1. Content Approach
+Based on the section goal and argument map, I plan to:
+- [Main point 1]
+- [Main point 2]
+- [Main point 3]
+
+Key claims I'll develop:
+- [Claim from argument-map]
+- [Claim from argument-map]
+
+## 2. Structure
+I'm planning to organize this section as:
+1. [Opening approach]
+2. [Body structure]
+3. [Closing approach]
+
+Word allocation:
+- [Part 1]: ~[X] words
+- [Part 2]: ~[Y] words
+- [Part 3]: ~[Z] words
+
+## 3. Writing Mode
+Based on the section type, I recommend:
+- Mode: [Co-Author/Scaffold/Reviewer]
+- Reason: [Why this mode fits]
+
+## 4. Dependencies
+This section relies on:
+- Prior sections: [What must be established first]
+- Citations needed: [Key references]
+- Evidence: [Data/figures to reference]
+
+This section sets up:
+- Following sections: [What this enables]
+
+## 5. Potential Challenges
+I anticipate:
+- [Challenge 1]: [How I'd address it]
+- [Challenge 2]: [How I'd address it]
+
+## Questions for You
+- [Any clarifications needed]
+- [Decisions that need your input]
+
+---
+
+**Does this match your vision?**
+- If yes: Run `/wtfp:plan-section [section]`
+- If concerns: Tell me what to adjust
+- If major changes: Run `/wtfp:discuss-section [section]`
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] All 5 assumption areas covered
+- [ ] Based on actual project context
+- [ ] Clear path to course-correct
+- [ ] No files created (conversational only)
+</success_criteria>