Zum Inhalt springen
TakoAPI
Zurück zu den Skills

flatnotes-tasksmd-github-audit

von branexp

Git & GitHub
1.3kDownloadzahlen laut clawskills.sh
1Sterne
0Aufrufe
0 LikesMelde dich an, um diesen Skill zu liken
—Noch nicht bewertet
Deine Bewertung

Kurzbeschreibung

Thoroughly audit Tasks.md +.

Beschreibung

Was dieser Skill macht

Audits Tasks.md and Flatnotes for drift and accuracy, using GitHub as the source of truth. Checks board hygiene (lane rules, WIP limits, card formatting), verifies required project notes exist in Flatnotes, and reconciles open and merged PRs with task cards and project logs. Outputs a Markdown and JSON report, with optional safe auto-fixes.

Cross-references Tasks.md, Flatnotes, and GitHub in a single pass, catching drift across all three systems that manual review would miss.

Wann du ihn einsetzt

  • Checking if open GitHub PRs have a corresponding task card
  • Finding merged PRs not reflected in project logs or Done cards
  • Detecting prio-p2 cards misplaced in the Next lane
  • Verifying required Flatnotes project notes exist for each active project
  • Auditing task cards for missing Flatnotes pointers

Beispiel-Workflow

EINGABE

User asks: Audit my project system for drift over the last 30 days

AGENT
  1. 1

    Parse the project registry from Flatnotes to extract slugs, statuses, and GitHub repo URLs

  2. 2

    Scan Tasks.md to index cards by lane and tag, flagging lane violations and missing Flatnotes pointers

  3. 3

    Scan Flatnotes to verify required project notes exist and hub notes include ADR links

  4. 4

    Cross-check GitHub open and recently merged PRs against task cards using PR URLs and title heuristics

  5. 5

    Generate a Markdown and JSON report listing per-project drift and a fix plan

AUSGABE

tmp/flatnotes-tasksmd-audit.md and tmp/flatnotes-tasksmd-audit.json with a summary, per-project drift list, and optional safe auto-fix suggestions

Voraussetzungen

  • gh CLI installed and authenticated to GitHub
  • Flatnotes instance with data accessible at the configured path
  • Tasks.md data present at the configured path

Installation

clawhub install branexp/flatnotes-tasksmd-github-audit

Führe den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.

Links