twining-semantic-review

Solid

LLM-judged semantic staleness review of Twining entries — flags decisions and blackboard entries tied to historical context that has moved on (dead sprints, renamed concepts, retired architectures). Opt-in, human-confirmed; complements deterministic staleness_review. Use when housekeeping is clean but old entries still reference concepts that no longer make sense.

AI & Automation 7 stars 3 forks Updated 6 days ago MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
30
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Twining Semantic Review — LLM-Judged Staleness Deterministic staleness (`twining_housekeeping` with `staleness_review: true`) catches orphans-by-structure: the scope path is gone, affected files deleted, branch removed. It cannot catch entries that are structurally intact but reference *concepts* the project has moved past — "Wave 3 review action items", "HMS Lancaster compliance", a sprint that closed a year ago. A future agent finding those will go looking for concepts that don't exist and hallucinate explanations. This skill puts the judging model — you — in that loop. **You are the LLM; no API key, no server-side model call, no cost beyond this session.** Nothing is archived without explicit user confirmation. ## When to Invoke - The user asks for a semantic review, deep cleanup, or "are any of these entries still relevant?" - After a milestone/version ships and its planning vocabulary is retired - Deterministic housekeeping reports clean but `twining_status` shows a large, old entry population Never run this as a side effect of another task. It is opt-in by design. ## Workflow ### 1. Ground yourself in what is CURRENT Before judging anything, build the "still alive" picture: - `git branch --list` and the current branch — active lines of work - `README.md` / project docs headline — what the project is now - `twining_status` — entry counts, current phase if tracked - The 10 most recent blackboard entries — today's working vocabulary ### 2. Load review candidate...

Details

Author
daveangulo
Repository
daveangulo/twining-mcp
Created
6 months ago
Last Updated
6 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category