# sample — eeco project brief

Written by `eeco go`: a deterministic, no-AI-spend project brief.
Read this once instead of scanning the tree, then open the files
named under "Where to look" for detail.

## Working with eeco

This repo uses eeco — a local tool that keeps project memory and a
decision queue so an assistant carries durable context across
sessions. Commands you can run (read-only, safe by default):

- `eeco go` — print this brief
- `eeco doctor` — workspace and configuration diagnostics
- `eeco run <workflow>` — run a workflow (builtins: bug-sweep, cockpit-sync, comment-hygiene, doc-drift, evolve, gate, handover-refresh, leak-guard, manifest-refresh, memory-drift, version-sync)
- `eeco gc` — memory garbage collection

Findings and decisions go to eeco's queue, not silent edits to the
tracked tree.

## Project

- profile: go
- gate: go vet ./...
- top-level: cmd, docs, go.mod

## Where to look

- external API reference → `docs/api.md`
- auth flow lives here → `internal/auth/auth.go`

## What eeco knows

- auth-flow — auth flow lives here (project)
- terse-comments — keep comments terse (feedback)

## Recent notes

- 2026-01-03 09:00 — Investigate cache eviction
- 2026-01-02 14:30 — Open question about hook chain
- 2026-01-01 11:15 — Sketch refactor for module split

## Open decisions

2 open:
- **finding** — comment-hygiene flagged a tooling string _(sample, 2026-01-01)_
- **handover** — draft handover ready for review _(sample, 2026-01-01)_

## Recording back

Keep this brief useful for the next session: record durable facts
in eeco's memory store and route findings and decisions through its
queue rather than acting silently. Run `eeco doctor` if anything
here looks stale.