reconcile

Verifies board cards and memos against GitHub state and corrects stale records.

1|Updated Nov 21, 2015
One-click install
npx skills add https://github.com/mark-brannan/dotfiles --skill reconcile-mark-brannan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reconcile
Source: https://github.com/mark-brannan/dotfiles/tree/main/.claude/skills/reconcile
Command: npx skills add https://github.com/mark-brannan/dotfiles --skill reconcile-mark-brannan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project boards and decision memos drift out of sync with reality: cards claim a PR is awaiting review weeks after it merged, memos stay silent about being superseded, and blocked issues linger past their blockers. This Skill mechanically checks every written claim against GitHub via gh and corrects the record with proof. ## Core Features & Use Cases - State verification: Runs gh pr view / gh issue view on every card and memo with a linked PR, issue, or ADR to detect merged, closed, or newly updated items. - Direct corrections: Prefixes done cards with dated done/ruled markers, appends dated superseded annotations to stale memos, and relabels unblocked issues from blocked to ready with evidence in the commit message. - Blocked-issue expiry checks: Parses Blocked by lines on open issues, resolving both issue-reference blockers and date-based waits against the current UTC date. - Use Case: Run it each morning so a card saying "awaiting review" on a PR merged last week is corrected to "Done 2024-05-01 — PR #42" with the gh output committed as proof. ## Quick Start Ask the assistant to reconcile the board so it checks every card and memo against GitHub and commits the corrections with proof.

Frequently Asked Questions about reconcile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if board cards match actual GitHub PR status?▼

Run the reconcile flow, which calls gh pr view and gh issue view for every card and memo with a linked PR or issue. Mismatches like merged PRs still marked open are corrected directly with a dated prefix and proof link.

How to automatically unblock GitHub issues when their blocker closes?▼

The skill reads each blocked issue's Blocked by line, checks the referenced issue or PR state with gh, and relabels from blocked to ready when the blocker is closed or merged. The proof goes into the commit message and a one-line issue comment.

Does reconcile decide which record is correct when sources conflict?▼

No. It only fixes cases where the written record contradicts verifiable gh output. When both versions could be right, it flags the item as a candidate for the /sequence skill instead of making a judgment call.

What happens to unresolved Pending questions on cards?▼

Pending tails without a typed contract are not answered in place. They are rewritten as proper cards with an explicit input question and output type, or handed to /sequence when they need immediate judgment.

When should I run reconcile versus sweep?▼

Run reconcile to correct stale facts anywhere in the board or memos, and /sweep to prune and rerank the Needs ruling section. They are complementary and meant to run one after the other, not as substitutes.