# GitHub + Ambience

> Use GitHub activity as source-linked engineering memory.

GitHub holds the code history. Ambience captures the reasoning future agents need before editing the code again: decisions, review conventions, failure modes, and implementation references.

## Why Ambience

- Ambience is not a repository crawler.
- Ambience stores concise, redacted memories with GitHub source metadata.
- Future agents can retrieve prior review context before opening the next PR.

## Example memories

- Convention: Keep middleware public path changes covered by route tests. Source: GitHub PR.
- Pattern: Use preview/apply tokens for admin mutations. Source: GitHub issue.

## Related

- [Ambience for Codex](https://ambience.sh/agents/codex)
- [Reusable team skills](https://ambience.sh/skills)