TTL Policy Skill
Purpose
Manage Time-To-Live (TTL) policies for content consumed from the multi-agent-os framework. Ensures information freshness and triggers review cycles when content expires.
When to Use
- When consuming content from framework
- When checking document freshness
- When syncing from upstream
- When reviewing stale content
TTL by Content Type
| Type | TTL (days) | Rationale | |------|------------|-----------| | Protocol/Standard | 90 | Core protocols are stable | | API Documentation | 60 | Interfaces change moderately | | Configuration | 30 | Configs need frequent updates | | Roadmap/Timeline | 14 | Time-sensitive | | Security Policy | 90 | Security requires stability | | Decision Record | 180 | Decisions are long-lived | | Tutorial/Guide | 60 | Examples may need updates | | Reference Data | 30 | Data freshness matters |
Status States
π’ FRESH β now < expires - 7d β Use normally
π‘ EXPIRING β expires-7d < now < expires β Alert, plan review
π΄ EXPIRED β now >= expires β Block usage, require refresh
PROV Tag Format
Add provenance tracking to consumed content:
Compact (1-line)
<!-- PROV: https://github.com/ekson73/multi-agent-os/blob/main/protocols/hmp.md | v1.0 | sync:2026-01-07 | TTL:90d | exp:2026-04-07 -->
Inline (Markdown-safe)
[//]: # (PROV: https://github.com/ekson73/multi-agent-os/blob/main/protocols/hmp.md|v1.0|2026-01-07|TTL90|exp:2026-04-07)
JSON
{
"_prov": "https://github.com/ekson73/multi-agent-os/blob/main/protocols/hmp.md|v1.0|2026-01-07|TTL90|exp:2026-04-07"
}
PROV Fields
| Field | Format | Example |
|-------|--------|---------|
| full-url | GitHub URL | https://github.com/.../file.md |
| version | Semver | v1.0 |
| sync | ISO date | sync:2026-01-07 |
| TTL | Days | TTL:90d |
| exp | ISO date | exp:2026-04-07 |
Agent Actions by Status
| Status | Agent Action | Human Action | |--------|--------------|--------------| | π’ FRESH | Use normally | None needed | | π‘ EXPIRING | Warn human | Schedule review | | π΄ EXPIRED | Block, require refresh | Sync from upstream |
Sync Protocol
When content is EXPIRED:
- Check upstream for updates
- Pull latest version
- Update sync date
- Recalculate expiration
- Update PROV tag
Skill based on TTL Policy v1.0 | multi-agent-os