OWL-IMPLEMENTATION

Owl of Athena: Implementation

Status: ✅ Implemented
Script: scripts/owl.py
Wrapper: scripts/owl

Quick Start

# Remove closed feature sessions from progress.txt
./scripts/owl prune-done

# Update athena-index.md from current specs (reads tasks.md for status)
./scripts/owl update-index

# Search archived features
./scripts/owl search "linkedin"

# Retrieve feature summary
./scripts/owl retrieve 20260211-athena-walkthrough-example

# Archive a feature (mark as Done in INDEX)
./scripts/owl archive 20260413-my-feature

Commands

prune-done

Remove session blocks for fully-closed features from progress.txt.

A feature is fully closed when ALL three are true:

1. tasks.md — no items under NEXT or IN PROGRESS
2. spec.md — Status: Done
3. PRD.md — feature appears as shipped/complete

Usage: ./scripts/owl prune-done

Output:

{
  "success": true,
  "pruned_features": ["20260213-linkedin-post-variants"],
  "blocks_removed": 3,
  "message": "✅ Pruned 3 session block(s) for 1 closed feature(s)"
}

When it runs: Automatically via the Claude Code Stop hook at session end. Can also be run manually.

update-index

Regenerate athena-index.md from all specs in docs/specs/. Reads tasks.md first to determine Active vs Done status — falls back to spec.md Status field if no tasks.md exists.

Usage: ./scripts/owl update-index

Output:

{
  "success": true,
  "total_features": 19,
  "active": 0,
  "archived": 19,
  "message": "✅ Updated athena-index.md: 0 active, 19 archived"
}

write-memory

Write a Claude Code auto-memory file (project_athena_active.md) to ~/.claude/projects/<encoded-repo>/memory/ containing the active feature, goal, and task state from progress.txt and active features from athena-index.md. Athena reads this at session start and skips re-reading those two files.

Usage: ./scripts/owl write-memory

Output:

{
  "success": true,
  "memory_file": "/Users/.../.claude/projects/-Volumes-T9-code-SKILLS-athena/memory/project_athena_active.md",
  "feature_id": "20260414-owl-memory-bridge",
  "active_features": 1,
  "message": "✅ Wrote memory: 20260414-owl-memory-bridge, 1 active feature(s)"
}