feat: initial agent template (v1.0.0)

MEMORY.md

@@ -0,0 +1,80 @@
+# MEMORY
+
+Long-term memory for [AGENT_NAME]. This file accumulates important decisions, context, and learnings across sessions.
+
+The agent reads this at the start of sessions (or when recovering context) to restore continuity.
+
+---
+
+## How to Use This File
+
+- **Add entries** when something important is decided, discovered, or learned
+- **Tag entries** with `[DECISION]`, `[CONTEXT]`, `[LEARNING]`, `[HANDOFF]`, or `[WATCH]`
+- **Date entries** so they can be evaluated for freshness
+- **Remove stale entries** — outdated memory is worse than no memory
+- **Keep it scannable** — use headers and bullets, not paragraphs
+
+---
+
+## Decisions
+
+<!-- Record important decisions made during the project -->
+<!-- Format: ### [DATE] [DECISION] Topic -->
+<!-- Example:
+### 2024-01-15 [DECISION] Auth strategy
+Went with JWT over sessions. Reason: stateless, easier to scale across multiple services.
+Revisit if we ever need server-side session invalidation.
+-->
+
+_No decisions recorded yet._
+
+---
+
+## Context
+
+<!-- Background info the agent needs to operate effectively -->
+<!-- Things that aren't obvious from reading the code -->
+<!-- Example:
+### [CONTEXT] Why the API uses v1 prefix everywhere
+The v0 API is still live for legacy clients. All new work goes to v1. Never touch /v0 routes.
+-->
+
+_No context recorded yet._
+
+---
+
+## Learnings
+
+<!-- Things discovered through trial and error -->
+<!-- Example:
+### [LEARNING] GitHub Actions cache
+The cache key must include the lock file hash or the cache never invalidates properly.
+Spent 2 hours debugging this — don't make the same mistake.
+-->
+
+_No learnings recorded yet._
+
+---
+
+## Watch List
+
+<!-- Things to keep an eye on — potential issues, tech debt, upcoming changes -->
+<!-- Example:
+### [WATCH] Dependency: stripe SDK
+Pinned to 12.x — v13 has breaking changes in webhook handling. Check before upgrading.
+-->
+
+_Nothing on the watch list._
+
+---
+
+## Handoffs
+
+<!-- Notes left for other agents or for future sessions after a context gap -->
+<!-- Example:
+### 2024-01-20 [HANDOFF] From: Iggy → To: Next session
+Left off mid-way through the auth refactor. PR #42 is open and passing CI.
+Remaining: need to update the session middleware to use the new token format.
+-->
+
+_No handoffs recorded._