Skip to content

Refine skill-optimization patterns and wire through creator/reviewer (1.25.3)#184

Merged
shinpr merged 4 commits into
mainfrom
feat/adopted-design-validity-review-en
Jul 16, 2026
Merged

Refine skill-optimization patterns and wire through creator/reviewer (1.25.3)#184
shinpr merged 4 commits into
mainfrom
feat/adopted-design-validity-review-en

Conversation

@shinpr

@shinpr shinpr commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

Refines the skill-optimization skill's content patterns and wires them through the skill-creator and skill-reviewer agents so generated and reviewed skills come out less over-constrained and easier to follow. Applied across en/ja and released as 1.25.3.

  • BP-002 — clarify vague wording with the least-restrictive sufficient criterion, recording its precision contribution / constraint cost / derived source (or the required source when a decision cannot be determined)
  • BP-003 — define the output shape the consumer requires rather than a format chosen by convention
  • BP-005 — Missing or Excess Context: also remove duplicated, distracting, or unactionable context
  • BP-006 — each step names an observable completion output and the condition to proceed
  • BP-007 — Unnecessary or Biased Examples: minimal necessary set instead of forced variety
  • BP-008 — classify claims as observed / inferred / unknown; stop for the specific evidence or user decision required
  • principles # 4 / # 7 aligned; review-criteria gains a content-observable constraint-necessity check
  • skill-creator: bp002Resolution branch schema; skill-reviewer: constraintNecessity balance check

Note: this branch also carries an earlier feat(design-doc): add adopted design validity review (en) commit (334df1c), which is not part of the 1.25.3 changelog entry.

Verification

  • check:skills-index — all 28 skills consistent across en / ja
  • ja agent JSON blocks valid

🤖 Generated with Claude Code

shinpr and others added 4 commits July 16, 2026 08:08
Port the Adopted design validity check from the plugin distribution
(claude-code-workflows PR #147) into the -en sources, selectively so
this repo's already-ahead checks (behavioral claim, fact-disposition
semantic alignment, cross-layer assumptions, minimal-surface detail)
and its TypeScript-specialized frontmatter/category set stay intact.

- document-reviewer.md: add requirements_verbatim / confirmed_decisions
  inputs, the effective-requirements derivation step, the confirmed_decisions
  clause in the LLM-facing clarity check, the Adopted design validity check
  block, and its Self-Validation enumeration entry.
- design.md / front-design.md: wire requirements_verbatim / confirmed_decisions
  into the Design Doc document-reviewer invocation and pass the confirmed
  scope and user answers to the technical-designer.

Scope: -en only; ja sync is a separate step.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ments (en)

Port the latest rashomon prompt-optimization BP refinements into the
English skill-optimization skill and wire them through the consuming
agents:

- BP-002: least-restrictive sufficient criterion with precision
  contribution / constraint cost; decompose the dense cell into
  resolution steps; source-derived example with an unresolved fallback
- BP-003: consumer-required output shape
- BP-005: rename to Missing or Excess Context; add excess-context removal
- BP-006: per-step output evidence and transition condition
- BP-007: rename to Unnecessary or Biased Examples; shift to minimal
  necessary examples
- BP-008: observed/inferred/unknown classification, stop with the
  evidence or user decision required
- principles #4/#7 aligned with the refined vocabulary
- review-criteria: content-observable constraint-necessity check
- skill-creator: sync BP transforms, add bp002Resolution branch schema
- skill-reviewer: constraintNecessity balance check (content-observable)

Scope: English sources only; ja/active mirror deferred.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ements into ja sources

Translate the English skill-optimization refinements into the Japanese
sources, matching existing tone and terminology and avoiding literal
renderings:

- BP-002: least-restrictive sufficient criterion with precision
  contribution / constraint cost and resolution steps; source-derived
  example with an unresolved fallback
- BP-003: consumer-required output shape
- BP-005: rename to Missing or Excess Context; add excess-context removal
- BP-006: per-step observable completion output and transition condition
- BP-007: rename to Unnecessary or Biased Examples; minimal necessary
  examples
- BP-008: observed-fact/inferred/unknown classification, stop with the
  evidence or user decision required
- principles #4/#7 aligned with the refined vocabulary
- review-criteria: content-observable constraint-necessity check
- skill-creator: sync BP transforms, add bp002Resolution branch schema
- skill-reviewer: constraintNecessity balance check (content-observable)

Verified en/ja skills-index consistency and ja agent JSON validity.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shinpr shinpr self-assigned this Jul 16, 2026
@shinpr
shinpr merged commit 684bee9 into main Jul 16, 2026
1 check passed
@shinpr
shinpr deleted the feat/adopted-design-validity-review-en branch July 16, 2026 06:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant