~aod-status

AOD Status Skill

Purpose

Utility skill for the AOD Lifecycle. Provides an on-demand snapshot of the project backlog by regenerating BACKLOG.md from GitHub Issues and displaying a summary of items per lifecycle stage.

No governance gates — this is a read-only utility command.

How It Works

Step 1: Reconcile Board

Run board reconciliation to fix any label↔board column drift before generating the snapshot:

source .aod/scripts/bash/github-lifecycle.sh && aod_gh_reconcile_board

This compares each open issue's stage:* label to its board column and fixes mismatches. If the board or gh is unavailable, it skips silently.

Step 2: Regenerate BACKLOG.md

Run the backlog regeneration script with JSON output mode:

bash .aod/scripts/bash/backlog-regenerate.sh --json

Parse the JSON output to extract:

• file: path to regenerated BACKLOG.md
• total: total number of GitHub Issues
• stages: object with counts per stage (discover, define, plan, build, deliver, untracked)

If the script fails or gh is unavailable: Display a warning and attempt to read the existing BACKLOG.md file instead. If no BACKLOG.md exists either, report that no backlog data is available.

Step 3: Display Stage Summary

Present a formatted summary table:

AOD LIFECYCLE STATUS

| Stage    | Count |
|----------|-------|
| Discover | {n}   |
| Define   | {n}   |
| Plan     | {n}   |
| Build    | {n}   |
| Deliver  | {n}   |
| Untracked| {n}   |
|----------|-------|
| Total    | {n}   |

BACKLOG.md regenerated at {file_path}.

Step 4: Show Active Feature Context (Optional)

If the current git branch matches a feature pattern (NNN-*), display the active feature context:

1. Get branch: git branch --show-current
2. Extract NNN prefix
3. Check for specs/{NNN}-*/ directory
4. If found, read spec.md/plan.md/tasks.md frontmatter to show approval status:

Active Feature: {NNN}-{name}
  spec.md:  {PM approved / not approved / missing}
  plan.md:  {dual approved / not approved / missing}
  tasks.md: {triple approved / not approved / missing}