Add prose augmentation command and refine .claude/ gitignore #1

Closed

xrisk wants to merge 2 commits from claude/augment-prose-skill-9xzC7 into master

xrisk commented

2026-05-07 09:48:55 +00:00

(Migrated from github.com)

Summary

This PR introduces a new Claude command for augmenting prose files with TODO blocks, and updates the gitignore configuration to selectively track the commands directory while excluding other local settings.

Key Changes

New command: augment-prose — Adds a documented command that reads a prose file and inserts actionable TODO blocks based on editorial guidance. The command:
- Parses file path and editorial instructions from arguments
- Walks through prose section-by-section, identifying where expansion, citation, or development would strengthen the writing
- Inserts LaTeX-formatted TODO blocks at paragraph/section boundaries with specific, concrete action items
- Preserves all original prose verbatim, never altering existing text
Updated .gitignore — Refines the exclusion pattern for .claude/ to:
- Exclude all local machine-specific settings by default (.*)
- Explicitly track the commands/ subdirectory for deployment (!.claude/commands/)
- Clarifies intent with an inline comment

Implementation Details

The augment-prose command is designed as a structured workflow for writers and editors. It emphasizes:

Concrete, actionable guidance (naming references, describing specific details)
Non-invasive augmentation (original prose remains untouched)
Natural placement of TODO blocks at logical boundaries
Flexibility to apply guidance to multiple locations where relevant

https://claude.ai/code/session_01U78NMmtz3hSfLfPYVoyjKi

## Summary This PR introduces a new Claude command for augmenting prose files with TODO blocks, and updates the gitignore configuration to selectively track the commands directory while excluding other local settings. ## Key Changes - **New command: `augment-prose`** — Adds a documented command that reads a prose file and inserts actionable TODO blocks based on editorial guidance. The command: - Parses file path and editorial instructions from arguments - Walks through prose section-by-section, identifying where expansion, citation, or development would strengthen the writing - Inserts LaTeX-formatted TODO blocks at paragraph/section boundaries with specific, concrete action items - Preserves all original prose verbatim, never altering existing text - **Updated `.gitignore`** — Refines the exclusion pattern for `.claude/` to: - Exclude all local machine-specific settings by default (`.*`) - Explicitly track the `commands/` subdirectory for deployment (`!.claude/commands/`) - Clarifies intent with an inline comment ## Implementation Details The `augment-prose` command is designed as a structured workflow for writers and editors. It emphasizes: - Concrete, actionable guidance (naming references, describing specific details) - Non-invasive augmentation (original prose remains untouched) - Natural placement of TODO blocks at logical boundaries - Flexibility to apply guidance to multiple locations where relevant https://claude.ai/code/session_01U78NMmtz3hSfLfPYVoyjKi