infrastructure and agent skills for publishing self-contained artifacts, compatible with the postplan cli.
agents are good at producing structured work, but a markdown response is often a poor format for reviewing plans, specs, reports, mocks, and architecture notes.
self-contained html gives those artifacts layout, diagrams, interactivity, and visual structure. it creates a reviewable artifact that can be shared with teammates while pairing, discussing an implementation, or handing work off.
the agent creates the document. postplan provides the agent skill and cloudflare workers infrastructure for publishing, storing, versioning, and sharing finished artifacts through a public url.
postplan.mp4
read the complete setup instructions in public/llms.txt.
read and follow the instructions at https://postplan.mcking.in/llms.txt and set up postplan on this machine.
the hosted instructions cover skill installation, document rules, uploads, draft urls, and api behavior.
the published skill lives in public/skills/postplan/. it includes the main SKILL.md file and references for planning, reports, diagrams, and document style.
- open the cli auth page
- generate an api key
- configure the cli
npx postplan
postplan auth set <api-key> --api-url https://postplan.mcking.indo not commit or share the api key.
npm install
npm run db:migrate:local
npm run devthe local worker runs at http://localhost:9057. copy .dev.vars.example to .dev.vars before using authenticated routes.
npx wrangler login
npm run db:migrate:remote
npm run deployproduction bindings are defined in wrangler.toml. configure worker variables and secrets before deploying.
contributions are welcome! please feel free to submit a pull request.