aod.document

User Input

$ARGUMENTS

Consider user input before proceeding (if not empty).

Step 0a: Parse --autonomous

1. If $ARGUMENTS contains --autonomous:
   • Set autonomous = true
   • Strip --autonomous from $ARGUMENTS (trim extra whitespace)
2. If $ARGUMENTS does NOT contain --autonomous:
   • Set autonomous = false

Overview

Post-delivery quality review for the completed feature. This is Stage 6 of the AOD lifecycle — the one stage designed for human judgment. Each step presents findings interactively and commits only what the human approves.

Flow: Validate context → Branch → Code simplification → Docs-lint → CHANGELOG → API sync → KB review → PR squash-merge → Report

IMPORTANT: Execute ALL steps 0–7 sequentially. Do not stop or wait for further instructions between steps. After completing each step (including user interaction), immediately proceed to the next step until the Step 7 Report is displayed.

Step 0: Validate Context

1. Get branch: git branch --show-current
2. Determine feature number NNN:
   • If on a NNN-* branch: extract NNN from branch name
   • If on main: extract NNN from user input $ARGUMENTS, or detect from most recent feat(NNN) or docs(NNN) commit on main
   • If NNN cannot be determined: prompt the user for the feature number
3. Find tasks: specs/{NNN}-*/tasks.md → verify all tasks marked [X] (build complete)
4. If tasks incomplete: warn "Build may not be complete — {incomplete_count} tasks remain" and ask whether to proceed
5. Display: "Document stage for Feature {NNN}"

Step 0b: Create Document Branch

1. If not already on main: git checkout main && git pull origin main
2. Create branch: git checkout -b {NNN}-document-stage
3. Display: "Working on branch {NNN}-document-stage"

Step 1: Code Simplification

Detect changed code files and run /simplify for human review.

1a: Detect Changed Files

1. Run: git diff --name-only main...HEAD
2. Filter to code extensions: .py, .js, .ts, .jsx, .tsx, .sh, .go, .rs, .java, .rb, .swift, .kt
3. Exclude: *.lock, *.min.js, *.min.css, *.map, *.generated.*, vendor/, dist/, build/, node_modules/, .aod/, docs/
4. Store as changed_files list and file_count
5. If file_count is 0: display "No code files changed — skipping simplification", proceed to Step 2
6. If file_count > 50: warn "Large diff ({file_count} files). Simplify may take several minutes." and ask whether to continue or skip