| name | propose-entry |
| description | Propose a new compendium entry when you notice a knowledge gap during work. Use when the compendium doesn't cover a domain you need, when a topic would benefit from a reference entry, when you encounter a recurring pattern that should be documented, or when no compendium entry exists for a topic you're working in. Triggers include "compendium gap", "propose entry", "needs a reference entry", "compendium doesn't cover this". |
Propose Entry
File a structured proposal when you notice the compendium is missing craft knowledge that would have helped with the current task. Proposals go to .lore/work/issues/ (the flat-layout .lore/issues/ is also readable in projects that have not migrated), not to the compendium itself. The user decides whether to act on them.
Requirements
This skill requires the Write tool. If you do not have Write access (check your available tools), do not attempt to create the file. Instead, note the gap in your output: state what domain is missing, why it would be valuable, and that you could not file the proposal due to tool access. This ensures the gap is visible even when you can't formally track it.
When to Propose
Propose an entry when:
- You consulted the compendium and found no entry for the domain you're working in.
- You encountered a recurring pattern or practice that multiple workers would benefit from having as standing reference.
- A retro, review finding, or commission result surfaced a knowledge gap that isn't covered.
Do not propose entries for one-off situations or project-specific knowledge. The compendium holds craft knowledge that applies across projects and workers.
How to Propose
1. Choose a Topic Slug
Pick a short, kebab-case slug that describes the domain: error-handling, visual-composition, api-design, test-strategy, etc.
