minutes-lint

1# /minutes-lint
2 
3Run a consistency check across policy-authorized normal meetings to find
4decision conflicts and stale commitments. Restricted meetings are excluded from
5this agent workflow by default and must never be described as absent evidence.
6 
7## How to run the lint
8 
91. **Run the consistency check**:
10   ```bash
11   minutes consistency --stale-after-days 14
12   ```
13 
14   Optional filters:
15   - `--owner <name>` — limit to commitments assigned to a specific person
16   - `--stale-after-days <N>` — change the staleness threshold (default: 7)
17 
182. **Parse the JSON output** and present it as readable markdown.
19 
20## Formatting the report
21 
22### Decision Conflicts
23 
24For each conflict, show:
25 
26```
27**Topic: {topic}**
28- Latest: "{latest decision text}" — *{meeting title}* ({date})
29- Prior: "{prior decision text}" — *{meeting title}* ({date})
30- **Status**: These decisions may contradict each other.
31```
32 
33**Frontmatter v2: resolved supersessions.** When the `resolution` field is
34present on a conflict, the newer decision has a `supersedes:` entry in its
35frontmatter. Treat this as informational, not a red flag. Format as:
36 
37```
38**Topic: {topic}** ✓ Resolved
39- Current: "{latest decision text}" — *{meeting title}* ({date})
40- Superseded: "{prior decision text}" — *{meeting title}* ({date})
41- **Status**: {resolution text}
42```
43 
44If the latest decision also carries an `authority` field (`high`/`medium`/`low`),
45surface it next to the title. Authority is optional — when absent, omit the tag.
46…