CONTRIBUTORS.md
Thank you to everyone who has contributed to making planning-with-files better!
These amazing people have contributed code, documentation, or significant improvements to the project:
/clearsession-catchup.py script to analyze previous session JSONL files.kilocode/rules/ configuration[[, &>) with POSIX constructsuname -s/bin/sh.continue/skills/ and .continue/prompts/ structuredocs/continue.md installation guide.codebuddy/skills/ folder with full skill structuredocs/codebuddy.md installation guide@EListenX (Yi Chenxi) - PR #112
.kiro/skills/planning-with-files/#[[file:]] live references.kiro/scripts/ and .kiro/steering/ with proper Agent Skill layout.github/hooks/planning-with-files.json with full hook scripts in .github/hooks/scripts/docs/copilot.md installation guide.planning/{uuid}/ plan sessions with UUID generation and PLAN_ID pinning@mvanhorn (Matt Van Horn) - PR #115
--template analytics flag on init-session.sh and init-session.ps1analytics_task_plan.md with 4 analytics-specific phases (Data Discovery, Exploratory Analysis, Hypothesis Testing, Synthesis)analytics_findings.md with Data Sources table, Hypothesis Log, Query Results, and Statistical Findings sectionsprogress.md with Query Log replacing Test Results@ebrevdo (Eugene Brevdo) - PR #124
session-catchup.py to support Codex rollout JSONL session formatCODEX_THREAD_ID preference, subagent/tiny session filtering, and structured patch_apply_end event detectionplanning-with-files skill, and /plan plus /plan-status command wrappers.hermes/skills/planning-with-files/ and resolved them through the active profile's HERMES_HOME'---BEGIN PLAN DATA---' and '---END PLAN DATA---' plan-injection delimiters embedded in hook commands collided with the --- YAML document separator; Claude Code's skill-discovery loader split frontmatter on the literal --- substring and truncated the description mid-string===BEGIN PLAN DATA=== / ===END PLAN DATA=== across the canonical SKILL.md, all five language variants, the .codebuddy/.codex/.cursor adapter mirrors, and the clawhub-upload bundle. Same model-side framing semantics, no collision with the YAML separator@oaabahussain - Issue #150, Issue #151
task_plan.md between user approval and hook injection trips a verifiable check/plan-attest, attest-plan.sh/.ps1, bump-version.py, and two new test files that turn both report classes into things that fail the build instead of shipping silently@xiaolai - PR #137, PR #138, PR #139, Issue #140
session-start.sh, pre-tool-use.sh, and error-occurred.shtask_plan.md presenceuser-prompt-submit.sh, pre_tool_use.py, and stop.py, and proposed the session attachment model as a fix direction$PWF_SESSION_ID + sentinel file isolation, backward-compatible upgrade path, and 5 new targeted testsdocs/hermes.md now has an Integration Notes section that sets accurate expectations for Hermes adopterstask_plan.md at the project root, removing the placement flexibility that CLAUDE.md conventions had previously allowedYYYY-MM-DD-<slug>/ naming convention as a human-readable alternative to the UUID approach in experimental/isolated-planninginit-session.sh, set-active-plan.sh, resolve-plan-dir.sh, and the full Codex hook resolver wire-up all trace back to this report@Leon-Algo - PR #119, PR #120, PR #122
.codex skill install, fixing Codex installer breakage (PR #119)check-complete.sh and init-session.sh with regression test (PR #122)allowed-tools YAML list (invalid per Anthropic skill spec, silently killing discoverability)metadata.version placement and added trigger terms for better skill matching/plan:status command for quick planning progress display without reading through all planning files@codelyc - PR #66, PR #70, PR #76
/planning-with-files:start command, enabling skill activation without copying files manuallycheck-complete.ps1 completely failing on PowerShell 5.1 due to special character parse errors in double-quoted strings; switched to single-quoted strings with concatenation across all 12 platform copies (PR #88)Copilot SWE Agent - PR #16
assets field to ensure templates copy to cache@tt-a1i - PR #92, PR #99, PR #100
notes.md references replaced with findings.md across all 16 IDE copies, OpenCode support label corrected in README, --help in sync-ide-folders.py no longer runs a sync (PR #99)@Emin017 (Qiming Chu) - PR #145
/bin/bash to /usr/bin/env bash across hook scripts/bin/bash.pi adapter up to full hook parity with Claude Code by shipping a bundled TypeScript extension under .pi/skills/planning-with-files/extensions/planning-with-files/session_start runs session catchup, before_agent_start injects plan context, tool_call adds pre-tool recitation, tool_result appends the post-write reminder, agent_end auto-continues incomplete plans with a per-session+plan limit of three, session_before_compact flushes the plan reminder with the active Plan-SHA256, session_shutdown clears loop timers and per-session state, input resets the auto-continue counterauto, parity, cache-safe, notify) with DeepSeek auto-detection from ctx.model.provider and ctx.model.id, so cache-prefix-sensitive models keep their KV-cache stable.attestation file locks the plan across both Claude Code and Pi/plan-status, /plan-attest, /plan-goal, /plan-loop) mirroring their Claude Code counterpartsset-active-plan.sh/resolve-plan-dir.sh/attest-plan.sh and the parallel task workflow, and the "Write web content to task_plan.md" anti-pattern row. Renamed the npm package from the unscoped pi-planning-with-files to @tomxprime/planning-with-files, matching the package author's npm namespace. Rewrote the install docs to point at the scoped package and to use pi install ./.pi/skills/planning-with-files (local path) for manual installs. Removed the redundant manual session-catchup instruction since the Pi extension handles that lifecycle event automaticallydocs/codex.md instructed users to set codex_hooks = true in ~/.codex/config.toml, while OpenAI's current Codex hooks docs (developers.openai.com/codex/hooks) now make hooks the canonical key and codex_hooks a deprecated aliashooks = true in four sites with an alias note, so new users get the canonical key while users on older configs are not pushed to migrateThese developers have created forks that extend the functionality:
@RioTheGreat-ai - agentfund-skill
@kmichels - multi-manus-planning
Thank you to everyone who reported issues, provided feedback, and helped test fixes:
And many others who have starred, forked, and shared this project!
skills/planning-with-files/scripts/init-session.sh was not updated when slug mode shipped in v2.36.0, meaning users installing via npx or IDE folders silently received the old scriptsync-ide-folders.py tool, and added a byte-comparison regression test plus a --verify CI assertion to prevent recurrenceWe welcome contributions! Here's how you can help:
See our repository for more details.
If you've contributed and don't see your name here, please open an issue! We want to recognize everyone who helps make this project better.
Total Contributors: 40+ and growing!
Last updated: May 22, 2026