docs(v0): external-audience framing — hotel-concierge metaphor + multi-platform tagline + 'specialist LLM models' reframe #41

Merged

claude merged 2 commits from claude/patchwarden-external-framing into main

2026-05-26 14:28:09 +02:00

claude commented

2026-05-26 13:09:45 +02:00

Collaborator

Summary

Three operator-voice-modifications that prepare Patchwarden's documentation for external audience without losing internal cousin-family voice. All per operator voice ack 2026-05-26. Cross-doc edits in 3 strategic artifacts. Diff: +19/-9 lines net.

What changed (7 edits, 3 files)

`docs/product/vision-narrative.md` (2 edits)

Edit 1 — North-star image sharpening (§ "North-star image"):

"night-shift portier of the agent garage" → "night-shift portier of the agent garage — albo dokładniej: luksusowy portier hotelowy, który zna twoje smaki"
Concierge knows the guest list, recognizes friends/partners, turns away strangers, wakes operator only when teściowa shows up unannounced
Also: "gate of your Forgejo" → "gate of your Forgejo (or GitHub, or GitLab — wherever you choose to host)" — multi-platform consistency

Edit 2 — Belief 4 external framing (§ "Tech assumptions"):

Belief 4 reframed: "cousin-family multi-agent coordination" → "specialist-model orchestration (a.k.a. 'cousin-family')"
Internal naming kept as cultural layer; external structural claim = "specialist LLM models, chosen preferred per role"
Concrete example from operator anecdote: claude=frontend, codex=backend (one developer's per-role mapping outside cousin-family network)

`docs/product/positioning-canvas.md` (2 edits)

Edit 3 — Positioning statement multi-platform expansion (§ "Positioning statement"):

"For self-hosting operators and technically literate non-developers running AI coding agents on Forgejo" → "For self-hosters, indie hackers, indie founders, and agentic-first operators delivering value via AI coding agents — on Forgejo, GitHub, GitLab, or anywhere else they choose"
Forgejo is first-class substrate, not exclusive
"orchestrates multi-pass reviewer agents" → "orchestrates specialist reviewer models per role" (consistent with Vision Belief 4 reframe)

Edit 4 — Landing page hero tagline shift (§ "Landing page hero"):

"Patchwarden — self-hosted guardrails for AI-written code" → "Patchwarden — deliver value safely. Be unblocked to ship dreams."
Sub-line: "You ship products, software, tools, documentation — whatever value you create. Patchwarden keeps the code-layer maintenance burden off your back, watches your AI coding agents, and stops the dumb commits before they merge. Self-hosted. Forgejo + GitHub + GitLab + anywhere you choose. $7/mo."
Operator voice 2026-05-26: "chodzi o dostarczanie wartości w bezpieczny sposób — możesz wreszcie jesteś odblokowany"

`docs/product/operating-principles.md` (3 edits)

Edit 5 — MAJOR: § 0 external-audience framing block (after cousin-family-koncepcja paragraph):

New full sub-section titled "External-audience framing: 'specialist LLM models / chosen preferred per role'"
States explicitly: "Patchwarden does not require operators to adopt cousin-family naming."
Concrete example (claude=frontend, codex=backend per operator anecdote 2026-05-26)
Dual-register rule: external materials lead with "specialist LLM models, chosen preferred per role"; internal cousin-family vocabulary reserved for operator's own workspace + repo-internal conversation

Edit 6 — Principle 2 external-audience translation note (end of P2 section):

Adds translation reference: "each specialist LLM model has a defined role; cross-role lane-pinging is forbidden; the operator-as-final-approver is the merge gate"
Maps cousin-family lane discipline to specialist-models lane discipline for external adopters

Edit 7 — Principle 7 evolving-list framing (top of P7 section):

"Principle 7 — The four cousin-family anti-patterns" → "Principle 7 — Cousin-family anti-patterns (evolving list, refresh per quarter)"
Adds operator note: "one będą się zmieniały, więc tu nie listowo bym czwórki" — not fixed at 4
Expects 5+ patterns by Q1 2027 as cousin-family / specialist-LLM operations evolve

What did NOT change

Internal cousin-family vocabulary preserved everywhere as cultural layer (Prof Kong, Iskra, Codex, GLM, kuzynostwo, etc.)
Existing structural framework (8 principles, delegation matrix, non-delegatable activities) intact
Wave-attribution + Cagan tier markings intact
No artifact files outside vision/positioning/operating-principles touched

Why now (operator-modified vs artifact draft)

Three explicit operator voice modifications from 2026-05-26:

Hotel-concierge sharpening: operator wanted night-shift portier metaphor refined to "luksusowy portier hotelowy" with guest-list/preference semantics. Adds concreteness without changing structure.
Multi-platform expansion: operator: "powinien być dla wszystkich self-hostowych + indie hackerów + indie founderów + GitHub + GitLab + gdziekolwiek indziej" — Forgejo-only positioning was too narrow.
External-friendly cousin-family framing: operator: "rozważyłbym Cousin Family inaczej dla zewnętrznych — Specialist LLM Models / Chosen Preferred — każdy ustawia swoje modele jak chce." + concrete example from his developer friend (claude=frontend, codex=backend).

Verification

git diff --stat shows 3 files touched, +19/-9 net
vision-narrative.md North-star image starts with "Patchwarden is the night-shift portier ... albo dokładniej: luksusowy portier hotelowy"
vision-narrative.md Belief 4 includes both "cousin-family" (internal) and "specialist LLM models, chosen preferred per role" (external)
positioning-canvas.md positioning statement includes "Forgejo, GitHub, GitLab, or anywhere"
positioning-canvas.md landing page hero leads with "deliver value safely. Be unblocked to ship dreams."
operating-principles.md § 0 has new sub-section "External-audience framing"
operating-principles.md Principle 7 retitled with "(evolving list, refresh per quarter)"

Sibling PRs (still pending Faza 3b + Faza 4)

PR #40 (Faza 2) — 11 D-decisions in decisions.md, includes D11 multi-platform + D19 external framing references that this PR materializes
Next: claude/patchwarden-tactical-updates (Faza 3b) — jtbd value-first + KPI Goodhart trim + discovery mobile-first + business-model easiness value prop + kill-criteria premortem + thesis revertibility N-check
Then: close epic #1 with operator-affirmed clarity test (Faza 4)

🤖 claude (Patchwarden dedicated thread), M1 close batch Faza 3a per operator voice ack 2026-05-26. References operator-modified D11 + D19 from PR #40.

## Summary Three operator-voice-modifications that prepare Patchwarden's documentation for external audience without losing internal cousin-family voice. All per operator voice ack 2026-05-26. Cross-doc edits in 3 strategic artifacts. Diff: +19/-9 lines net. ## What changed (7 edits, 3 files) ### `docs/product/vision-narrative.md` (2 edits) **Edit 1 — North-star image sharpening** (§ "North-star image"): - *"night-shift portier of the agent garage"* → *"night-shift portier of the agent garage — albo dokładniej: **luksusowy portier hotelowy, który zna twoje smaki**"* - Concierge knows the guest list, recognizes friends/partners, turns away strangers, wakes operator only when teściowa shows up unannounced - Also: "gate of your Forgejo" → "gate of your Forgejo (or GitHub, or GitLab — wherever you choose to host)" — multi-platform consistency **Edit 2 — Belief 4 external framing** (§ "Tech assumptions"): - Belief 4 reframed: *"cousin-family multi-agent coordination"* → *"specialist-model orchestration (a.k.a. 'cousin-family')"* - Internal naming kept as cultural layer; external structural claim = "specialist LLM models, chosen preferred per role" - Concrete example from operator anecdote: claude=frontend, codex=backend (one developer's per-role mapping outside cousin-family network) ### `docs/product/positioning-canvas.md` (2 edits) **Edit 3 — Positioning statement multi-platform expansion** (§ "Positioning statement"): - *"For self-hosting operators and technically literate non-developers running AI coding agents on Forgejo"* → *"For self-hosters, indie hackers, indie founders, and agentic-first operators delivering value via AI coding agents — on Forgejo, GitHub, GitLab, or anywhere else they choose"* - Forgejo is first-class substrate, not exclusive - "orchestrates multi-pass reviewer agents" → "orchestrates specialist reviewer models per role" (consistent with Vision Belief 4 reframe) **Edit 4 — Landing page hero tagline shift** (§ "Landing page hero"): - *"Patchwarden — self-hosted guardrails for AI-written code"* → *"Patchwarden — **deliver value safely. Be unblocked to ship dreams.**"* - Sub-line: "You ship products, software, tools, documentation — whatever value you create. Patchwarden keeps the code-layer maintenance burden off your back, watches your AI coding agents, and stops the dumb commits before they merge. Self-hosted. **Forgejo + GitHub + GitLab + anywhere you choose**. $7/mo." - Operator voice 2026-05-26: *"chodzi o dostarczanie wartości w bezpieczny sposób — możesz wreszcie jesteś odblokowany"* ### `docs/product/operating-principles.md` (3 edits) **Edit 5 — MAJOR: § 0 external-audience framing block** (after cousin-family-koncepcja paragraph): - New full sub-section titled **"External-audience framing: 'specialist LLM models / chosen preferred per role'"** - States explicitly: *"Patchwarden does not require operators to adopt cousin-family naming."* - Concrete example (claude=frontend, codex=backend per operator anecdote 2026-05-26) - Dual-register rule: external materials lead with "specialist LLM models, chosen preferred per role"; internal cousin-family vocabulary reserved for operator's own workspace + repo-internal conversation **Edit 6 — Principle 2 external-audience translation note** (end of P2 section): - Adds translation reference: *"each specialist LLM model has a defined role; cross-role lane-pinging is forbidden; the operator-as-final-approver is the merge gate"* - Maps cousin-family lane discipline to specialist-models lane discipline for external adopters **Edit 7 — Principle 7 evolving-list framing** (top of P7 section): - *"Principle 7 — The four cousin-family anti-patterns"* → *"Principle 7 — Cousin-family anti-patterns (evolving list, refresh per quarter)"* - Adds operator note: *"one będą się zmieniały, więc tu nie listowo bym czwórki"* — not fixed at 4 - Expects 5+ patterns by Q1 2027 as cousin-family / specialist-LLM operations evolve ## What did NOT change - Internal cousin-family vocabulary preserved everywhere as cultural layer (Prof Kong, Iskra, Codex, GLM, kuzynostwo, etc.) - Existing structural framework (8 principles, delegation matrix, non-delegatable activities) intact - Wave-attribution + Cagan tier markings intact - No artifact files outside vision/positioning/operating-principles touched ## Why now (operator-modified vs artifact draft) Three explicit operator voice modifications from 2026-05-26: 1. **Hotel-concierge sharpening**: operator wanted night-shift portier metaphor refined to "luksusowy portier hotelowy" with guest-list/preference semantics. Adds concreteness without changing structure. 2. **Multi-platform expansion**: operator: *"powinien być dla wszystkich self-hostowych + indie hackerów + indie founderów + GitHub + GitLab + gdziekolwiek indziej"* — Forgejo-only positioning was too narrow. 3. **External-friendly cousin-family framing**: operator: *"rozważyłbym Cousin Family inaczej dla zewnętrznych — Specialist LLM Models / Chosen Preferred — każdy ustawia swoje modele jak chce."* + concrete example from his developer friend (claude=frontend, codex=backend). ## Verification - [ ] `git diff --stat` shows 3 files touched, +19/-9 net - [ ] vision-narrative.md North-star image starts with "Patchwarden is the night-shift portier ... albo dokładniej: luksusowy portier hotelowy" - [ ] vision-narrative.md Belief 4 includes both "cousin-family" (internal) and "specialist LLM models, chosen preferred per role" (external) - [ ] positioning-canvas.md positioning statement includes "Forgejo, GitHub, GitLab, or anywhere" - [ ] positioning-canvas.md landing page hero leads with "deliver value safely. Be unblocked to ship dreams." - [ ] operating-principles.md § 0 has new sub-section "External-audience framing" - [ ] operating-principles.md Principle 7 retitled with "(evolving list, refresh per quarter)" ## Sibling PRs (still pending Faza 3b + Faza 4) - PR #40 (Faza 2) — 11 D-decisions in `decisions.md`, includes D11 multi-platform + D19 external framing references that this PR materializes - Next: `claude/patchwarden-tactical-updates` (Faza 3b) — jtbd value-first + KPI Goodhart trim + discovery mobile-first + business-model easiness value prop + kill-criteria premortem + thesis revertibility N-check - Then: close epic #1 with operator-affirmed clarity test (Faza 4) --- 🤖 claude (Patchwarden dedicated thread), M1 close batch Faza 3a per operator voice ack 2026-05-26. References operator-modified D11 + D19 from PR #40.

claude added 1 commit

2026-05-26 13:09:45 +02:00

docs(v0): external-audience framing — hotel-concierge metaphor + multi-platform tagline + 'specialist LLM models' reframe 899b73d864

claude referenced this pull request

2026-05-26 13:14:52 +02:00

docs(v0): tactical operator-voice modifications across 6 product artifacts (iter-5) #42

claude referenced this pull request

2026-05-26 13:16:03 +02:00

Epic: Cagan-grade product strategy package (11 artifacts × 5 waves) #1

codex added 1 commit

2026-05-26 14:26:36 +02:00

docs(v0): refine hotel-concierge wake-up trigger per operator voice (Agnieszka song + wściekła była, less family-specific than teściowa) f032a24ee5