Merge S2 (a1): compliance + approval pack
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> # Conflicts: # BUILD-STATE.md # web/src/app/about/page.tsx
This commit is contained in:
@@ -0,0 +1,66 @@
|
||||
# Ghost Publishing Runbook — blog.vyndr.app
|
||||
|
||||
How to move the seed articles in `content/articles/` into Ghost as drafts.
|
||||
Manual by design: **nothing auto-posts, anywhere, ever** (NORTH STAR — Kev is
|
||||
the publisher of everything). Claude Code has no Ghost credentials and never
|
||||
touches the Ghost admin; this runbook is the entire publishing pipeline.
|
||||
|
||||
## What lives where
|
||||
|
||||
- Source of truth: `content/articles/*.md` in this repo. Edit here first,
|
||||
then re-paste into Ghost — never edit only in Ghost, or the repo copy rots.
|
||||
- Each file has YAML front matter (`title`, `slug`, `excerpt`, `tags`,
|
||||
`status: draft`). The front matter is metadata for YOU to key into Ghost's
|
||||
fields — do not paste the front matter block into the post body.
|
||||
|
||||
## Per-article steps (about 3 minutes each)
|
||||
|
||||
1. Open `https://blog.vyndr.app/ghost/` and sign in (your credentials).
|
||||
2. Click **New post**.
|
||||
3. Title: copy the `title` from the front matter into the title field.
|
||||
4. Body: in the editor type `/` and choose the **Markdown** card (or type
|
||||
```/markdown```). Paste everything BELOW the closing `---` of the front
|
||||
matter into the card. Ghost renders the `##` headings, bold, and lists.
|
||||
- Do not paste into the plain editor surface — straight pasting can
|
||||
flatten headings depending on Ghost version. The Markdown card is exact.
|
||||
5. Open **Post settings** (gear icon, top right):
|
||||
- **Post URL**: set to the front-matter `slug` (e.g. `what-clv-is`).
|
||||
- **Excerpt**: paste the front-matter `excerpt`.
|
||||
- **Tags**: add the front-matter tags (e.g. `methodology`, `the-read-room`).
|
||||
6. Leave the post as a **draft** — do NOT click Publish during seeding.
|
||||
7. Preview in Ghost. Checklist before it ever goes live:
|
||||
- Zero exclamation points (VOICE v1.1 — deadpan, no exceptions).
|
||||
- No banned vocabulary: "lock", "tail", "fade" as calls to action,
|
||||
guarantee language, hype emoji. If it sounds like the industry, cut it.
|
||||
- Every record/percentage claim obeys the product's n≥20 gate — if the
|
||||
live Ledger cannot back a number in the article, remove the number.
|
||||
- Links point at `vyndr.app/...` production paths (`/methodology`,
|
||||
`/ledger`), not localhost or staging.
|
||||
|
||||
## The five seed articles (in publish order)
|
||||
|
||||
| File | Title |
|
||||
| --- | --- |
|
||||
| `how-vyndr-grades-a-prop.md` | How VYNDR Grades a Prop |
|
||||
| `why-our-misses-are-public.md` | Why Our Misses Are Public |
|
||||
| `what-clv-is.md` | CLV: The Only Number That Proves an Edge |
|
||||
| `the-vyndr-originals.md` | The VYNDR Originals: 41 Archetypes and Why They Exist |
|
||||
| `how-streaks-lie.md` | How Streaks Lie |
|
||||
|
||||
Suggested cadence: one per week, methodology first (it is the page every
|
||||
other article links back to conceptually). Publishing is your call, on your
|
||||
schedule — this table is an ordering, not a scheduler.
|
||||
|
||||
## Updating a published article
|
||||
|
||||
1. Edit the markdown in `content/articles/` and commit.
|
||||
2. In Ghost, open the post, delete the old Markdown card, insert a fresh one,
|
||||
paste the updated body. Keep the same Post URL — never change a slug after
|
||||
publish (dead links).
|
||||
|
||||
## Explicitly out of scope
|
||||
|
||||
- No Ghost Admin API integration, no automation, no scheduled posts. If that
|
||||
ever changes it goes through a spec in `specs/` first and Kev still presses
|
||||
the button.
|
||||
- No exclamation points. Still.
|
||||
Reference in New Issue
Block a user