Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "writing-method",
"version": "0.4.0",
"version": "0.4.1",
"description": "Reader-oriented writing, documentation workflows, local PDF delivery and narrated tutorial videos, plus an experimental story-writing family kept separate from them.",
"author": {
"name": "Peter Hense"
Expand Down
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "writing-method",
"version": "0.4.0",
"version": "0.4.1",
"description": "Reader-oriented writing, documentation workflows, local PDF delivery and narrated tutorial videos, plus an experimental story-writing family kept separate from them.",
"author": {
"name": "Peter Hense"
Expand Down
15 changes: 12 additions & 3 deletions BACKLOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,15 @@ GitHub Issues are canonical. Refresh this cache; do not make local canonical mut

## Tasks

<!-- engineering-method:backlog {"schema_version":1,"id":"WM-001","title":"Narrated presentation videos: scripting, production and review skills","status":"in_progress","priority":"P1","parent_id":null,"depends_on":[],"notes":"Spec approved 2026-11-13. Skills, guides, project template, credential examples and tests implemented on branch wm-001-presentation-video (uncommitted); 235 tests pass; rehearsed end to end on the sample video (docs/specs/WM-001-presentation-video/rehearsal.md). Open: maintainer listening check, playbook review, live host trigger evaluations, commit and pull request.","updated_at":"2026-11-13T11:56:44Z"} -->
- 🔄 `WM-001` **P1** Narrated presentation videos: scripting, production and review skills
- Notes: Spec approved 2026-11-13. Skills, guides, project template, credential examples and tests implemented on branch wm-001-presentation-video (uncommitted); 235 tests pass; rehearsed end to end on the sample video (docs/specs/WM-001-presentation-video/rehearsal.md). Open: maintainer listening check, playbook review, live host trigger evaluations, commit and pull request.
<!-- engineering-method:backlog {"schema_version":1,"id":"WM-001","title":"Narrated presentation videos: scripting, production and review skills","status":"blocked","priority":"P1","parent_id":null,"depends_on":[],"notes":"Skills, tools and template are released (0.3.0 to 0.4.1). Done since: host trigger evaluations (the four video cases pass on Claude and Codex) and three independent playbook reviews with 43 findings applied (docs/specs/WM-001-presentation-video/playbook-review.md). Blocked on work only the maintainer can do: one end-to-end rehearsal of the corrected playbook through gate 2 and delivery on a machine with ffmpeg and a configured speech provider, and the listening check of the sample by a person. Then one more playbook-review at that revision.","updated_at":"2026-11-13T19:54:07Z"} -->
- ❌ `WM-001` **P1** Narrated presentation videos: scripting, production and review skills
- Notes: Skills, tools and template are released (0.3.0 to 0.4.1). Done since: host trigger evaluations (the four video cases pass on Claude and Codex) and three independent playbook reviews with 43 findings applied (docs/specs/WM-001-presentation-video/playbook-review.md). Blocked on work only the maintainer can do: one end-to-end rehearsal of the corrected playbook through gate 2 and delivery on a machine with ffmpeg and a configured speech provider, and the listening check of the sample by a person. Then one more playbook-review at that revision.
<!-- engineering-method:backlog {"schema_version":1,"id":"WM-003","title":"Story writing as a separate skill family","status":"complete","priority":"P1","parent_id":null,"depends_on":[],"notes":"Released in 0.4.0 (PR #8): nine story- skills, shared story rules, story vault starter, writing mode per text. Experimental; no story written with it yet.","updated_at":"2026-11-13T19:54:44Z"} -->
- ✅ `WM-003` **P1** Story writing as a separate skill family
- Notes: Released in 0.4.0 (PR #8): nine story- skills, shared story rules, story vault starter, writing mode per text. Experimental; no story written with it yet.
<!-- engineering-method:backlog {"schema_version":1,"id":"WM-002","title":"Book layout for long manuals in documentation-pdf","status":"complete","priority":"P2","parent_id":null,"depends_on":[],"notes":"Released in 0.3.0: book layout for long manuals in documentation-pdf.","updated_at":"2026-11-13T19:54:58Z"} -->
- ✅ `WM-002` **P2** Book layout for long manuals in documentation-pdf
- Notes: Released in 0.3.0: book layout for long manuals in documentation-pdf.
<!-- engineering-method:backlog {"schema_version":1,"id":"WM-004","title":"Narrated story videos (audiobook with images) from a story vault","status":"complete","priority":"P2","parent_id":null,"depends_on":[],"notes":"Released in 0.4.0 (PR #8): story-video-scripting, verbatim and listening editions, form skills for both families. Experimental; no story video produced.","updated_at":"2026-11-13T19:54:47Z"} -->
- ✅ `WM-004` **P2** Narrated story videos (audiobook with images) from a story vault
- Notes: Released in 0.4.0 (PR #8): story-video-scripting, verbatim and listening editions, form skills for both families. Experimental; no story video produced.
36 changes: 34 additions & 2 deletions FEATURES.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,37 @@
# Features

Peter's Engineering Method is currently pre-release. No plugin capability has been implemented or released yet.
This inventory records implemented, changed, and historically removed capabilities. Planned work belongs only in `BACKLOG.md`.

This file records working, user-visible or architectural capabilities after they exist. Planned work belongs only in `BACKLOG.md`.
<!-- engineering-method:feature {"schema_version":1,"id":"F-001","name":"Reader-oriented documentation","summary":"Scale-aware planning, authoring and review of documentation with didactic writing skills (concept explanation, procedures, troubleshooting), glossary and placeholder conventions. Structure is tested; produced text is not measured.","status":"available","related_backlog_ids":[],"updated_at":"2026-11-13T19:21:17Z"} -->
## `F-001` Reader-oriented documentation

- Status: available
- Summary: Scale-aware planning, authoring and review of documentation with didactic writing skills (concept explanation, procedures, troubleshooting), glossary and placeholder conventions. Structure is tested; produced text is not measured.

<!-- engineering-method:feature {"schema_version":1,"id":"F-002","name":"Local PDF delivery","summary":"One local PDF from Markdown with a single-sided layout for short documents and a book layout for long manuals.","status":"available","related_backlog_ids":["WM-002"],"updated_at":"2026-11-13T19:21:17Z"} -->
## `F-002` Local PDF delivery

- Status: available
- Summary: One local PDF from Markdown with a single-sided layout for short documents and a book layout for long manuals.
- Related backlog: `WM-002`

<!-- engineering-method:feature {"schema_version":1,"id":"F-003","name":"Narrated tutorial videos","summary":"Script, production and review skills with a project template and tools for a presentation video voiced by a speech provider. The production playbook passed two content reviews; it has not been rehearsed end to end and no person has done the listening check.","status":"available","related_backlog_ids":["WM-001"],"updated_at":"2026-11-13T19:21:17Z"} -->
## `F-003` Narrated tutorial videos

- Status: available
- Summary: Script, production and review skills with a project template and tools for a presentation video voiced by a speech provider. The production playbook passed two content reviews; it has not been rehearsed end to end and no person has done the listening check.
- Related backlog: `WM-001`

<!-- engineering-method:feature {"schema_version":1,"id":"F-004","name":"Story writing family (experimental)","summary":"Nine story- skills with shared story rules and a story vault starter, separated from reader-oriented writing by a per-text writing mode. No story has been written with it; produced text is not measured.","status":"available","related_backlog_ids":["WM-003"],"updated_at":"2026-11-13T19:21:17Z"} -->
## `F-004` Story writing family (experimental)

- Status: available
- Summary: Nine story- skills with shared story rules and a story vault starter, separated from reader-oriented writing by a per-text writing mode. No story has been written with it; produced text is not measured.
- Related backlog: `WM-003`

<!-- engineering-method:feature {"schema_version":1,"id":"F-005","name":"Narrated story videos (experimental)","summary":"An accepted chapter becomes a video script, verbatim or as a listening edition that leaves the manuscript unchanged; the form skills voice and render it without restyling. No story video has been produced.","status":"available","related_backlog_ids":["WM-004"],"updated_at":"2026-11-13T19:21:17Z"} -->
## `F-005` Narrated story videos (experimental)

- Status: available
- Summary: An accepted chapter becomes a video script, verbatim or as a listening edition that leaves the manuscript unchanged; the form skills voice and render it without restyling. No story video has been produced.
- Related backlog: `WM-004`
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
type: reference
audience: Authors and maintainers familiar with their coding assistant and Git
version: 0.4.0
version: 0.4.1
---
# Writing Method

Expand Down Expand Up @@ -102,8 +102,9 @@ No video has been produced with this path. How invented names are pronounced and
- **Routing is statistical.** The tests prove that names, exclusion sentences and links are in place. Whether an assistant then picks the right family for a request is a probability, not a guarantee.
- **Produced text is not measured.** No check reads a chapter for documentation habits, or a reply for a story's voice.
- **No story pilot exists.** The skills are structurally checked and have not been proven on a real story. Light-novel figures such as volume length are left unset, not asserted.
- **The video playbook is reviewed, not rehearsed.** The production playbook template went through three independent content reviews; all 43 findings are applied. The corrected text has not been run end to end, and no person has done the listening check.
- **No story video exists.** The script check and the routing expectations for story videos are tested; nothing has been voiced or rendered from a story script.
- **Host routing is checked once, not measured as a rate.** In the last full run each of the 24 routing cases under `evals/shared/triggers/` ran once per host: Claude passed 24 of 24, Codex 22 of 24. The two Codex failures, repeated twice, are a marketing clip correctly sent to focused editing with the video production skill reported as supporting (1 of 3 passed), and a draft request in a study vault where Codex names `story-drafting` and not `story-craft-research` as primary (0 of 3 passed); the harness cannot see that the draft is declined. Eleven unscripted German requests without any skill name loaded the expected skill in 9 of 11 cases on Claude and 11 of 11 on Codex, once each. The record, including three expectations or prompts changed after seeing a result, is in `docs/specs/WM-003-story-family/rehearsal.md`. OpenCode was not exercised.
- **Host routing is checked once, not measured as a rate.** In the last full run each of the 24 routing cases under `evals/shared/triggers/` ran once per host: Claude passed 24 of 24, Codex 22 of 24. The two Codex failures, repeated twice, are a marketing clip correctly sent to focused editing with the video production skill reported as supporting (1 of 3 passed), and a draft request in a study vault where Codex names `story-drafting` and not `story-craft-research` as primary (0 of 3 passed); the harness cannot see that the draft is declined. After two corrections both Codex cases passed 3 of 3. Twelve unscripted German requests without any skill name, three runs each with both plugins loaded, hit the expected skill in 33 of 36 runs on Claude and 35 of 36 on Codex; they can be repeated with `scripts/run_natural_evals.py`. The record, including three expectations or prompts changed after seeing a result, is in `docs/specs/WM-003-story-family/rehearsal.md`. OpenCode was not exercised.

The family originated in a private research workspace. That workspace's research notes and its studies of existing works are not part of this plugin.

Expand All @@ -123,7 +124,7 @@ claude plugin install writing-method@writing-method

For a session-scoped Claude test use `claude --plugin-dir /absolute/path/to/writing-method`. For OpenCode, run `python3 scripts/install-opencode --check` from this checkout, inspect the proposed path, then repeat without `--check`. It installs an owned `writing-method.js` loader pointing to this retained directory. Gemini support is deferred until its adapter is verified.

Restart the assistant session after installation and inspect its plugin inventory for `writing-method` 0.4.0. An installed listing proves discovery; a live authoring request is separate behavior evidence. With both methods installed, use the invoking method's namespace for shared support, such as `writing-method:playbook-authoring`, and run one copy.
Restart the assistant session after installation and inspect its plugin inventory for `writing-method` 0.4.1. An installed listing proves discovery; a live authoring request is separate behavior evidence. With both methods installed, use the invoking method's namespace for shared support, such as `writing-method:playbook-authoring`, and run one copy.

## Project state and updates

Expand Down
Loading
Loading