Commit Graph
47 Commits
Author SHA1 Message Date
OthmanAdi 577a1c59b4 release: v2.43.0 (CONTRIBUTING.md + OpenCode docs fix + .continue/.gemini/.kiro variant sync) 2026-05-26 10:47:25 +02:00
carterusedulm2-maker c5afda4a80 docs: add Topic Handoff Pattern guidelines 2026-05-25 11:37:52 +02:00
CleanFix-Dev 450d3d45f1 docs: document attestation lock fallback (#168) 2026-05-24 13:52:46 +02:00
OthmanAdi 27ef36cd3b release: v2.39.0 (Pi full hook parity extension + Codex hooks flag fix)
Adds a bundled TypeScript extension under .pi/skills/planning-with-files/extensions/planning-with-files/
that maps Pi lifecycle events onto the same behavior the skill provides on Claude Code (PR #157 by
@TomXPRIME). Event surface: session_start, before_agent_start, tool_call, tool_result, agent_end,
session_before_compact, session_shutdown, input. Four modes: auto (DeepSeek-aware), parity,
cache-safe, notify. Attestation gate shares the v2.37 .attestation file. Four slash commands
registered (/plan-status, /plan-attest, /plan-goal, /plan-loop). 12 new contract tests.

Fixes docs/codex.md to use the canonical [features] hooks = true key (Issue #154 by @DLI1996),
with a deprecated-alias note so users on older configs keep working.

Version bumped to 2.39.0 across 14 SKILL.md variants, plugin.json, marketplace.json, CITATION.cff
via scripts/bump-version.py. .pi npm scheme bumped 1.0.1 -> 1.1.0 for the extension surface.
.continue, .gemini, .kiro lag intentionally.

Tests: 110 pass, 2 pre-existing Windows exec-bit failures unrelated to this release.
2026-05-21 21:33:16 +02:00
OthmanAdi 9bf31fc41e release: v2.36.0 (parallel plan isolation + Codex session isolation + Hermes docs)
Closes #146, #147, #148.

Parallel plan isolation (#148, @shawnli1874): init-session.sh slug mode
creates .planning/YYYY-MM-DD-<slug>/ for each task. set-active-plan.sh/.ps1
switch the active plan pointer. resolve-plan-dir.sh/.ps1 provide the
resolution chain ($PLAN_ID env, .active_plan file, newest plan dir, legacy
fallback). All four Codex hooks route through the resolver. resolve_latest_dir
now requires task_plan.md to be present, preventing system dirs like sessions/
from being selected as plan dirs. short_uuid() probes each Python candidate
before trusting command -v, fixing silent failure on Windows Store aliases.

Codex session isolation (#146, @githubYiheng): sessions attach to a plan by
creating .planning/sessions/<session_id>.attached. user-prompt-submit.sh,
pre_tool_use.py, stop.py, and post_tool_use.py all gate on session attachment
before injecting context or blocking. Legacy mode preserved when
.planning/sessions/ does not exist.

Hermes integration notes (#147, @09ashishkapoor): docs/hermes.md gains an
Integration Notes section covering current support level, what is not full
parity with hook-native platforms, recommended integration pattern, and a
tradeoffs table.

34 new tests across five files. Version bumped to 2.36.0 across 14 SKILL.md
variants, plugin.json, marketplace.json, and CITATION.cff.
2026-05-01 18:37:25 +02:00
bailob 2b358172f4 feat: add Hermes adapter for planning-with-files (#136)
* feat: add Hermes adapter for planning-with-files

- add a Hermes project plugin with planning tools, status parsing, and reminder hooks
- add Hermes-specific skill and command wrappers while keeping the workflow close to upstream
- document generic Hermes installation and cover the adapter with focused unit tests

* fix: bundle Hermes skill assets and paths
2026-04-21 15:47:38 +02:00
OthmanAdi fcf0522291 fix: correct openclaw.md install paths — .openclaw/ dir never existed, use clawhub-upload/ source 2026-04-15 21:09:37 +02:00
OthmanAdi 6aa4276926 release: v2.34.0 — Codex hooks restored, spring cleaning, contributors updated
Restores .codex/hooks.json and .codex/hooks/ scripts that were wiped when
master was rewritten during v2.32.0 (closes #132, original work by @Leon-Algo
in PR #120). Codex users now have full lifecycle hook parity with Claude Code,
Cursor, and Copilot: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse,
and Stop hooks all active.

Also includes:
- Tessl skill-review CI from PR #131 (@popey)
- Exec bit fix from PR #122 (@Leon-Algo) + regression test
- Duplicate metadata.version key fixed in .codebuddy, .cursor, .mastracode,
  .opencode, and .codex SKILL.md files
- docs/codex.md rewritten to cover hooks installation and protocol
- CONTRIBUTORS.md: added @Leon-Algo, @YSAA1, @kevinaimonster, @wd041216-bit;
  updated @lasmarois entry to include PR #37; total now 32+
- Version bumped to 2.34.0 across all 17 SKILL.md variants, plugin.json,
  marketplace.json, and CITATION.cff
2026-04-15 20:57:07 +02:00
OthmanAdi 6dc9e3f44a feat(kiro): add Agent Skill layout under .kiro/skills/ (#112)
Adds full Kiro Agent Skill support with proper .kiro/skills/ layout,
bootstrap scripts, steering integration, and planning templates.
Replaces the old .kiro/scripts/ and .kiro/steering/ approach.
Also updates docs/kiro.md and sync-ide-folders.py skip list.

Contributed by Yi Chenxi (@EListenX)
2026-03-20 23:19:32 +01:00
v-yichenxi 402d929564 feat(kiro): add Kiro Agent Skill and align Mastra/Cursor hooks (v2.23.1)
IDE hook follow-up (v2.23.0 gaps):

- Mastra Code: hooks.json is the hook source — add UserPromptSubmit, refresh PostToolUse.
- Cursor: .cursor/hooks/ — add user-prompt-submit, update post-tool-use and stop scripts.

Kiro workspace skill:

- Add .kiro/skills/planning-with-files/ (SKILL.md, references, templates, scripts).
- Bootstrap creates .kiro/plan and auto steering planning-context.md (#[[file:]]).
- Add session-catchup.py; check-complete/bootstrap for sh and PowerShell.
- Remove duplicate .kiro/scripts and always-on steering; sync script skips .kiro.
- Update docs/kiro.md and README (Kiro = Agent Skill + Steering).
2026-03-20 11:40:00 +08:00
OthmanAdi bd8602d851 fix: bump version references to v2.26.0 (v2.24.0 and v2.25.0 already taken) 2026-03-20 00:56:40 +01:00
OthmanAdi ab7d76121d feat: IDE audit — Gemini/Factory/Copilot hooks, consolidate 4 redundant IDEs
v2.24.0 — Full IDE support audit and cleanup:

New features:
- Gemini CLI: add hooks (settings.json + 5 scripts: SessionStart, BeforeTool,
  AfterTool, BeforeModel, SessionEnd). BeforeModel is unique to Gemini — injects
  plan awareness before every model call.
- FactoryAI Droid: add hooks to SKILL.md frontmatter (was skills-only, now has
  all 4 lifecycle events) + add scripts.
- GitHub Copilot: add errorOccurred hook for automatic error logging to plan.

Bug fixes:
- Continue: fix .prompt file — was entirely in Chinese, now English
- Pi Agent: fix package.json repo URL (was ttttmr/, now OthmanAdi/)
- Mastra Code: sync drifted check-complete.sh and session-catchup.py to canonical
- CodeBuddy/Codex: remove duplicate assets/templates/ directories

Consolidation:
- Remove .adal/, .agent/ (Antigravity), .kilocode/, .openclaw/ directories.
  These IDEs implement the standard Agent Skills spec with no hooks — install
  via `npx skills add` which handles IDE-specific placement automatically.
- README: restructure IDE table into Enhanced (hooks) vs Standard (Agent Skills)
- sync-ide-folders.py: remove entries for consolidated IDEs

Net: -4,609 lines (removed duplication, added real value)
2026-03-20 00:53:33 +01:00
OthmanAdi 09ee8e4ec6 fix: session catchup, progress tracking, and post-completion workflow (v2.23.0)
Fixes #106. Three root causes identified and fixed:

1. Session catchup not working after /clear: Added UserPromptSubmit hook
   to all 7 IDE SKILL.md files. When task_plan.md exists, injects a
   directive to read all planning files before proceeding. Fires on every
   user message, ensuring context recovery after /clear or compaction.

2. Progress not updating consistently: PostToolUse hook message now leads
   with "Update progress.md" instead of only mentioning task_plan.md.
   Added plan existence guard to avoid noise when no plan is active.

3. Post-plan additions not tracked: check-complete scripts now output
   re-entry guidance when all phases are complete. Copilot agent-stop
   scripts now return continuation context instead of empty JSON.
   Added Critical Rule #7 (Continue After Completion) to SKILL.md body.

Applied across: 7 IDE SKILL.md files, 16 synced check-complete scripts,
4 Copilot hook scripts, CHANGELOG, plugin.json, marketplace.json.
2026-03-16 00:08:20 +01:00
OthmanAdi 7b55095bce docs: polish evals.md wording 2026-03-06 18:20:36 +01:00
OthmanAdi 6ecbe15838 docs: add real timing and token metrics to evals.md
Captured from task completion notifications during the eval run.
with_skill avg: 19,926 tokens / 115s
without_skill avg: 11,899 tokens / 98s
+68% tokens, +17% time — the cost of structured 3-file output.
2026-03-06 09:09:19 +01:00
OthmanAdi ade3ecec9f docs: add formal benchmark results, article, and README verification badges (v2.22.0)
Evaluated planning-with-files using Anthropic's skill-creator framework:
- 10 parallel subagents (5 with_skill + 5 without_skill), 5 task types
- 30 objectively verifiable assertions
- with_skill: 96.7% pass rate (29/30) vs 6.7% (2/30) without_skill
- 3 blind A/B comparisons: with_skill wins 3/3, avg 10.0/10 vs 6.8/10

Also documents the v2.21.0 security fix (WebFetch/WebSearch removed from
allowed-tools, Security Boundary section added) with full technical context
on why the PreToolUse hook created an indirect prompt injection amplification
vector and how the fix resolves it.

Added:
- docs/evals.md: full methodology, assertions, results, benchmark data
- docs/article.md: technical write-up for publication
- README.md: Benchmark Results section + 3 verification badges
- CHANGELOG.md: v2.22.0 entry
2026-03-06 09:06:44 +01:00
tt-a1i dbfe812adc Fix docs links and sync tooling consistency 2026-03-04 10:12:13 +08:00
OthmanAdi acfd2f0c74 fix(mastra): add hooks.json, fix SKILL.md path var, correct docs
Mastra Code reads hooks from .mastracode/hooks.json, not SKILL.md
frontmatter. All three hooks (PreToolUse, PostToolUse, Stop) were
silently non-functional. Added hooks.json with proper Mastra format
including matchers and timeouts. Fixed MASTRACODE_SKILL_ROOT env var
(does not exist in Mastra Code). Corrected docs/mastra.md to accurately
describe the hooks.json system and fixed personal install instructions
to include the hooks file.
2026-02-26 19:43:46 +01:00
OthmanAdi 6e8f128a79 feat: BoxLite sandbox runtime integration (Issue #84)
Adds documentation and examples for running planning-with-files
inside BoxLite micro-VM sandboxes via ClaudeBox.

- docs/boxlite.md: full integration guide covering ClaudeBox Skill
  API, persistent sessions, hooks behavior inside the VM, snapshots,
  session recovery, and troubleshooting
- examples/boxlite/quickstart.py: working Python example using
  ClaudeBox's Skill object to inject planning-with-files into a VM
- examples/boxlite/README.md: example context and requirements
- README: new Sandbox Runtimes section (BoxLite is infrastructure,
  not an IDE - kept separate from the 16-platform IDE table)
- README: BoxLite badge, Documentation table entry, version bump
  to 2.18.0, file structure updated
- CHANGELOG: v2.18.0 entry with full details
- CONTRIBUTORS: @DorianZheng added for Issue #84

BoxLite loads via pip install claudebox - no .boxlite/ folder needed
since ClaudeBox uses a Python Skill object, not file-system discovery.

Closes #84
2026-02-26 18:45:54 +01:00
OthmanAdi a8ce293833 feat: add Mastra Code support (platform #16)
- Created .mastracode/skills/planning-with-files/ with full hooks integration
  (PreToolUse, PostToolUse, Stop — native Mastra Code hook support)
- SKILL.md ships with PR #83 fixes pre-applied: comma-separated allowed-tools,
  metadata.version in standard location, enriched trigger terms
- Includes references, scripts (cross-platform), and templates
- Added docs/mastra.md installation guide (workspace + personal methods)
- Updated README: IDE table, badge, file structure, docs table, platform count
2026-02-25 20:28:49 +01:00
Lin Wan d69eda6b31 create github copilot plugin 2026-02-22 15:03:55 +01:00
OthmanAdi 0c1ddd21c3 Fix OpenCode compatibility - detect IDE and show helpful message
OpenCode uses different session storage (.json at ~/.local/share/opencode/) than Claude Code (.jsonl at ~/.claude/projects/). Session catchup now detects the IDE and provides a clear workaround message instead of silently failing.

- Added IDE detection (checks env vars and directory structure)
- OpenCode users get helpful message to manually read planning files
- Claude Code functionality unchanged
- Updated OpenCode docs with known limitations section

Fixes #74
2026-02-08 16:05:59 +01:00
OthmanAdi 0361bf17c4 Fix IDE-specific path references in SKILL.md files
- OpenCode: Replace CLAUDE_PLUGIN_ROOT with OPENCODE_SKILL_ROOT
- Kilocode: Replace CLAUDE_PLUGIN_ROOT with KILOCODE_SKILL_ROOT
- Cursor: Replace CLAUDE_PLUGIN_ROOT with CURSOR_SKILL_ROOT
- Update docs/opencode.md with oh-my-opencode configuration guide
- Add troubleshooting section for skill loading conflicts

Fixes #73
2026-02-06 15:10:12 +01:00
codelyc 7082c7f41f fix: update codebuddy paths and codex usage docs
Change-Id: I28fb0e5f6a88427370ff1bd079c4951311be5815
2026-02-05 10:59:44 +08:00
OthmanAdi 0b033eb025 Add Cursor hooks support — preToolUse, postToolUse, stop (fixes #61)
Cursor now supports hooks natively via .cursor/hooks.json. Added:
- hooks.json config with preToolUse, postToolUse, and stop hooks
- Hook scripts in bash (.sh) and PowerShell (.ps1)
- hooks.windows.json for native PowerShell users
- Rewrote docs/cursor.md — removed "hooks don't work" limitation,
  documented full hook support including auto-continuation via stop hook
- Updated README Cursor format from "Skills" to "Skills + Hooks"

The stop hook is the highlight: it checks task_plan.md completion and
uses Cursor's followup_message to auto-continue the agent if phases
are incomplete (capped at 3 retries via loop_limit).

Thanks to @sulsDotK for reporting that Cursor now supports hooks.
2026-02-04 22:03:37 +01:00
OthmanAdi b96b42a9e5 Fix stop hook error, docs inconsistency, add Plan Cascade (fixes #68, #69)
- check-complete.sh/.ps1: Always exit 0 — incomplete task is a normal
  state, not an error. Uses stdout for informational status reporting.
  Fixes stop hook error in Claude Code. (#68)
- README.md, docs/quickstart.md: Clarify that the AI creates planning
  files (not the user manually). Align all docs on workflow. (#69)
- README.md: Add Plan Cascade by @Taoidle to Community Forks (#63)
- Updated all 21 check-complete script copies across IDE folders
2026-02-04 21:30:07 +01:00
OthmanAdi 16fd096f4f Fix check-complete scripts and kilocode docs (fixes #45, #62)
- check-complete.sh/.ps1: Add fallback for [complete] inline bracket
  status format in addition to existing **Status:** bold format
- Updated all 21 script copies across IDE folders
- docs/kilocode.md: Remove all references to non-existent
  .kilocode/rules/ directory (migrated to skills/ in v2.10.0)
- README.md: Update Kilo Code section to reference .kilocode/skills/
2026-02-04 21:22:53 +01:00
Ahmad Othman Ammar Adi. b8274d23f8 Merge pull request #67 from ttttmr/master
Add Pi Agent support
2026-02-04 17:44:48 +01:00
ttttmr 1089d65c60 Add Pi Agent support 2026-02-04 19:26:21 +08:00
TH33_ORACL3andCursor 28e89aae11 docs: rename moltbot.md to openclaw.md
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-03 19:21:37 +02:00
TH33_ORACL3andCursor cbf393a516 docs: update moltbot.md to use OpenClaw naming and paths
The product has been renamed from Moltbot to OpenClaw. This commit updates:

- Title and website link (molt.bot → openclaw.ai)
- Skills directory paths (~/.clawdbot/ → ~/.openclaw/)
- Config file path (moltbot.json → openclaw.json)
- CLI commands (moltbot → openclaw)
- All references to the product name

Fixes #64

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-03 19:20:33 +02:00
OthmanAdi 92915d58ac Rebrand Clawd CLI to Moltbot (v2.13.0)
- Renamed .clawd/ to .moltbot/
- Renamed docs/clawd.md to docs/moltbot.md
- Updated all references: Clawd CLI → Moltbot
- Updated URLs: clawd.bot → molt.bot
- Updated CLI commands: clawdbot → moltbot
- Updated README badges, IDE table, documentation links
- Updated CHANGELOG
2026-01-27 22:21:41 +01:00
OthmanAdi a917aa1482 Fix AdaL SKILL.md format and update docs
- Simplified SKILL.md to match AdaL format (name + description only)
- Added /plugin marketplace installation method to docs/adal.md
- Added /skills and /plugin command documentation
- Fixed script paths in docs
- Added ZWkang to CONTRIBUTORS.md for CodeBuddy PR #60
2026-01-27 22:00:17 +01:00
OthmanAdi 76e954bc47 Add AdaL CLI / Sylph AI support (v2.12.0)
- Added .adal/skills/planning-with-files/ folder with full skill structure
- Created SKILL.md, templates, scripts, and references for AdaL
- Added docs/adal.md installation guide
- Updated README.md with AdaL in supported IDEs table
- Added AdaL CLI badge
2026-01-27 21:57:17 +01:00
kang f973f64864 Add CodeBuddy integration with planning-with-files skill (#60)
Thanks @ZWkang for this quality contribution! 🎉

Great work on:
- Full CodeBuddy integration with proper skill format
- Cross-platform scripts (Windows + Unix)
- Comprehensive documentation
- Clean, well-organized code

Welcome to the planning-with-files contributors! 🙌
2026-01-27 21:41:52 +01:00
OthmanAdi 539d5a3bbc Add Kiro support with native steering files (v2.10.0)
- Add .kiro/steering/ with planning-workflow.md, planning-rules.md, planning-templates.md
- Add .kiro/scripts/ with init and check-complete scripts
- Add docs/kiro.md installation guide
- Update README with Kiro badge and documentation
- Update plugin.json with Kiro keywords
- Now supports 11+ AI coding assistants

Closes #55
2026-01-26 01:40:15 +01:00
OthmanAdi 28c255f774 Add Clawd CLI support (v2.9.0)
- Add .clawd/skills/planning-with-files/ skill bundle
- Add docs/clawd.md installation guide
- Update README with Clawd badge and documentation
- Update plugin.json with new keywords for discoverability
- Update all SKILL.md versions to 2.9.0
- Now supports 10+ AI coding assistants
2026-01-26 01:14:37 +01:00
mannaxu 4271a5425b Add Continue integration (skills + prompt)
- Add .continue/skills planning-with-files bundle

- Add .continue/prompts slash command (.prompt Markdown)

- Add docs/continue.md and README entry

- Add scripts/check-continue.sh validator
2026-01-24 01:55:49 +08:00
OthmanAdi a210eb6b4f Add Gemini CLI support (v2.7.0)
- Added .gemini/skills/planning-with-files/ with full skill structure
- Created SKILL.md formatted for Gemini CLI Agent Skills
- Included templates, scripts, and references
- Added docs/gemini.md installation guide
- Updated README with Gemini CLI in supported IDEs
- Added Gemini CLI badge

Closes #52
2026-01-22 14:33:09 +01:00
OthmanAdi cd0fc7c915 Add Antigravity IDE support
- Created .agent/skills/planning-with-files/ directory structure
- Added SKILL.md following Agent Skills Specification
- Copied templates to references/ folder (Antigravity convention)
- Copied references.md and examples.md for documentation
- Created comprehensive docs/antigravity.md installation guide
- Added Antigravity to README.md supported IDEs table
- Closes #40
2026-01-20 17:36:42 +01:00
OthmanAdiandClaude Sonnet 4.5 97a85b6272 Add FactoryAI Droid support
- Created .factory/skills/planning-with-files/ directory structure
- Added SKILL.md with Factory-compatible format (name, description only)
- Copied templates (task_plan.md, findings.md, progress.md)
- Copied references.md and examples.md for documentation
- Created comprehensive docs/factory.md installation guide
- Added FactoryAI Droid to README.md supported IDEs table
- Closes #44

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-20 12:31:53 +01:00
OthmanAdiandClaude Sonnet 4.5 4f2586691a Update documentation for Codex and OpenCode support
- Added Codex and OpenCode to IDE support table
- Updated file structure diagram
- Added documentation links
- Updated installation guide with new IDE sections

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 22:55:19 +01:00
OthmanAdiandClaude Sonnet 4.5 1844bbb90f Add OpenCode IDE support with real installation guide
- Created .opencode/INSTALL.md with installation instructions
- Global: ~/.config/opencode/skills/planning-with-files/
- Project: .opencode/skills/planning-with-files/
- Works with obra/superpowers plugin or standalone
- oh-my-opencode compatibility documented
- Added docs/opencode.md for user documentation

Based on analysis of obra/superpowers OpenCode plugin

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 22:55:14 +01:00
OthmanAdiandClaude Sonnet 4.5 ab10960a4b Add Codex IDE support with real installation guide
- Created .codex/INSTALL.md with installation instructions
- Skills install to ~/.codex/skills/planning-with-files/
- Works with obra/superpowers or standalone
- Added docs/codex.md for user documentation

Based on analysis of obra/superpowers Codex implementation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 22:55:09 +01:00
aisheng.yu 3acf5e4879 Add Kilocode support and documentation
- Add .kilocode/rules/planning-with-files.md with planning rules
- Update .gitignore for Kilocode patterns
- Add docs/kilocode.md documentation
- Update CHANGELOG.md with Kilocode support entry
- Update README.md with Kilocode integration
- Update SKILL.md files in planning-with-files and skills directories
- Add PowerShell scripts (check-complete.ps1, init-session.ps1)
2026-01-16 06:57:34 +00:00
OthmanAdiandClaude Opus 4.5 dcb92c0a64 fix: add root-level templates/scripts for CLAUDE_PLUGIN_ROOT resolution (v2.1.2)
Fixes #18 - Templates not found in cache after update

Root cause: ${CLAUDE_PLUGIN_ROOT} resolves to repo root, but templates
were only in subfolders (planning-with-files/ and skills/planning-with-files/).

Solution: Added templates/ and scripts/ at repo root level so they're
accessible regardless of how CLAUDE_PLUGIN_ROOT resolves.

Changes:
- Add templates/ directory at repo root
- Add scripts/ directory at repo root
- Bump version to 2.1.2 in all manifests
- Update CHANGELOG with fix details
- Update troubleshooting.md with cache clearing instructions
- Update README file structure diagram

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 21:47:04 +01:00
OthmanAdi ab135ea63e feat: v2.1.0 - Claude Code v2.1 compatibility + docs restructure
- Add SessionStart hook for skill ready notification
- Add PostToolUse hook for phase completion reminders
- Add user-invocable: true for slash menu visibility
- Convert allowed-tools to YAML list format
- Create docs/ folder with organized documentation
- Refactor README to be cleaner with docs links
- Update version to 2.1.0 in all manifests
2026-01-10 17:21:15 +01:00