# Codex Project Memory

> Use for project memory, decisions, handoffs, genome, knowledge index, changelog, and patterns that must persist across sessions.

- Skill: `bang-isme/codex-project-memory` (Agent Skill, multi-file: 44 files)
- Install (CLI): `npx skillmds@latest add bang-isme/codex-project-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bang-isme/codex-project-memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Bang-isme (https://skillmd.com/u/bang-isme)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bang-isme/codex-project-memory

---


## TL;DR
12 scripts for project knowledge persistence. Decision tree: Log -> decision/feedback/skill-usage. Generate -> changelog/session-summary/handoff/growth-report. Analyze -> patterns/knowledge-graph/knowledge-index/project-genome. Maintain -> compact old context. Triggers: `$changelog`, `$growth-report`, `$session-summary`, `$log-decision`, `$compact-context`, `$knowledge`, `$codex-genome`.

# Codex Project Memory

## Activation

1. Activate after complex tasks involving architecture, design decisions, or refactors.
2. Activate on explicit `$codex-project-memory` or `$memory`.
3. Activate on explicit command `$log-decision`.
4. Activate on `$handoff` or when user asks to generate handoff context.
5. Activate on `$session-summary` or when user asks to summarize a coding session.
6. Activate on `$analyze-patterns` or "learn project style".
7. Activate on `$log-feedback` or "track my fix".
8. Activate on `$feedback-summary` for aggregated feedback recall.
9. Activate on `$skill-track` to record skill usage analytics.
10. Activate on `$skill-report` to generate skill evolution report.
11. Activate on `$build-graph` or "map project" to generate project knowledge graph.
12. Activate on `$changelog` to generate release-oriented commit summaries.
13. Activate on `$growth-report` to generate a developer growth report.
14. Activate on `$compact-context` or "clean up old sessions".
15. Activate on `$codex-genome`, `$generate-genome`, or `$genome` to create layered project context docs.
16. Activate on `$knowledge`, "make tacit knowledge visible", or "build knowledge index" to generate `.codex/knowledge/INDEX.md`, `.codex/knowledge/index.json`, `.codex/knowledge/knowledge-graph.json`, and an offline interactive `.codex/knowledge/index.html`.
17. Activate on "memory status", "validate project memory", or before CLI/tool-harness handoff to run `scripts/memory_status.py` against generated artifacts.

## Decision Tree Routing

```
User intent -> Memory action?
    |- Log/record -> What?
    |   |- Decision -> decision_logger.py
    |   |- Feedback -> track_feedback.py
    |   `- Skill usage -> track_skill_usage.py
    |
    |- Generate/export -> What?
    |   |- Handoff -> generate_handoff.py
    |   |- Session recap -> generate_session_summary.py
    |   |- Changelog -> generate_changelog.py
    |   `- Growth report -> generate_growth_report.py
    |
    |- Analyze -> What?
    |   |- Patterns -> analyze_patterns.py
    |   |- Dependencies -> build_knowledge_graph.py
    |   |- Tacit knowledge index -> build_knowledge_index.py
    |   `- Context genome -> generate_genome.py
    |
    |- Maintain -> What?
    |   `- Compact old memory -> compact_context.py
    |
    `- Not memory -> skip
```

## Rules

- Use the decision tree to choose one memory action before invoking scripts.
- Run `--help` before invoking helper scripts and treat them as black-box tools unless customization or bug fixing is required.
- Review existing files in `.codex/decisions/` before logging a similar technical choice.
- Use the default output paths and chaining guidance from `references/behavior-guide.md` unless the user requests overrides.
- Return the created path plus the headline metrics from each script JSON payload.
- See `skills/.system/REGISTRY.md` for full script paths.

## Reference Files

- `references/decision-journal-spec.md`: decision logging criteria and naming conventions.
- `references/handoff-spec.md`: handoff usage guidance.
- `references/session-summary-spec.md`: session summary workflow and retention guidance.
- `references/changelog-spec.md`: release-focused changelog generation rules.
- `references/growth-report-spec.md`: developer growth analytics and reporting behavior.
- `references/pattern-learner-spec.md`: project style learning behavior.
- `references/feedback-tracker-spec.md`: feedback logging and aggregate usage.
- `references/skill-evolution-spec.md`: skill usage analytics and optimization.
- `references/knowledge-graph-spec.md`: deep architecture mapping and refresh guidance.
- `build_knowledge_index.py`: schema-versioned project knowledge index from genome, role docs, decisions, commits, config, and the structural knowledge graph; redacts secret-like values, stores provenance/confidence, and writes an offline interactive HTML dashboard for AI and human review.
- `references/knowledge-index.schema.json`: output contract for `.codex/knowledge/index.json`.
- `references/knowledge-graph.schema.json`: output contract for `.codex/knowledge/knowledge-graph.json` and `.codex/knowledge-graph.json`.
- `references/context-compactor-spec.md`: retention policy, archive layout, and dry-run expectations.
- `references/behavior-guide.md`: detailed per-script behaviors, defaults, and chaining guidance.
- `references/script-commands.md`
- `references/output-schemas.md`
- `references/project-memory-tools.json`: machine-readable tool manifest for CLI/MCP-style harness generation.
- `references/project-memory-tools.schema.json`: schema for the tool manifest.
- `references/ci-readiness.md`: release gate commands, strict mode, and Windows symlink deselection.
- `references/scale-sla.md`: scale tiers, `run_scale_gate.py` report, and CI workflow mapping for large codebases.
- `references/artifact-lifecycle-policy.md`: hybrid commit policy for schemas vs generated `.codex/` artifacts.