| name | knowledge-promote |
| description | HADES knowledge promotion: promote a project-local item to global
cross-project memory (HADES design D aggregator.Promote, audit-logged). Use
when operator invokes /hades:knowledge-promote or decides item should be global.
|
| license | Proprietary |
| agentskills_version | 1 |
| keywords | ["knowledge-promote","global-memory","aggregator","audit-chain","HADES design","hades"] |
HADES — knowledge-promote skill (knowledge promotion)
This skill promotes a knowledge item from project-local to global cross-project
memory via HADES design D's aggregator.Promote(). Triggered by /hades:knowledge-promote.
When to use
- Operator invokes
/hades:knowledge-promote <item-id> <reason>
- When a project-local finding should be visible to all in-scope projects
- After verifying item via
/hades:knowledge-query (check it's worth promoting)
Workflow
1. Pre-flight visibility check
Verify item exists + operator can see it:
curl --unix-socket /tmp/hades-system.sock -s "http://unix/v1/knowledge/<id>" | jq '.'
2. POST promote to daemon
curl --unix-socket /tmp/hades-system.sock \
-X POST \
-d '{"reason":"<reason>"}' \
"http://unix/v1/knowledge/<id>/promote"
Daemon: adds to global_pins table + anchors KnowledgePromoted event in
HADES design Tessera audit chain with operator identity from keychain.
3. Invariants
- Reason REQUIRED (load-bearing for audit chain readability)
- Reason MUST NOT contain Claude/Anthropic/AI attribution (invariant)
- 409 if already promoted; 422 if capa-firewall project (needs explicit override)
4. Reverse: unpromote
hades knowledge unpromote <id> --reason "..."
CLI only (no slash; demoting is rare + less time-critical).
Cross-references
- spec §9.1 HADES design D aggregator.Promote
- spec §4.6 audit chain integration
- invariant privacy boundary (promotion crosses it)
- /hades:knowledge-promote slash command handler
