~aod-score

AOD Re-Score Skill

Purpose

Update an existing idea's ICE (Impact, Confidence, Effort) score when circumstances change, new information emerges, or priorities shift. Reads from and writes to the idea's GitHub Issue.

Source of Truth

GitHub Issues are the sole source of truth for backlog items. All idea state (ICE scores, status, evidence) is stored in the GitHub Issue body. BACKLOG.md is an auto-generated view regenerated from Issues.

Inputs

• NNN, #NNN, or IDEA-NNN (legacy): The identifier of the idea to re-score (from user arguments)

Workflow

Step 1: Parse Input

Extract the idea identifier from user arguments. Accept three formats:

• NNN (bare number, e.g., 21): Direct GitHub Issue lookup
• #NNN (hash-prefixed, e.g., #21): Strip # prefix, direct lookup
• IDEA-NNN (legacy, e.g., IDEA-009): Search issue titles for [IDEA-NNN] bracket tag

If invalid or missing, display usage: Usage: /aod.score NNN (or #NNN or IDEA-NNN)

Step 2: Find GitHub Issue

Search for the matching GitHub Issue:

For numeric input (NNN or #NNN):

source .aod/scripts/bash/github-lifecycle.sh && aod_gh_find_issue NNN

For legacy IDEA-NNN input:

source .aod/scripts/bash/github-lifecycle.sh && aod_gh_find_issue "[IDEA-NNN]"

If no issue is found, display an error and exit:

Error: No GitHub Issue found for {identifier}

Step 3: Read Current Scores

Read the GitHub Issue body using gh issue view {number} --json body,title. Parse the structured body to extract:

• Description (from ## Idea section or title)
• ICE scores (from ## ICE Score section)
• Source (from ## Metadata section)
• Status (from ## Metadata section)
• Evidence (from ## Evidence section)

Step 4: Display Current Scores

Show the existing idea details:

CURRENT SCORES — #{issue_number}

GitHub Issue: #{issue_number}
Idea: {description}
Source: {source}
Date: {date}
Status: {status}

ICE Score: {total} (I:{impact} C:{confidence} E:{effort})
Priority Tier: {tier}