Resources
Examples
Practical workflows and durable memory records.
These templates demonstrate the record shape defined by AGENTS.md. Their project names, paths, commands, and outcomes are illustrative placeholders—not claims about the canonical Agent Needle repository. Replace every value with evidence from the repository where Agent Needle is installed.
Resuming an interrupted change
## [Task name]
- Objective: [Observable outcome].
- Status: [In progress or blocked].
- Verified progress: [Only checks actually completed].
- Remaining work: [Specific unfinished work].
- Blocker: [Current blocker, or none].
- Exact next action: [One evidence-backed next step].
- Relevant files: [Verified repository paths].The next session can resume without replaying every earlier conversation.
Recording a verified fact
# [State topic]
- Fact: [Current verified fact].
- Observed: [YYYY-MM-DD].
- Source: [Repository file, documentation, or observed system state].
- Status: Current.Recording a decision
# [Decision title]
- Date: [YYYY-MM-DD]
- Status: Accepted
- Context: [Verified situation requiring a choice].
- Decision: [Chosen option].
- Alternatives: [Options actually considered].
- Rationale: [Evidence and tradeoffs].
- Consequences: [Expected effects and follow-up].Checkpointing a failure
Record what failed, the exact check, and what remains unknown. Do not claim the feature works because compilation succeeded if the requested runtime behavior was never exercised.