Home/Skills/planning-with-files

planning-with-files

This skill implements a file-based planning system for complex, multi-step tasks by creating persistent markdown files to track goals, findings, and progress. It acts as an external working memory to maintain context and organization throughout long workflows or research projects.

Download for Windows

Files

hooks/pre-tool-use.ps1

# planning-with-files: Pre-tool-use hook for Cursor (PowerShell)
# Reads the first 30 lines of task_plan.md to keep goals in context.
# Returns {"decision": "allow"} — this hook never blocks tools.

$PlanFile = "task_plan.md"

if (Test-Path $PlanFile) {
    Get-Content $PlanFile -TotalCount 30 | Write-Host
}

Write-Output '{"decision": "allow"}'
exit 0