Repository navigation
plan-it v0.1.0
Stop reading walls of markdown. Start seeing your plan.
plan-it is the first persistent, multi-IDE, hash-attested, HTML-emitting planning skill for Claude Code and 16 other agents.
What ships
- 10 HTML templates: implementation-plan, three-approaches, ticket-triage (drag-and-drop), feature-flag-editor (toggles + dependency warnings), module-map (SVG pan/zoom), annotated-pr (diff + margin notes), living-design-system, animation-sandbox (sliders + copy-as-CSS), weekly-status (sparkline), incident-timeline.
- 5 lifecycle hooks: UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact. Plan-injection markers are ===BEGIN/END PLAN DATA===, never ---, to avoid the YAML doc-separator collision that bit planning-with-files at v2.38.1.
- 8 slash commands: /plan, /plan-render, /plan-attest, /plan-status, /plan-export markdown|json, /plan-goal, /plan-loop.
- SHA-256 attestation of plan.html with tamper detection in the inject path.
- Session catchup parses Claude Code, OpenCode (SQLite), and Codex session stores for unsynced plan edits.
- Bidirectional Markdown export that round-trips plan.html into task_plan.md + findings.md + progress.md, planning-with-files compatible.
- 17 IDE adapter mirrors: Claude Code, Cursor, Codex, GitHub Copilot, Mastra Code, OpenCode, Hermes, CodeBuddy, Factory Droid, Gemini CLI, Kiro, Continue, Pi Agent, OpenClaw, Antigravity, Kilocode, AdaL CLI.
- English-only SKILL.md for v0.1.0. Localized variants (ar/de/es/zh/zht) return in v0.2.0 with real translations rather than English-body placeholders.
- 16-file parity-locked version set managed by scripts/bump-version.py with a regression test that fails the build on drift.
- 120/120 pytest tests green covering frontmatter, hooks, attestation, parity, accessibility, single-file constraints, sync verify.
Single-file HTML constraint
Every template ships with inline style, inline script, base64 or inline-SVG assets, system fonts only (system-ui, ui-serif, ui-monospace). No CDN. No build step. No remote URLs. No eval. WCAG AA contrast, ARIA labels, semantic landmarks, keyboard navigation, prefers-color-scheme aware.
Install
/plugin marketplace add OthmanAdi/plan-it
/plugin install plan-it@plan-it
Or any agent-skills-compliant IDE: npx skills add OthmanAdi/plan-it.
Built on the shoulders of
- planning-with-files (OthmanAdi, 21,681 stars) - the markdown predecessor. Hook lifecycle, session catchup, SHA-256 attestation, parity-locked bumper, 17-IDE distribution all carry over.
License
MIT.