Skip to content

task-observer: docs/ai/writing-docs updates from 2026-05-22#28

Open
divad12 wants to merge 1 commit into
masterfrom
task-observer/writing-docs-2026-05-22
Open

task-observer: docs/ai/writing-docs updates from 2026-05-22#28
divad12 wants to merge 1 commit into
masterfrom
task-observer/writing-docs-2026-05-22

Conversation

@divad12
Copy link
Copy Markdown
Owner

@divad12 divad12 commented May 22, 2026

Target

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

Observations addressed

  • Observation 1 (dotfiles/log.md): Compression can weaken corrective guardrails → changed: added "Preserve corrective guardrail strength" bullet to new Compression section
  • Observation 2 (dotfiles/log.md): Explain why guardrails exist when model behavior depends on it → changed: added "Keep rationale for judgment-heavy rules" bullet
  • Observation 3 (dotfiles/log.md): Code guardrails need failure-mode rationale → changed: added "Keep compact failure-mode rationale for safety-critical rules" bullet
  • Observation 4 (dotfiles/log.md): Positive phrasing is better for tradeoff guidance → changed: added "Lead with the positive action" bullet (complements existing Contract rule)

Generated by Claude Code

When compressing agent docs, preserve corrective guardrail strength,
keep rationale for judgment-heavy rules, and keep failure-mode
rationale for safety-critical rules. Lead with positive actions
rather than prohibitions for tradeoff guidance.

Addresses dotfiles log.md Obs 1-4.
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