Skip to content

fix: harden forge-global and always-on-guidance skills for compression resilience - #59

Open
jflowers wants to merge 5 commits into
unbound-force:mainfrom
jflowers:opsx/harden-skill-compression
Open

fix: harden forge-global and always-on-guidance skills for compression resilience#59
jflowers wants to merge 5 commits into
unbound-force:mainfrom
jflowers:opsx/harden-skill-compression

Conversation

@jflowers

@jflowers jflowers commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Restructures two embedded skill files to improve constraint survival under DCP context compression, addressing six specific vulnerabilities identified in #51.

forge-global: Replaces parallel "do/don't" lists with a decision table (Signal/Forge/Skip columns), inlines TTL parameter into the reservation step, and adds temporal ordering markers (FIRST/THEN/FINALLY) to protocol steps.

always-on-guidance: Adds a dedicated ## Critical Safety section for safety-critical rules, moves hivemind_find from last to first position in Tool Usage, and splits Code Quality/Testing/Error Handling lists into sub-headed groups of 2-3 items each.

All changes are structural reorganization -- no rules were added, removed, or weakened.

Closes #51

How to Test

# Build passes (embedded content compiles via go:embed)
make build

# All tests pass including agentkit tests (file existence, count, frontmatter)
make test

# Verify semantic equivalence
git diff main -- internal/agentkit/content/skills/

Acceptance criteria from specs:

  • Critical Safety section appears before all other rule sections
  • Decision table has Signal/Forge/Skip columns with all 6 original criteria
  • Each protocol step contains a temporal marker (FIRST/THEN/FINALLY)
  • hivemind_find is the first item in Tool Usage
  • TTL is inlined into the comms_reserve call (no standalone TTL bullet)
  • All sub-lists contain no more than 3 items

How to Demo

Inspect the restructured skill files:

cat internal/agentkit/content/skills/forge-global/SKILL.md
cat internal/agentkit/content/skills/always-on-guidance/SKILL.md

Compare the decision table format in forge-global and the sub-headed groups in always-on-guidance against the original flat list structure.

Key Files Changed

File Description
internal/agentkit/content/skills/forge-global/SKILL.md Decision table, inline TTL, temporal ordering
internal/agentkit/content/skills/always-on-guidance/SKILL.md Critical Safety section, repositioned hivemind_find, sub-headed groups
.opencode/skills/forge-global/SKILL.md Synced with canonical embedded source
.opencode/skills/always-on-guidance/SKILL.md Synced with canonical embedded source
openspec/changes/harden-skill-compression/* OpenSpec artifacts (proposal, design, specs, tasks)

This PR was generated by /uf.finale (AI-assisted).

…n resilience

Restructure two embedded skill files to improve survival under DCP
context compression, addressing six specific vulnerabilities (unbound-force#51):

- Replace parallel do/don't lists with decision table in forge-global
- Inline TTL parameter into reservation step, add temporal ordering
- Add Critical Safety section in always-on-guidance for safety rules
- Move hivemind_find from last to first position in Tool Usage
- Split Code Quality, Testing, Error Handling into sub-headed groups
- Sync .opencode/skills/ copies with canonical embedded source

No semantic changes to any rules -- structural reorganization only.

Closes unbound-force#51

Assisted-by: claude-opus
Generated with AI assistance (claude-opus)
@jflowers
jflowers requested a review from a team as a code owner August 2, 2026 20:35
@jflowers
jflowers requested a review from yvonnedevlinrh August 2, 2026 20:50
@jflowers jflowers self-assigned this Aug 2, 2026
@jflowers jflowers moved this to In Review 👀 in Unbound Force Planning Aug 2, 2026

@sonupreetam sonupreetam left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Council

Ran the review council (6 Divisor agents). The restructuring patterns (decision table, temporal markers, priority positioning) are sound but needs structural tests and drift detection.

Cross-PR note: The Curator filed a blog opportunity issue for the prompt hardening methodology: unbound-force/website#198.

Comment thread internal/agentkit/content/skills/always-on-guidance/SKILL.md Outdated
Comment thread internal/agentkit/content/skills/forge-global/SKILL.md Outdated
Comment thread internal/agentkit/content/skills/always-on-guidance/SKILL.md
jflowers and others added 3 commits August 7, 2026 15:33
- always-on-guidance: Never -> NEVER force push to main (DR-002)
- forge-global: add (5-minute auto-release) parenthetical to TTL

Co-authored-by: claude-opus-4-6 <noreply@anthropic.com>
- TestAlwaysOnGuidance_StructuralHardening: verifies Critical Safety
  section positioning, RFC 2119 keywords, hivemind_find priority,
  and sub-header splits
- TestForgeGlobal_StructuralHardening: verifies decision table format,
  temporal markers, inlined TTL, and no standalone TTL step
- TestSkillFiles_DriftDetection: TC-007 drift detection comparing
  embedded files against .opencode/ scaffolded copies

Co-authored-by: claude-opus-4-6 <noreply@anthropic.com>
@jflowers
jflowers requested a review from sonupreetam August 7, 2026 19:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In Review 🏁

Development

Successfully merging this pull request may close these issues.

bug: forge-global and always-on-guidance skills contain compression-vulnerable decision logic and quality rules

2 participants