clawdie/clawdie-iso
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: rewrite negative patterns to positive actionable instructions #88

Merged
clawdie merged 1 commit from docs/positive-language-rewrite into main 2026-06-21 14:02:02 +02:00
Conversation 0 Commits 1 Files changed 4 +91 -82
clawdie commented 2026-06-21 14:01:46 +02:00
Owner
Copy link

Convert 'do not' / 'never' / 'avoid' / 'cannot' / 'must not' patterns
into positive 'do ABC to achieve XYZ' instructions across four key docs.

Files changed:

  • AGENTS.md: role restrictions, linux constraints, formatting gate,
    private workspace, scratch paths, mount discipline, source-of-truth
  • BUILD.md: colibri compilation, mini-binary policy, USB flashing,
    SSH-key distribution, mDNS scope, PF logging, host disk policy
  • skills/iso-build/SKILL.md: build gating, CLI policy, command chaining,
    tmux workflow, colibri preflight/cargo-clean timing, SDDM retention
  • PLAN-OPERATOR-USB-NEXT.md: SDDM contract, package categorization,
    bhyve gating, dashboard dependencies, seed checkout exclusions

Safety-critical constraints (USB whole-disk flashing, verified artifacts
only) are preserved with positive rephrasing that keeps the constraint
intact.

Convert 'do not' / 'never' / 'avoid' / 'cannot' / 'must not' patterns into positive 'do ABC to achieve XYZ' instructions across four key docs. Files changed: - AGENTS.md: role restrictions, linux constraints, formatting gate, private workspace, scratch paths, mount discipline, source-of-truth - BUILD.md: colibri compilation, mini-binary policy, USB flashing, SSH-key distribution, mDNS scope, PF logging, host disk policy - skills/iso-build/SKILL.md: build gating, CLI policy, command chaining, tmux workflow, colibri preflight/cargo-clean timing, SDDM retention - PLAN-OPERATOR-USB-NEXT.md: SDDM contract, package categorization, bhyve gating, dashboard dependencies, seed checkout exclusions Safety-critical constraints (USB whole-disk flashing, verified artifacts only) are preserved with positive rephrasing that keeps the constraint intact.
clawdie added 1 commit 2026-06-21 14:01:49 +02:00 
Convert 'do not' / 'never' / 'avoid' / 'cannot' / 'must not' patterns
into positive 'do ABC to achieve XYZ' instructions across four key docs.

Files changed:
- AGENTS.md: role restrictions, linux constraints, formatting gate,
  private workspace, scratch paths, mount discipline, source-of-truth
- BUILD.md: colibri compilation, mini-binary policy, USB flashing,
  SSH-key distribution, mDNS scope, PF logging, host disk policy
- skills/iso-build/SKILL.md: build gating, CLI policy, command chaining,
  tmux workflow, colibri preflight/cargo-clean timing, SDDM retention
- PLAN-OPERATOR-USB-NEXT.md: SDDM contract, package categorization,
  bhyve gating, dashboard dependencies, seed checkout exclusions

Safety-critical constraints (USB whole-disk flashing, verified artifacts
only) are preserved with positive rephrasing that keeps the constraint
intact.
clawdie merged commit 99755fa8b7 into main 2026-06-21 14:02:02 +02:00
clawdie deleted branch docs/positive-language-rewrite 2026-06-21 14:02:02 +02:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: clawdie/clawdie-iso#88
No description provided.
Delete branch "docs/positive-language-rewrite"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?