Menu
Use when existing `.aoa` session archives need generated segment Markdown and indexes rebuilt from preserved raw JSONL after taxonomy, classifier, relationship, or index-schema changes.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when a `.aoa` session-memory root must be created, installed, checked, repaired, or prepared for Codex hook-based session archiving.
Use when an indexed `.aoa` session needs provisional first-pass distillation into lessons, decisions, failures, and automation candidates without promoting them to reviewed truth.
Use when an agent needs evidence from prior `.aoa` sessions about how a skill, MCP, hook, tool, API, goal, eval, test, validator, script, decision, error, receipt, or other recurring operational entity was used, what happened nearby, and which raw or segment refs prove it.
Use in any Codex session when the user mentions `.aoa`, session memory, Codex transcripts, compaction, prior session rehydration, hook failures, or AoA session-memory validation.
Use when an agent needs to build or query the portable `.aoa` SQLite search index for archived Codex sessions, with evidence refs and freshness checks.
Use when the live Codex PreCompact and PostCompact hook path must be proven through `.aoa` using the Codex app-server compact probe.
| name | aoa-session-reindex |
| description | Use when existing `.aoa` session archives need generated segment Markdown and indexes rebuilt from preserved raw JSONL after taxonomy, classifier, relationship, or index-schema changes. |
| license | Apache-2.0 |
| metadata | {"aoa_scope":"session-memory","aoa_invocation_mode":"manual"} |
Use this when the archive already has raw JSONL but generated segment indexes need to be regenerated under the current classifier.
segments/*.index.json without re-importing raw.Start with a dry run:
python3 scripts/aoa_session_memory.py reindex-sessions all \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--dry-run \
--write-report
For a bounded smoke pass:
python3 scripts/aoa_session_memory.py reindex-sessions all \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--limit 10 \
--write-report
For one target session:
python3 scripts/aoa_session_memory.py reindex-sessions <session-label-or-id> \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--write-report
After a classifier or schema reindex, refresh generated projections through the named catch-up route:
python3 scripts/aoa_session_memory.py projection-catchup all \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--apply \
--write-report
Use --profile deep only when the catch-up payload reports that a heavy full
search rebuild or graph repair is required.
counts.diagnostic is absent or zero.by_family, by_phase, by_actor,
by_action, by_outcome, and by_correlation.projection-catchup reports no remaining projection backlog, or returns the
explicit next route needed to finish it.projection-status reads the latest projection-catchup completeness packet
without running the writer route, and uses cached maintenance diagnostics
unless --refresh-maintenance is explicitly requested.doctor, audit, and tests after broad reindexing.Do not delete raw JSONL or distillation artifacts. Reindex regenerates generated segments and indexes from raw evidence; it is not a semantic promotion step.