Skip to content

task-observer: docs/ai/writing-docs updates from 2026-05-04#8

Open
divad12 wants to merge 1 commit intomasterfrom
task-observer/writing-docs-2026-05-04
Open

task-observer: docs/ai/writing-docs updates from 2026-05-04#8
divad12 wants to merge 1 commit intomasterfrom
task-observer/writing-docs-2026-05-04

Conversation

@divad12
Copy link
Copy Markdown
Owner

@divad12 divad12 commented May 4, 2026

Target

global-doc: docs/ai/writing-docs.md

Observations addressed

  • Observation 3 (dotfiles/log.md): Code guardrails need failure-mode rationale → changed: added Contract bullet — corrective rules that guard against known agent failure modes should also describe the failure mode they prevent, so the model recognises when the rule applies under pressure rather than rationalising past it.
  • Observation 1 (dotfiles/log.md): Compression can weaken corrective guardrails → changed: added Contract bullet — when compressing instructions, preserve enforcement-strength phrasing (guardrail phrases, fallback options, failure-mode rationale); remove redundancy, not corrective force.

Generated by Claude Code

- Add rule: corrective guardrails need failure-mode rationale so models
  recognise when the rule applies under pressure (Obs 3, dotfiles/log.md)
- Add rule: compression must preserve enforcement-strength phrasing —
  remove redundancy, not corrective force (Obs 1, dotfiles/log.md)
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