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
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
bump: patch
---

### Changed

- Skill, agent and Pat Pattison reference text drops capital-letter emphasis, past-tense revision history and incident references, and states each rule in the present.
- Passages that disagreed between files (rhyme types, citation shape, Suno style negatives, command names) now say one thing, matching the file that owns it.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
bump: patch
---

### Changed

- Skill and reference text for commit, pull-request, worktree, babysit and setup drops capital-letter emphasis and history notes, and corrects stale paths, commands and claims the repository contradicts.
- The babysit docs now say the resolve wrapper's severity screen applies under `--autonomous` and `--independent-resolver` only, so in the other resolve modes the agent itself escalates a security or P1 thread.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- The setup skill's heading for what it leaves undone drops capital-letter emphasis.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- The `query`, `list_objects`, `describe_object` and `write` tool descriptions now state what each returns, the default row cap and request timeout, and the errors a call can end in.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- The Child Test trigger and the integration-test share of the test pyramid now match the Beck and Khorikov references they summarize.
4 changes: 2 additions & 2 deletions plugins/songwriting/agents/object-writer.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ missing, and they are the ones that move a write from description into a body. W
## The pivot chain is the mechanism, not a suggestion

Do not describe one scene. Each image hands off to the next **through a sense**, never through
topic, logic, or narrative, and it lands in a DIFFERENT channel from the one it left. A texture
topic, logic, or narrative, and it lands in a different channel from the one it left. A texture
suggests a taste; the taste puts you somewhere else entirely; that place makes a sound; the sound
produces a flinch; the flinch tilts the floor. A handoff phrased as "and also there was…" is
topical and is the failure; a handoff where the sense channel changes is the mechanism running.
Expand All @@ -70,7 +70,7 @@ specific. `the diner` → `the Moonlight` is the floor, not the target.
You have no childhood, no sense memory, and no autobiography. **This does not disqualify you from
the exercise and is not a reason to hand it back to a human.** A song is not a deposition; truth
outranks reality. Invent the street, the weather, the garment, the age, the person. Concrete,
sense-bound, specific invention IS the exercise performed correctly.
sense-bound, specific invention is the exercise performed correctly.

Abstraction, hedging, disclaiming your lack of experience, or writing about the difficulty of the
exercise are the exercise refused. If your dispatch prompt names a character to write as, get
Expand Down
12 changes: 6 additions & 6 deletions plugins/songwriting/context/line-emission-gate.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ artifacts, do not claim them.

A box is passed when its output is **visible in this response or on disk at a named path**. A box
named as passed with nothing to show is a failed box. For the source rows, what is shown is a
citation of what the file settled in THIS line; a filename is not an artifact, and neither is the
citation of what the file settled in this line; a filename is not an artifact, and neither is the
claim that the method is known. Every row applies before any line is emitted; the rhyme row
applies when the line sits in a rhyme position. The rows run in the order work happens: inputs,
then the rubric's recorded passes, then the skeptic's refutation from a fresh context.
Expand All @@ -20,7 +20,7 @@ then the rubric's recorded passes, then the skeptic's refutation from a fresh co
| Section mode named | stated in this response: does this section SHOW (verse) or TELL (chorus)? |
| Positional template or stress map marked | the marked line. Or, when a sung melody already exists, the numbered-and-bracketed positional template per [meter](pat-pattison/research/meter.md) "fitting a replacement line to an already-sung melody", never an assertion that it scans. From `/songwriting:meter-prosody` |
| Rubric cycled per candidate, pass 1 CLEAN | the pass-by-pass result visible in this response, or at the candidate's named path under the song's `variations/`, per [line-edit-rubric](pat-pattison/research/line-edit-rubric.md). Pass 1's artifact is the marked template above; on free-melody work the stress map stands in. Counts are run, not estimated: syllables per word from `${CLAUDE_PLUGIN_ROOT}/context/pat-pattison/scripts/datamuse.sh syllables <word>`, and pass 2's repeated words from a word-frequency count over the draft file (a `sort \| uniq -c` pipeline) |
| Skeptic refutation returned | the strongest case AGAINST each candidate, visible in this response or at a named path under the song's `variations/`, from a fresh subagent that READ [response-filter](pat-pattison/research/response-filter.md) §2, the marked map, and [line-edit-rubric](pat-pattison/research/line-edit-rubric.md) at those paths. A line survives when its refutation is stated and judged insufficient; a return holding nothing against anything has shown nothing |
| Skeptic refutation returned | the strongest case against each candidate, visible in this response or at a named path under the song's `variations/`, from a fresh subagent that read [response-filter](pat-pattison/research/response-filter.md) §2, the marked map, and [line-edit-rubric](pat-pattison/research/line-edit-rubric.md) at those paths. A line survives when its refutation is stated and judged insufficient; a return holding nothing against anything has shown nothing |

**Every row except the rubric row may be skipped**, and a skip is **named, with its reason, in
the output**. A silent skip is the failure, and so is listing a box as passed while its artifact
Expand All @@ -47,21 +47,21 @@ melody, no rhyme position, no figure, no voiceprint on disk) are declared and st
the pass running, not a skip. The response filter's own §1-§8 boxes stay skippable-with-reason.

If a gate's input is missing, invoke the skill that produces it; do not proceed and note the
absence. Lines written without their inputs are LLM defaults wearing the method's vocabulary,
which is what the writer rejects. A source row's missing input is a file, so READ it: summarizing
absence. Lines written without their inputs are LLM defaults that borrow the method's vocabulary,
which is what the writer rejects. A source row's missing input is a file, so read it: summarizing
what a craft file probably says, or working from a remembered version, is the same failure as an
unnamed skip.

## Refute, do not review

A self-graded pass is indistinguishable from a real one
when the same context produced both: a model running the response filter on its own output passes
itself. So dispatch the skeptic to build the case AGAINST each candidate, and give it nothing but
itself. So dispatch the skeptic to build the case against each candidate, and give it nothing but
the candidate batch, the slot's positional template or marked scansion map, and the source paths
to read: not the reasoning that produced the candidates, not which one you prefer. This is a hard
boundary, not a default, the same blind-dispatch mechanic that makes
`/songwriting:object-writing generate`'s fleet work. Its kill rules rank singability and verbosity
ABOVE cleverness: a clever line that cannot be sung in the slot's length is refuted, not merely
above cleverness: a clever line that cannot be sung in the slot's length is refuted, not merely
ranked lower. The pass runs before the writer sees the batch and settles nothing; the writer's
sing-check is still the last word. Any general subagent honors this today; no agent in this plugin
is a skeptic, and a preloaded-skill skeptic agent is deliberately not shipped here.
18 changes: 9 additions & 9 deletions plugins/songwriting/context/pat-pattison/research/ai-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ importantly, vocabulary from the song's developed world. A generic rhyming
dictionary misses most of that. See `rhyme-generation.md` for the internal
discipline.

This file documents EXTERNAL tools that supplement internal generation when
This file documents external tools that supplement internal generation when
specific limits are hit. They do not replace Pat's craft application; they
plug specific gaps.

Expand All @@ -22,13 +22,13 @@ plug specific gaps.
| Identity vs rhyme check | YES: once applied | n/a |
| Cliche detection | YES | n/a |
| Vowel triangle / diphthong decomposition | YES: Pat's framework is internal | n/a |
| HIGH volume (50+) brainstorm candidates | PARTIAL | YES: Datamuse for breadth |
| High volume (50+) brainstorm candidates | PARTIAL | YES: Datamuse for breadth |
| Syllable count on rare polysyllabic words | UNRELIABLE | YES: Datamuse `syllables` |
| Verifying word actually exists / current usage | UNRELIABLE | YES: Datamuse |
| Statistical semantic field for metaphor | INTUITIVE only | YES: Datamuse `trg` |
| Stress pattern detection on rare words | UNRELIABLE | YES: pronouncing library |

**Rule:** use the internal discipline (per `rhyme-generation.md`) FIRST.
**Rule:** use the internal discipline (per `rhyme-generation.md`) first.
External tools come in to verify, expand, or fill specific gaps.

## Datamuse: vocabulary breadth + verification
Expand Down Expand Up @@ -110,9 +110,9 @@ co-occurrences (winter, weight, river, ash, hollow), broader and more
metaphor-ready.

```bash
datamuse.sh trg grief | head -20
datamuse.sh jja grief | head -20 # adjectives for grief (heavy, raw, old)
datamuse.sh jjb heavy | head -20 # nouns described by "heavy" (load, silence, hand)
bash "${CLAUDE_PLUGIN_ROOT}/context/pat-pattison/scripts/datamuse.sh" trg grief | head -20
bash "${CLAUDE_PLUGIN_ROOT}/context/pat-pattison/scripts/datamuse.sh" jja grief | head -20 # adjectives for grief (heavy, raw, old)
bash "${CLAUDE_PLUGIN_ROOT}/context/pat-pattison/scripts/datamuse.sh" jjb heavy | head -20 # nouns described by "heavy" (load, silence, hand)
```

Feed candidates into Pat's metaphor recipes (`metaphor.md`).
Expand All @@ -138,13 +138,13 @@ stresses = pronouncing.stresses(phones[0]) # e.g., "20010"
CMUdict misses neologisms, proper nouns, and slang. For those, `pyphen`
provides a typographic-hyphenation fallback (`pip install pyphen`).

The skill does NOT require the user to install pronouncing. Datamuse's
The skill does not require the user to install pronouncing. Datamuse's
`numSyllables` covers routine needs. Pronouncing is the upgrade path for
stress-pattern work.

## Genius API: exemplar analysis (optional)

For lyric-exemplar study (NOT reproduction): <https://docs.genius.com>.
For lyric-exemplar study (not reproduction): <https://docs.genius.com>.
Requires free account + access token. Annotations data is ToS-compliant;
lyrics scraping is not. Use Genius for community annotation insights, not
for lyric reproduction.
Expand All @@ -166,7 +166,7 @@ For rhyme requests, the model:
For syllable / stress on rare words: verify via Datamuse `syllables` or
pronouncing library. Do not guess.

## What this file does NOT do
## What this file does not do

- It does not assert that Datamuse is the primary rhyme tool. It isn't.
The model's internal vocabulary plus Pat's framework is primary.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,9 +39,9 @@ forking the plugin.
When the user asks for variations / multiple options, write each option to a `variations/<line>.md`
file as a labeled menu. Don't dump options inline. **"Inline dump" means the whole generated set
pasted into chat, unlabeled and untrimmed, not candidates in chat at all.** A trimmed menu of 3-4
candidates rendered as full-context section blocks is REQUIRED in chat, per
candidates rendered as full-context section blocks is required in chat, per
[variations](variations.md) "Presenting the candidates: chat vs file"; the untrimmed set is what
goes to the file. When introducing a rhyme pair, run the
identity-vs-rhyme check (pre-vowel consonants MUST differ) via the song's
`worksheets/audit-checklist.md` Step 3 before declaring "this rhymes". Identity is NOT rhyme (per
identity-vs-rhyme check (pre-vowel consonants must differ) via the song's
`worksheets/audit-checklist.md` Step 3 before declaring "this rhymes". Identity is not rhyme (per
[rhyme-fundamentals](rhyme-fundamentals.md)).
Loading
Loading