Verified package release

Package 0.5.1 is available. Protocol 0.2 remains provisional.

Canonical page: https://jg-plans.jesusgraterol.dev/

---

# jg-plans — Plain Markdown, precise tooling

Create, inspect and edit Markdown plans with a TypeScript library and local CLI. Keep optional milestones, explicit revisions and your own workflow.

- [Protocol overview](https://jg-plans.jesusgraterol.dev/protocol/): A shared Markdown format for plans and optional milestones. Readable by people, useful to tools, and flexible enough for your project.
- [Specification 0.2](https://jg-plans.jesusgraterol.dev/protocol/0.2/): The provisional jg-plans 0.2 specification: acceptance criteria with stable IDs, milestone coverage, shared progress, explicit error codes, and source-preserving observations.
- [Getting started](https://jg-plans.jesusgraterol.dev/docs/): Go from a Markdown plan to structured data. Start with one file, then choose the library or CLI to build it into your workflow.
- [CLI reference](https://jg-plans.jesusgraterol.dev/docs/cli/): Inspect, check, create, and update planning documents with explicit paths, bounded inputs, and structured JSON output.
- [Library API](https://jg-plans.jesusgraterol.dev/docs/api/): Build on tolerant parsing, optional conformance checks, selected-directory reads, and source-preserving metadata edits.
- [Integrations](https://jg-plans.jesusgraterol.dev/docs/integrations/): Integrate the shared protocol with skills and applications while keeping authorization, coordination, and retention in your project.
- [Examples](https://jg-plans.jesusgraterol.dev/examples/): Follow a real plan through creation, inspection, guarded updates and revision. Explore optional milestones, preserved progress, metadata and partial deletion.