features-audit
Skill2 starsChanged 31 days agoMITView on GitHub
Maintainer only (needs pmctl with the maintainer's tracker DB). Check FEATURES.md for completeness against the code and fix it: find features missing from the file, stale or removed entries, and create the file if it does not exist. Use when the maintainer asks to check/audit/refresh FEATURES.md, when FEATURES.md is missing, or periodically. Contributors describe changes in the PR instead.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- arch-guardSkill
- builder-previewSkill
- features-updateSkill
- screen-validatorSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 40
Read the entries (pmctl feature list, or FEATURES.md).
- Very specific: line 57
Document planned work (open issues, the "Open decisions" in docs/themes/dt/README.md): only shipped behaviour.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Audit FEATURES.md
Maintainer only: needs pmctl with the maintainer's tracker DB (project polymux). Contributors: describe
the change in the PR instead. Without pmctl (command -v pmctl fails), stop and say so.
Goal: FEATURES.md lists every user-facing feature exactly once and nothing that is gone. Run by the
features-keeper sub-agent (Agent(subagent_type="features-keeper", prompt="audit FEATURES.md")).
Entry format, area list and the pmctl feature commands: .claude/skills/features-update/SKILL.md.
FEATURES.md is generated from the tracker DB: change it only with pmctl feature set/rm/audited, never by editing.
Inventory (build the list from code, not from memory)
Work area by area and collect candidate features from each source:
| Source | Command / place | Gives |
| Routes | Grep '@router\.(get|post)' src/pm | every page and action; group by path prefix (/a, /p, /tmux, /agents, /settings, /dt, ...) |
| Classic templates | src/pm/web/themes/classic/templates/*.html (_name.html are partials of the page that includes them) | visible sections, buttons, tables |
| Classic static JS | src/pm/static/js/*.js | gestures, shortcuts, composer/snippets/dialog behaviour |
| dt templates | src/pm/web/themes/dt/templates/**/*.html (a page here overrides the classic template of the same name; shell/ = the dt shell) | area dt theme: shell, ported pages, layers |
| dt Python | src/pm/web/dt/*.py (routes.py = /dt/..., the rest are view models and v7 stores) | area dt theme: tabs, prefs, page behaviour |
| dt static JS | src/pm/web/themes/dt/static/js/*.js (keys.js = the key table) | area dt theme: shortcuts, search, aside, layers |
| Settings | src/pm/core/config.py, settings.html, _settings_*.html (both themes) | every user-tunable option |
| Slash commands | src/pm/agents/slash.py, src/pm/static/js/slash.js | chat commands |
| Background | src/pm/agents/autoexit.py, notify/alerts.py, notify/ntfy.py, notify/feed.py, agents/recap.py, agents/limits.py | automatic behaviour |
| Tools | tools/, Makefile, deploy/ | dev/ops helpers |
| History | CHANGELOG.md, docs/themes/dt/PARITY.md (what dt does yet) | hints only; confirm in code |
Steps
- Read the entries (
pmctl feature list, orFEATURES.md). If the project has no FEATURES.md yet, create it with the area headings andLast audited:line, thenpmctl import --file features. - Build the inventory. For each candidate decide: user-visible feature, or internal plumbing (skip).
- Missing: candidate with no entry -> read its code and add an entry in the standard format
(
pmctl feature set "<Area>" "<Name>" --text "..."; dt-only behaviour in the areadt theme).Sincefromgit log --diff-filter=A --format=%ad --date=short -1 -- <file>or the changelog; if unknown, omit. - Stale: for each existing entry, Grep that its route / setting / file still exists and the sentence
still matches the code. Fix wording (
pmctl feature set), or delete the entry when the feature is gone (pmctl feature rm). - Duplicates / misplaced: merge duplicates (
setthe kept one,rmthe other); move an entry to the right area bysetin the new area andrmin the old one. pmctl feature audited(setsLast audited: <today>); theSummary: N features in M areas.line is recomputed by pm after any change.- Report: added, changed, removed (names), plus anything unclear that needs the maintainer's call.
Do not
- Document planned work (open issues, the "Open decisions" in
docs/themes/dt/README.md): only shipped behaviour. - Describe security internals beyond the guarantee a user sees.
- Guess: when a feature's purpose is unclear from the code, list it in the report instead of inventing text.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

