Common Context OptimizationSAFE

A collection of Agent Skills Standard and Best Practice for Programming Languages, Frameworks that help our AI Agent follow best practies on frameworks and programming laguages

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: common-context-optimization
description: Manage context and prompt-cache costs without losing task state. Use for context management, orchestration cost, token budgets, large tool outputs, cache misses, or long-running conversations.
metadata:
  triggers:
    files:
      - "*.log"
      - "chat-history.json"
    keywords:
      - reduce tokens
      - optimize context
      - summarize history
      - clear output
      - context management
      - prompt-cache
      - prompt caching
      - orchestration cost
---

## **Priority: P1 (HIGH)**

## Workflow

1. **Inspect** host capabilities; do not assume agents can rewrite history, prompts, or memory.
2. **Project outputs** after consuming them: retain decisions, evidence, errors, and required values; point to complete logs/artifacts by stable reference.
3. **Bound context** at host-supported boundaries. Carry goal, active slice, authority, decisions, blockers, evidence links, and next action; preserve a stable append-only prefix where supported.
4. **Compact** only when useful and supported. Keep required details retrievable; never discard source evidence or rely on a fixed turn/token threshold.
5. **Measure** cache reads, replayed input, and total actor cost across the whole task. Separate observed usage from estimates; no invoice, savings, or efficacy claims without evidence.

## Anti-Patterns

- **No history rewrite assumption**: Project outputs or create artifact references; use only host-supported controls.
- **No fixed threshold**: Compact from observed context pressure and task needs, not a universal turn/token count.
- **No evidence deletion**: Keep stable references to source outputs, decisions, and verification.
- **No partial cost claim**: Include cache reads, replay, and total actor cost; label estimates.

## References

- [Compaction](references/compaction.md)
- [Masking and output projection](references/masking.md)
- [Implementation and cost measurement](references/implementation.md)

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.