workspace-realign

Workspace Realign

Analyze and reorganize documentation in .aiwg/ to ensure it accurately reflects the current project state, plans, and reality. Uses git commit history to understand changes since documentation was last updated.

Parameters

Execution Steps

Step 1: Analyze Current State

Scan .aiwg/ directory structure:

# Count documents by category
find .aiwg -name "*.md" -type f | wc -l

# Get last modification times
find .aiwg -name "*.md" -type f -exec stat -c '%Y %n' {} \; | sort -rn

Report current state:

Workspace Analysis
==================
Total documents: 47
Categories:
  - requirements/    12 docs
  - architecture/     8 docs
  - planning/         6 docs
  - risks/            4 docs
  - testing/          5 docs
  - security/         3 docs
  - working/          9 docs (temporary)

Step 2: Identify Last Documentation Alignment

Find when documentation was last synchronized with code:

1. Check for alignment marker:

   cat .aiwg/.last-alignment 2>/dev/null
   

2. Check git log for doc commits:

   git log --oneline --since="30 days ago" -- .aiwg/
   

3. Find most recent doc update:

   git log -1 --format="%H %ci" -- .aiwg/
   

Report:

Last Alignment
==============
Last doc commit: abc1234 (2025-12-01)
Current HEAD:    def5678
Commits since:   23 commits
Days since:      8 days

Step 3: Analyze Code Changes Since Last Alignment

Compare code changes vs documentation:

# Get changed files since last alignment
git diff --name-only <last-alignment-commit>..HEAD

# Categorize changes
git diff --stat <last-alignment-commit>..HEAD