# Hindsight Project Memory

This project uses Hindsight as durable project memory.

Local config (not committed):
- `hindsight.env`

Default commands:

```bash
hj status
hj recall "<task/query>"
hj retain "<summary>"
hj reflect "<question>"
```

## Required Agent Workflow

Before non-trivial work:
1. Read `hindsight.env`.
2. Run `hj status` to confirm URL/bank.
3. Run `hj recall "<user task + relevant keywords>"`.
4. Use returned memories as project context.

During work:
- Do not store secrets, tokens, passwords, cookies, or private credentials.
- Redact sensitive values before retaining.
- Track file paths, decisions, commands, tests, errors, blockers, and next steps.

After meaningful work:
1. Run `hj retain "<session summary>"`.
2. Include:
   - task/request
   - decisions made
   - files changed
   - commands/tests run
   - errors/blockers
   - next steps
   - branch/commit if any

If using opencode:
- Prefer `opencode-hj "<task>"` instead of raw `opencode run`.
- It automatically does recall, logs output, and retains a session summary.

## Bank

This project should use bank:

```text
wagw-saas
```