# Planning With Files

> Creates and maintains persistent markdown planning files that survive session resets by hooking into Claude Code's lifecycle.

- Skill: `samyakjhaveri/planning-with-files` (Agent Skill)
- Install (CLI): `npx skillmds add samyakjhaveri/planning-with-files`
- Raw SKILL.md: https://api.skillmd.com/api/skills/samyakjhaveri/planning-with-files/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Tags: Claude Code, Hooks, Markdown, Planning, Task Management
- Author: SamyakJhaveri (https://skillmd.com/u/samyakjhaveri)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/samyakjhaveri/planning-with-files

---


# planning-with-files

Persistent markdown planning files that survive `/compact` via hook-based re-injection. Creates and maintains `task_plan.md`, `findings.md`, and `progress.md` for cross-session persistence.

**Upstream:** https://github.com/othmanadi/planning-with-files

## Install

> Install commands are from upstream documentation and may change. Check the [upstream repo](https://github.com/othmanadi/planning-with-files) for current instructions.

```bash
npx skills add planning-with-files
```

Or clone the repo and symlink into your project's `.claude/skills/`.

## What It Does

1. Creates structured planning files at project root
2. Hooks into Claude Code lifecycle to re-inject plan context after `/compact`
3. Maintains progress tracking across sessions

## Overlap Warning

This tool **heavily overlaps** with Loam's built-in planning infrastructure:

| planning-with-files | Loam equivalent |
|---|---|
| `task_plan.md` | Plan mode + `docs/plans/` |
| `findings.md` | Memory system + `.claude/rules/` |
| `progress.md` | `/handoff` skill |
| Hook re-injection | Always-loaded rules |

Install only if you prefer file-based planning over Loam's built-in approach. The two systems may conflict if used simultaneously.

## Requirements

- Node.js
- Bash or PowerShell

## Notes

- MIT license
- Novel piece is hook-based re-injection after `/compact`
- Near-zero independent reviews despite popularity