# jg-plans

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

Protocol 0.2 is provisional. Pages expose Markdown alternatives through their alternate links. Documents remain useful without the library or CLI.

## Protocol, documentation, and examples

- [Home](https://jg-plans.jesusgraterol.dev/): 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.