# Project memory starter kit

Use these files inside one dedicated local project folder. Review every statement before asking Codex to save it.

## `memory/PROJECT.md`

```md
# Project

## Purpose

## Audience

## Desired outcome

## Stable constraints

## Current state

## Open questions
```

Review prompt:

> Interview me for the stable purpose, audience, constraints, and current state of this project. Mark uncertain statements as proposed. Update `memory/PROJECT.md` only after I confirm the summary.

## `memory/DECISIONS.md`

```md
# Decisions

## YYYY-MM-DD — Decision title

- Decision:
- Why:
- Alternatives considered:
- Consequences:
- Owner:
```

Review prompt:

> Identify choices we have already committed to. For each choice, show the evidence, rationale, and date. Ask me to confirm each decision before updating `memory/DECISIONS.md`.

## `memory/LEARNINGS.md`

```md
# Learnings

## Learning title

- Observation:
- Evidence:
- When to apply:
- When not to apply:
```

Review prompt:

> Identify reusable lessons from the work so far. Separate evidence from interpretation and ask me to confirm each lesson before updating `memory/LEARNINGS.md`.

## End-of-session habit

- Update `PROJECT.md` when the stable purpose, audience, constraints, or current state changes.
- Update `DECISIONS.md` after a choice is confirmed.
- Update `LEARNINGS.md` after evidence reveals something worth reusing.
- Start a fresh Codex chat occasionally and test whether these files are sufficient to continue accurately.