Skip to content

Observable-contract propagation + serialized boundaries; JA localization, naturalness & self-contained prompts (1.24.0)#177

Merged
shinpr merged 4 commits into
mainfrom
feat/observable-contracts
Jun 18, 2026
Merged

Observable-contract propagation + serialized boundaries; JA localization, naturalness & self-contained prompts (1.24.0)#177
shinpr merged 4 commits into
mainfrom
feat/observable-contracts

Conversation

@shinpr

@shinpr shinpr commented Jun 18, 2026

Copy link
Copy Markdown
Owner

Summary

Promotes Design Doc binding observable contracts from coverage tracking to an enforced, verbatim propagation lane, mirroring the existing ADR Bindings mechanism — then localizes the change into Japanese, runs a corpus-wide Japanese naturalness pass, and makes worker agents/skills self-contained.

What changed

Observable-contract propagation (en) — feat

  • Reference Contracts: binding observable values (column/label set & order, derived-display rules, state-lifecycle negatives) are copied verbatim into the plan (Reference Contract Values) and task (Reference Contracts), each with a Y/N compliance check. Enforced by an executor pre-check + exit-gate re-evaluation, a content-fidelity check in document-reviewer, and detection in code-reviewer (dd_violation).
  • Serialized boundaries: the Connection Map / Field Propagation Map now cover in-runtime serialized boundaries (query string, route/CLI arg, env var, config, message payload, storage key, file) via Serialized Format + Consumer Parse Rule, with a roundtrip exit-gate check; Connection Map owners are recorded as concrete file paths.
  • Escalation: Reference Contract / roundtrip failures map to design_compliance_violation with explicit field mapping at both pre-implementation and exit gate.
  • Lossless token-cost reduction in technical-designer / -frontend (merge Output sections, drop Gate-order timing filler).

Japanese localization + naturalness — chore

  • Ported the above into the ja assets.
  • Corpus-wide Japanese naturalness pass across agents / skills / commands: de-literalized calques, unified である調, fixed word order and mid-sentence wrapping, resolved self-referential/duplicate section names.
  • Terminology unified: acceptance criteria → 受入条件 (AC) on first use then AC; Traceability設計-計画トレーサビリティ表; 完了条件 kept distinct as completion criteria.

Self-contained prompts — refactor

  • Worker agents and skills no longer reference other agents/skills by name (input provenance, downstream consumers, cross-skill pointers) — replaced with generic role/step descriptions, preserving intent. task-decomposer keeps only the file-naming convention.
  • Orchestration layer (commands, subagents-orchestration-guide, task-analyzer), self references, and within-skill references are intentionally retained.

Verification

  • check:skills-index — all 26 skills consistent across en/ja.
  • Section headings unchanged; en-only edits never touched ja and vice versa except where intended.

Version

  • Bumps to 1.24.0 (minor); CHANGELOG updated.

🤖 Generated with Claude Code

shinpr and others added 4 commits June 18, 2026 19:01
…ndaries (en)

Promote Design Doc binding observable contracts from coverage tracking to an
enforced propagation lane carried verbatim across plan -> task -> executor ->
review, mirroring the existing ADR Bindings mechanism.

- Reference Contracts: column/label set & order, derived-display rules, and
  state-lifecycle negatives copied verbatim into plan (Reference Contract Values)
  and task (Reference Contracts), each with a Y/N compliance check; enforced by an
  executor pre-check + exit-gate re-evaluation, a content-fidelity check in
  document-reviewer, and detection in code-reviewer (dd_violation).
- Serialized boundaries: Connection Map / Field Propagation Map now cover
  in-runtime serialized boundaries (query string, route/CLI arg, env var, config,
  message payload, storage key, file) via Serialized Format + Consumer Parse Rule,
  with a roundtrip exit-gate check; Connection Map owners recorded as concrete
  file path(s) so they resolve as Investigation Targets.
- technical-designer / -frontend: serialized boundary recording in the Field
  Propagation Map, plus lossless token-cost reduction (merge Output sections into
  Output Rules, drop Gate-order timing filler subsumed by the Gate Ordering intro).
- Escalation: Reference Contract / roundtrip failures map to design_compliance_violation
  with explicit field mapping at both pre-implementation and exit gate.

check:skills-index: 26 skills consistent.

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

- Port the observable-contract propagation + serialized-boundary changes into
  the Japanese assets (work-planner, task-decomposer, task-executor(-frontend),
  document-reviewer, code-reviewer, technical-designer(-frontend); plan/task/
  design templates), mirroring the English side.
- Corpus-wide Japanese naturalness pass across agents-ja / commands-ja /
  skills-ja: remove clause-joining em-dashes, unify である調 (incl. output
  templates), fix mid-sentence line wrapping, de-literalize calques
  (carry/name-it/agree-on/captured/awkward passives), fix word order, merge
  double parens, trim redundancy, clarify vague phrasing, resolve
  self-referential/duplicate section names.
- Terminology unification: acceptance criteria -> 受入条件(AC) on first use then
  AC (受入基準 folded in); Traceability -> 設計-計画トレーサビリティ表; 完了条件 kept
  distinct as completion criteria. Role-declaration opening kept as です corpus-wide.

Section headings unchanged; check:skills-index consistent across en/ja.
Cross-agent/skill reference cleanup deferred to a separate sweep.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Make each worker agent and skill self-contained: replace references to
other agents by name (input provenance, downstream consumers) and
cross-skill name pointers with generic role/step descriptions, preserving
functional intent. task-decomposer keeps only the file-naming convention
(no routing-destination agent names). Orchestration layer (commands,
subagents-orchestration-guide, task-analyzer), self references, and
within-skill references are intentionally retained.

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 Jun 18, 2026
@shinpr
shinpr merged commit 1700b1a into main Jun 18, 2026
1 check passed
@shinpr
shinpr deleted the feat/observable-contracts branch June 18, 2026 13: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