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
5 changes: 2 additions & 3 deletions docs/upstream/claude-dev-spending-your-effort-blog.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,7 @@ Dropped or held, each needing the user's go-ahead before it runs:
- Dating the agent pin count in [claudedevs-cost-performance.md](claudedevs-cost-performance.md)
was dropped: [#5767](https://github.com/melodic-software/claude-code-plugins/pull/5767) replaced
the count with a pointer.
- Held for the user: an eval of the object-writer agent across effort levels (it settles
[E4](#decisions)); a correction round on the digest slice; graduating the slice to the knowledge
- Held for the user: a correction round on the digest slice; graduating the slice to the knowledge
corpus in its own draft pull request; comments on
[#4253](https://github.com/melodic-software/claude-code-plugins/issues/4253) and
[#4346](https://github.com/melodic-software/claude-code-plugins/issues/4346). The replay sweep
Expand Down Expand Up @@ -72,7 +71,7 @@ correlate note. Shared for every row:
| E1 Lane effort | Every lane launches with an explicit level chosen per lane: verdict lanes at the level the table gives work where verification matters, the coordinating merge lane at its model's default passed explicitly, code and verify work never below medium. The launcher refuses a lane whose config names no `effort` and warns when the effort environment variable can override lanes and agent pins. [loop-lane-prompts.md](../../prompts/loops/loop-lane-prompts.md) (Models), [config.md](../../plugins/harness-ops/skills/lanes/context/config.md), [lane-launcher.sh](../../plugins/harness-ops/skills/lanes/scripts/lane-launcher.sh). Supersedes the lanes half of [B1](claude-dev-sonnet-5-5-blog.md#decisions) | [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level); correlate [When to use different effort levels in Claude Code](https://claude.dev/blog/spending-your-effort#when-to-use-different-effort-levels-in-claude-code) |
| E2 Lane records the level that ran | The work-loop and babysit-loop state blocks record the effort each cycle ran at, or `unset`, since a passed level can be clamped or overridden. [work-loop SKILL.md](../../plugins/work-items/skills/work-loop/SKILL.md), [babysit-loop SKILL.md](../../plugins/source-control/skills/babysit-loop/SKILL.md) | [Common input fields](https://code.claude.com/docs/en/hooks#common-input-fields); correlate [the post](https://claude.dev/blog/spending-your-effort) |
| E3 Implementation agent pins | The phase verifier stays at high and the implementer at medium, as [#5885](https://github.com/melodic-software/claude-code-plugins/pull/5885) set them; that pull request superseded this interview's answer to keep the implementer at high. Both agents' upward-only binding now covers a shipped Workflow script's `effort` and `model`. [phase-verifier.md](../../plugins/implementation/agents/phase-verifier.md), [implementer.md](../../plugins/implementation/agents/implementer.md) | [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level); correlate [Higher effort levels help when there are many edge cases](https://claude.dev/blog/spending-your-effort#higher-effort-levels-help-when-there-are-many-edge-cases) |
| E4 Object-writer pin | Pinned at medium, provisional until an eval compares levels. [object-writer.md](../../plugins/songwriting/agents/object-writer.md) | [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level); correlate [Building with effort](https://claude.dev/blog/spending-your-effort#building-with-effort) |
| E4 Object-writer pin | Pinned at medium, settled by the 2026-10-03 eval: medium matched high, low failed the long and character cases. [object-writer.md](../../plugins/songwriting/agents/object-writer.md) | [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level); correlate [Building with effort](https://claude.dev/blog/spending-your-effort#building-with-effort) |
Comment thread
cursor[bot] marked this conversation as resolved.
| E5 Review and other agent pins | Confirmed unchanged: the security reviewer and architecture guardian stay at high with no max pin. [security-reviewer.md](../../plugins/review/agents/security-reviewer.md), [architecture-guardian.md](../../plugins/review/agents/architecture-guardian.md) | [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level); correlate [Problem areas where effort helps](https://claude.dev/blog/spending-your-effort#problem-areas-where-effort-helps) |
| E6 Pin drift check | A tested script hashes the docs' effort sections against a committed baseline and flags, never edits, any pin, lane level or Workflow literal that rests on a changed table or default. It runs from the audit's `effort-pins` scope and checklist row and on each Claude Code release through the changelog skill. [check-effort-pins.sh](../../plugins/harness-config/skills/audit/scripts/check-effort-pins.sh), [audit-checklist.md](../../plugins/harness-config/skills/audit/reference/audit-checklist.md), [changelog SKILL.md](../../plugins/harness-ops/skills/changelog/SKILL.md) | [Adjust effort level](https://code.claude.com/docs/en/model-config#adjust-effort-level), [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level); correlate [the post](https://claude.dev/blog/spending-your-effort) |
| E7 Per-phase effort advice | Skills advise a level per phase by having the model read the live table and name the row it matched; no level is written into skill text, code and verify phases are never advised below medium, and an unreadable page means no advice. The interview's handoff advises implement and verify levels separately; continue-in-background passes the matched level for resumed verify or unattended work. [steps.md](../../plugins/session-flow/skills/workflow/context/steps.md), [continue-in-background SKILL.md](../../plugins/session-flow/skills/continue-in-background/SKILL.md), [session-config.md](../../plugins/planning/skills/interview/context/session-config.md) | [Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level), [Set the effort level](https://code.claude.com/docs/en/model-config#set-the-effort-level); correlate [Takeaways](https://claude.dev/blog/spending-your-effort#takeaways) |
Expand Down
2 changes: 1 addition & 1 deletion plugins/songwriting/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "songwriting",
"version": "1.6.0",
"version": "1.6.1",
"description": "Songwriting craft companion: nine concern-scoped lyric-craft skills (workflow router, rhyme, object-writing, metaphor, meter-prosody, song-form, co-write, diagnose, practice) applying Pat Pattison's methods, with an object-writing agent that performs the sensory exercise itself and per-skill emission boundaries that route generation to the skill that owns it, plus Suno v5.5 prompt engineering (style prompts, tagged lyrics, genre templates, troubleshooting).",
"author": {
"name": "Melodic Software",
Expand Down
9 changes: 9 additions & 0 deletions plugins/songwriting/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,15 @@
All notable changes to the `songwriting` plugin are documented here. Format follows
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.

## [1.6.1] - 2026-10-03

### Changed

- **The `object-writer` agent's `medium` effort pin is settled.** An eval of the object-writing
cases at `low`, `medium` and `high` found `medium` matched `high` on pass rate and blind-graded
write quality, while `low` failed the 10-minute case (drift back to the seed) and the character
case (first-person voice). The agent's effort note records the reason and a new recheck trigger.

## [1.6.0] - 2026-10-02

### Added
Expand Down
13 changes: 8 additions & 5 deletions plugins/songwriting/agents/object-writer.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,13 +145,16 @@ Any one of these means you did not run the exercise. Fix it before writing the f

## Effort pin

The effort pin in this file's frontmatter is our choice for one timed, sense-bound write. It is
provisional: an eval comparing this agent's writes under `medium` and `high` decides it.
The effort pin in this file's frontmatter is `medium`, settled by an eval on 2026-10-03 that ran
the object-writing suite's cases at `low`, `medium` and `high`. `medium` matched `high` on pass rate
and on blind-graded write quality, while `low` failed the long (10-minute) case, drifting back to
the seed, and the character case, slipping out of first-person voice, where `medium` and `high`
held every run.

- **Pointer**: for choosing a level, see
[Choose an effort level](https://code.claude.com/docs/en/model-config#choose-an-effort-level);
for what the `opus` alias resolves to, see
[Model aliases](https://code.claude.com/docs/en/model-config#model-aliases).
- **As of**: 2026-10-02
- **Recheck trigger**: the `opus` alias resolves to another model, the `medium` row changes, or the
eval reports.
- **As of**: 2026-10-03
- **Recheck trigger**: the next model release, a change to the object-writing eval suite, or the
model-config table's `medium` or `high` rows changing.
Loading