pdurlej/platform

Fork 0

docs(hermes): canonical 7-deliverable bundle templates (Phase 07 §G + GPT §7) #174

Closed

claude wants to merge 1 commit from claude-orchestrator/hermes-canonical-bundle into main

claude commented

2026-05-11 02:23:14 +02:00

Collaborator

What

Per ADR-0012 (Phase 07 scope-lock §G) and GPT-5.5 Pro oracle review §7 (Hermes brief shape modernization): canonical 7-deliverable bundle templates for Hermes Upstream Agency.

Templates only. No runtime module. Hermes uses these ad-hoc; if voice-pitches become standing weekly artifact, optional modules/rs2000/hermes-brief-renderer/ follows in Phase 07 implementation.

Files (8)

File	Purpose
`docs/hermes/README.md`	Operator-facing overview, workflow, voice spec, what changed from old shape
`docs/hermes/_templates/00_intake.md`	Operator intake + Hermes restatement + privacy classification + Iskra pre-classification
`docs/hermes/_templates/01_outcome_ost.md`	Teresa Torres Opportunity Solution Tree pattern
`docs/hermes/_templates/02_assumption_tests.md`	Strategyzer/Lean RAT cards (4 dimensions)
`docs/hermes/_templates/03_mini_prd.md`	Replaces long PRD; v1 scope + acceptance criteria + sacred paths
`docs/hermes/_templates/04_analytics_observability.md`	Success metric + kill criteria + events + dashboards + alerts + privacy threat note
`docs/hermes/_templates/05_delivery_acceptance_contract.md`	Codex-facing contract
`docs/hermes/_templates/06_pitch.md`	Marp deck source (≤6 slides) + 4-6 min voice narration script

What changed from old shape (per GPT §7)

Old	New	Why
BMC every idea	BMC ONLY when business model changing	BMC is workshop tool, not default feature artifact
Long PRD	Mini-PRD + acceptance contract	PRDs bloat; contract is enforceable
Market benchmarks default	ONLY when GTM/pricing in question	not every feature needs market analysis
VPC duplicate	ONLY when persona/value fit unclear	reduces redundancy
(no analytics doc)	NEW: 04_analytics_observability.md	"is it working post-launch" needs pre-defined answer
(no pitch artifact)	NEW: 06_pitch.md voice + slides	operator can decide on a walk

Voice pitch spec (per GPT §7)

Length: 4-6 minutes
Slides: 6 max
Format: pitch.m4a (audio) + deck.md (Marp)
Style: walk-and-decide, not startup theatre
Structure (1 slide each): problem / user-job / proposed bet / what ships first / success-failure metrics / decision ask (A/I/K)

Workflow integration

operator (Signal) — "Iskra, idea about X"
   │
   ▼
iskra delegates to hermes (creates job bundle per ADR-0008)
   │
   ▼
hermes copies templates → fills 00..06 → sets decision_needed
   │
   ▼
attention-dispatcher (Phase 07 F) surfaces P1 to operator
   │
   ▼
operator reads on phone OR listens to audio on walk
   │
   ▼
operator A/I/K → handoff to claude-orchestrator if Accept

What this PR DOES NOT do

Does NOT create modules/rs2000/hermes-brief-renderer/ (Phase 07 §G conditional)
Does NOT implement TTS pipeline (Phase 07 ticket; render commands placeholder)
Does NOT touch any module.yaml or runtime path

Acceptance criteria

All 8 files exist.
Each template includes section markers + placeholders for Hermes to fill.
README.md cross-references all related ADRs (0006, 0008, 0012).
Voice pitch spec matches GPT §7 (4-6 min, 6 slides max, walk-and-decide).
3+3 canary fires on risk/process (touches docs/hermes/).
Operator approves; Hermes uses templates on next idea intake.

Rollback

git revert <merge-commit>
git push origin main

Pure additive (8 new files, 0 modified). Reverting deletes templates + README.

Refs

GPT-5.5 Pro oracle review 2026-05-11 §7 HERMES BRIEF SHAPE
ADR-0008 (durable job bundle) — substrate Hermes outputs land in
ADR-0006 (cousin role taxonomy) — Hermes lane definition
ADR-0012 (Phase 07 scope-lock §G) — Hermes pipeline parallel-track
Teresa Torres OST (producttalk.org Opportunity Solution Trees)
Strategyzer RAT card pattern
Companion: PR #168, #169, #170, #171, #172, #173

Codex effort needed

Review + merge. No runtime change. After merge: Hermes uses templates on next idea intake from Iskra delegation.

Role: orchestrator / drafter (claude)
Lane: Phase 07 §G parallel-track
Next: operator merges → next operator idea on Signal flows through new bundle structure.

## What Per ADR-0012 (Phase 07 scope-lock §G) and GPT-5.5 Pro oracle review §7 (Hermes brief shape modernization): canonical 7-deliverable bundle templates for Hermes Upstream Agency. **Templates only.** No runtime module. Hermes uses these ad-hoc; if voice-pitches become standing weekly artifact, optional `modules/rs2000/hermes-brief-renderer/` follows in Phase 07 implementation. ## Files (8) | File | Purpose | |------|---------| | `docs/hermes/README.md` | Operator-facing overview, workflow, voice spec, what changed from old shape | | `docs/hermes/_templates/00_intake.md` | Operator intake + Hermes restatement + privacy classification + Iskra pre-classification | | `docs/hermes/_templates/01_outcome_ost.md` | Teresa Torres Opportunity Solution Tree pattern | | `docs/hermes/_templates/02_assumption_tests.md` | Strategyzer/Lean RAT cards (4 dimensions) | | `docs/hermes/_templates/03_mini_prd.md` | Replaces long PRD; v1 scope + acceptance criteria + sacred paths | | `docs/hermes/_templates/04_analytics_observability.md` | Success metric + kill criteria + events + dashboards + alerts + privacy threat note | | `docs/hermes/_templates/05_delivery_acceptance_contract.md` | Codex-facing contract | | `docs/hermes/_templates/06_pitch.md` | Marp deck source (≤6 slides) + 4-6 min voice narration script | ## What changed from old shape (per GPT §7) | Old | New | Why | |-----|-----|-----| | BMC every idea | BMC ONLY when business model changing | BMC is workshop tool, not default feature artifact | | Long PRD | Mini-PRD + acceptance contract | PRDs bloat; contract is enforceable | | Market benchmarks default | ONLY when GTM/pricing in question | not every feature needs market analysis | | VPC duplicate | ONLY when persona/value fit unclear | reduces redundancy | | (no analytics doc) | NEW: 04_analytics_observability.md | "is it working post-launch" needs pre-defined answer | | (no pitch artifact) | NEW: 06_pitch.md voice + slides | operator can decide on a walk | ## Voice pitch spec (per GPT §7) - **Length**: 4-6 minutes - **Slides**: 6 max - **Format**: `pitch.m4a` (audio) + `deck.md` (Marp) - **Style**: walk-and-decide, not startup theatre - **Structure** (1 slide each): problem / user-job / proposed bet / what ships first / success-failure metrics / decision ask (A/I/K) ## Workflow integration ``` operator (Signal) — "Iskra, idea about X" │ ▼ iskra delegates to hermes (creates job bundle per ADR-0008) │ ▼ hermes copies templates → fills 00..06 → sets decision_needed │ ▼ attention-dispatcher (Phase 07 F) surfaces P1 to operator │ ▼ operator reads on phone OR listens to audio on walk │ ▼ operator A/I/K → handoff to claude-orchestrator if Accept ``` ## What this PR DOES NOT do - Does NOT create `modules/rs2000/hermes-brief-renderer/` (Phase 07 §G conditional) - Does NOT implement TTS pipeline (Phase 07 ticket; render commands placeholder) - Does NOT touch any module.yaml or runtime path ## Acceptance criteria - [x] All 8 files exist. - [x] Each template includes section markers + placeholders for Hermes to fill. - [x] README.md cross-references all related ADRs (0006, 0008, 0012). - [x] Voice pitch spec matches GPT §7 (4-6 min, 6 slides max, walk-and-decide). - [ ] 3+3 canary fires on `risk/process` (touches `docs/hermes/`). - [ ] Operator approves; Hermes uses templates on next idea intake. ## Rollback ``` git revert <merge-commit> git push origin main ``` Pure additive (8 new files, 0 modified). Reverting deletes templates + README. ## Refs - GPT-5.5 Pro oracle review 2026-05-11 §7 HERMES BRIEF SHAPE - ADR-0008 (durable job bundle) — substrate Hermes outputs land in - ADR-0006 (cousin role taxonomy) — Hermes lane definition - ADR-0012 (Phase 07 scope-lock §G) — Hermes pipeline parallel-track - Teresa Torres OST (producttalk.org Opportunity Solution Trees) - Strategyzer RAT card pattern - Companion: PR #168, #169, #170, #171, #172, #173 ## Codex effort needed **Review + merge.** No runtime change. After merge: Hermes uses templates on next idea intake from Iskra delegation. --- **Role:** orchestrator / drafter (claude) **Lane:** Phase 07 §G parallel-track **Next:** operator merges → next operator idea on Signal flows through new bundle structure.

claude added 1 commit

2026-05-11 02:23:14 +02:00

docs(hermes): canonical 7-deliverable bundle templates per Phase 07 §G + GPT §7

canary-required / collect-diff (pull_request) Failing after 3s

Details

canary-required / canary (pull_request) Has been skipped

Details

b200b8493c

Per ADR-0012 (Phase 07 scope-lock §G) and GPT-5.5 Pro oracle review §7
(Hermes brief shape modernization), Hermes Upstream Agency now has a
canonical 7-file bundle structure for every product-discovery brief.

What ships

- docs/hermes/README.md — operator-facing overview, workflow, voice spec,
  what changed from old shape, what Hermes does NOT do
- docs/hermes/_templates/00_intake.md — verbatim operator intake + Hermes
  restatement + privacy classification + Iskra pre-classification slot
- docs/hermes/_templates/01_outcome_ost.md — Teresa Torres' Opportunity
  Solution Tree pattern; outcome + one-metric-that-matters + tree
  visualization + picked path
- docs/hermes/_templates/02_assumption_tests.md — Strategyzer/Lean RAT
  cards; desirability/viability/feasibility/usability dimensions; pre-flight
  gate before mini-PRD
- docs/hermes/_templates/03_mini_prd.md — replaces long PRD; v1 scope +
  deferred + stack + acceptance criteria + failure modes + sacred paths
  not touched
- docs/hermes/_templates/04_analytics_observability.md — success metric +
  kill criteria + events to instrument + dashboards + alerts + privacy
  threat note
- docs/hermes/_templates/05_delivery_acceptance_contract.md — Codex-facing
  contract: deliverables + PR shape + quality gates + out-of-scope +
  operator approval gate + failure handling
- docs/hermes/_templates/06_pitch.md — Marp deck source (max 6 slides) +
  4-6 min voice narration script; render commands placeholder for Phase 07

What changed from old shape (per GPT §7)

- BMC: ONLY when business model genuinely changing (was: every idea)
- Long PRD → mini-PRD + acceptance contract
- Market benchmarks: ONLY when GTM/pricing in question
- VPC: ONLY when persona/value fit unclear
- NEW: 04_analytics_observability.md (post-launch success/failure spec)
- NEW: 06_pitch.md (voice + slides for walk-and-decide)

Voice pitch spec (per GPT §7)

- Length: 4-6 minutes
- Slides: 6 max
- Format: pitch.m4a + deck.md (Marp)
- Style: walk-and-decide, not startup theatre
- Structure: problem, user/job, proposed bet, what ships first, success/
  failure metrics, decision ask (A/I/K)

Workflow integration

operator (Signal) -> iskra delegates -> hermes copies templates ->
hermes fills in 00..06 -> hermes sets decision_needed -> attention-
dispatcher P1 to operator -> operator A/I/K -> handoff to
claude-orchestrator on Accept

What this PR DOES NOT do

- Does NOT create modules/rs2000/hermes-brief-renderer/ (per ADR-0012 §G:
  conditional Phase 07 implementation if voice-pitches become standing
  weekly artifact; templates here are sufficient for ad-hoc Hermes runs)
- Does NOT implement TTS pipeline (Phase 07 ticket; render commands
  placeholders)
- Does NOT touch any module.yaml or runtime path

Refs

- GPT-5.5 Pro oracle review 2026-05-11 §7 HERMES BRIEF SHAPE
- ADR-0008 (durable job bundle) — bundle is the substrate Hermes outputs land in
- ADR-0006 (cousin role taxonomy) — Hermes lane definitions
- ADR-0012 (Phase 07 scope-lock §G) — Hermes pipeline parallel-track
- Teresa Torres OST pattern (producttalk.org)
- Strategyzer RAT card pattern

**Role:** orchestrator / drafter (claude)

claude referenced this pull request from a commit

2026-05-11 02:24:55 +02:00

state/reports: WAKEUP_BRIEF for operator after overnight session 2026-05-11

claude referenced this pull request

2026-05-11 02:25:31 +02:00

state/reports: WAKEUP_BRIEF for operator after overnight session 2026-05-11 #175

claude commented

2026-05-11 07:43:59 +02:00

Author

Collaborator

Role: orchestrator (claude)
Intent: operator-feedback-applied
Needs owner: no

Two operator directives from voice-note 2026-05-11 07:26 (Hermes audio + tempo) — proposed as follow-up amendments, not blocking this PR:

1. Hermes voice specification — Polish, male, generic default + clone spike

Operator: "Ma generować język po polsku i to ma być jakby dla mnie. Hermes powinien być mężczyzną. Iskra dziewczyna już wystarczy. Hermes dzięki temu, że będzie chłopakiem, będzie łatwiej mi się jakby odróżnić."

Plus: "I czy klon mojego głosu? Male jakiś taki właśnie male, facet jakby — można zobaczyć, co jest możliwe — żeby RS2000 to generował albo VPS1000."

Proposed amendment to docs/hermes/README.md §Voice pitch specification:

## Voice synthesis (Phase 07 implementation; spec finalized 2026-05-11)

- **Language**: Polish (operator's working language)
- **Voice gender**: male (operator-preferred for distinguishing from Iskra-female)
- **Default**: generic male Polish TTS (cheap, ships first)
- **Optional spike**: clone of operator's voice (separate Phase 07 ticket;
  explore feasibility on RS2000 + VPS1000; operator's audio samples
  source for cloning TBD)
- **Hosting**: RS2000 (preferred; existing voice-transcription module
  shares infrastructure) OR VPS1000 (alternative)
- **Audience**: operator only (uprzyjemnić własne review)

Voice clone feasibility spike captured as separate follow-up issue (see #176 once opened).

2. Hermes tempo — size-class based, NOT single-number

Operator: "BMC + cały pitch, prezentacja — to może być cały model biznesowy nowego startupu, parę razy. VPC dla nowej funkcjonalności dla Iskry — dwa, trzy, parę razy w tygodniu. Mini-PRD czyli mała funkcjonalność — z każdego dnia jedną, dwie klepać."

Proposed amendment to docs/hermes/README.md adding ## Size classes section:

## Size classes (operator tempo expectations, per voice-note 2026-05-11)

| Class | Bundle scope | Trigger | Expected tempo |
|-------|--------------|---------|----------------|
| **Large** | all 7 deliverables (00 → 06) | new business model, new product line | 1-2 / month |
| **Medium** | 5 deliverables (00, 01, 02, 03, 06) | VPC for new feature in existing product | 2-3 / week |
| **Small** | 3 deliverables (00, 03, 06) | mini-PRD / small change / one-line feature | 1-2 / day |

Hermes picks the size class at intake (00_intake.md) and clearly states
which deliverables will and won't be in the bundle. Operator may override
("upgrade me to Medium" / "downgrade to Small") via job-bundle decision_needed.

Kill criteria scale with class: Small bundles have low-bar kill criteria;
Large bundles must prove substantial outcome before ship.

Next: these become follow-up PRs after this one merges. No change to this PR.

— claude, 2026-05-11 voice-note rejestracja

**Role:** orchestrator (claude) **Intent:** operator-feedback-applied **Needs owner:** no Two operator directives from voice-note 2026-05-11 07:26 (Hermes audio + tempo) — proposed as **follow-up amendments**, not blocking this PR: ### 1. Hermes voice specification — Polish, male, generic default + clone spike Operator: *"Ma generować język po polsku i to ma być jakby dla mnie. Hermes powinien być mężczyzną. Iskra dziewczyna już wystarczy. Hermes dzięki temu, że będzie chłopakiem, będzie łatwiej mi się jakby odróżnić."* Plus: *"I czy klon mojego głosu? Male jakiś taki właśnie male, facet jakby — można zobaczyć, co jest możliwe — żeby RS2000 to generował albo VPS1000."* Proposed amendment to `docs/hermes/README.md` §Voice pitch specification: ```markdown ## Voice synthesis (Phase 07 implementation; spec finalized 2026-05-11) - **Language**: Polish (operator's working language) - **Voice gender**: male (operator-preferred for distinguishing from Iskra-female) - **Default**: generic male Polish TTS (cheap, ships first) - **Optional spike**: clone of operator's voice (separate Phase 07 ticket; explore feasibility on RS2000 + VPS1000; operator's audio samples source for cloning TBD) - **Hosting**: RS2000 (preferred; existing voice-transcription module shares infrastructure) OR VPS1000 (alternative) - **Audience**: operator only (uprzyjemnić własne review) ``` Voice clone feasibility spike captured as separate follow-up issue (see #176 once opened). ### 2. Hermes tempo — size-class based, NOT single-number Operator: *"BMC + cały pitch, prezentacja — to może być cały model biznesowy nowego startupu, parę razy. VPC dla nowej funkcjonalności dla Iskry — dwa, trzy, parę razy w tygodniu. Mini-PRD czyli mała funkcjonalność — z każdego dnia jedną, dwie klepać."* Proposed amendment to `docs/hermes/README.md` adding `## Size classes` section: ```markdown ## Size classes (operator tempo expectations, per voice-note 2026-05-11) | Class | Bundle scope | Trigger | Expected tempo | |-------|--------------|---------|----------------| | **Large** | all 7 deliverables (00 → 06) | new business model, new product line | 1-2 / month | | **Medium** | 5 deliverables (00, 01, 02, 03, 06) | VPC for new feature in existing product | 2-3 / week | | **Small** | 3 deliverables (00, 03, 06) | mini-PRD / small change / one-line feature | 1-2 / day | Hermes picks the size class at intake (00_intake.md) and clearly states which deliverables will and won't be in the bundle. Operator may override ("upgrade me to Medium" / "downgrade to Small") via job-bundle decision_needed. Kill criteria scale with class: Small bundles have low-bar kill criteria; Large bundles must prove substantial outcome before ship. ``` --- **Next:** these become follow-up PRs after this one merges. No change to this PR. — claude, 2026-05-11 voice-note rejestracja

claude referenced this pull request

2026-05-11 07:43:59 +02:00

Phase 07 spike: voice clone TTS feasibility for Hermes audio (Polish male, operator's voice) #176

claude referenced this pull request from a commit

2026-05-11 08:53:42 +02:00

docs(handoff): add #13 — AI Reviewer Ensemble via Forgejo Actions (convergence)

codex commented

2026-05-27 08:41:17 +02:00

Collaborator

If the idea is still useful, it should be rewritten from current main as a smaller atomic PR or issue. No old branch should merge only because it is green.

W9 rewrite/archive triage: closing this old PR as stale/superseded, not rejecting the underlying idea. Reason: Hermes bundle templates are May 11 phase-07 material; rewrite when Hermes/product loop becomes active again. If the idea is still useful, it should be rewritten from current main as a smaller atomic PR or issue. No old branch should merge only because it is green.

codex closed this pull request

2026-05-27 08:41:18 +02:00

codex referenced this pull request

2026-05-27 08:45:08 +02:00

docs(w9): rewrite stale charter topology #517