Publish Blog Post

Create and publish blog posts to the Pikari website. Handles everything from content shaping through to opening a pull request.

Workflow

digraph publish {
  rankdir=TB;
  node [shape=box];

  gather [label="Gather content from user\n(topic, draft, bullets, or idea)"];
  shape [label="Shape into post\n(write/polish, match Pikari tone)"];
  save [label="Save .mdx file to content/blog/"];
  preview [label="Start dev server if not running\nOpen post in browser for preview"];
  feedback [label="User wants changes?"];
  publish [label="Branch, commit, push, open PR"];
  done [label="Give user the PR link"];

  gather -> shape -> save -> preview -> feedback;
  feedback -> shape [label="yes"];
  feedback -> publish [label="approved"];
  publish -> done;
}

Content Guidelines

Tone: Professional but accessible. Research-backed, conversational. No marketing fluff. Short paragraphs (2-4 sentences). Concrete examples over theory.

Length: 6-12 minute reads, roughly 1,500-2,500 words.