# Project Memory

> Use to create and maintain durable cross-session project memory and the progress ledger, so long autonomous builds resume cleanly after compaction, restarts, or new sessions. Read it when starting work and update it as decisions and tasks land.

- **Type:** Skill
- **Install:** `agentstack add skill-martian56-claude-engineer-project-memory`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [martian56](https://agentstack.voostack.com/s/martian56)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [martian56](https://github.com/martian56)
- **Source:** https://github.com/martian56/claude-engineer/tree/main/plugins/claude-engineer/skills/project-memory

## Install

```sh
agentstack add skill-martian56-claude-engineer-project-memory
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Project Memory

**Announce at start:** "I'm using claude-engineer:project-memory to keep durable project state."

Long autonomous builds outlive a single context window. Memory lives in **files**, not your head.
The claude-engineer SessionStart hook auto-loads these at the start of every session.

## The state files (in `.claude-engineer/`)
- **`memory.md`** - durable project memory: key decisions (+ why), established conventions, the data model, open threads/risks, and "next action". The single source of truth for *why things are the way they are*.
- **`progress.md`** - the task ledger: each task with status (todo / doing / done), the commit/branch, and a one-line result. Append-only-ish; never delete history.
- **`current-phase.txt`** - one line naming the active phase (e.g. `Phase 2 - Frontend`).
- **`quality-gate-status.json`** - written by the project quality-gate runner; read by the commit gate. Do not hand-edit.

## Iron Law
**Trust the ledger and `git log` over your own recollection.** After compaction, re-read these files before acting. Never re-run a task `progress.md` marks done.

## When to update
- **After every task:** append a line to `progress.md`.
- **On every non-obvious decision:** add it to `memory.md` (mirror big ones into `docs/plan/decisions.md`).
- **On phase change:** update `current-phase.txt`.

## Initialize (Phase 0 / planning)
Create `.claude-engineer/` with seed `memory.md` (problem, stack, data model, decisions-so-far, next action), an empty `progress.md` ledger, and `current-phase.txt`. Add `.claude-engineer/quality-gate-status.json` to `.gitignore` (machine-generated); commit `memory.md`/`progress.md` so teammates and future sessions share them.

## Red flags - STOP
- Starting work without reading `memory.md` + `progress.md` first.
- A decision made in chat but never written down → write it now; chat is not durable.
- Re-deriving something already settled in `memory.md`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [martian56](https://github.com/martian56)
- **Source:** [martian56/claude-engineer](https://github.com/martian56/claude-engineer)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-martian56-claude-engineer-project-memory
- Seller: https://agentstack.voostack.com/s/martian56
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.