{{Framework name}}
1. Snapshot
Identify the exact source boundary so another reader can reconstruct every citation and count.
| Field | Value |
|---|---|
| Repository | {{owner/repository}} — {{repository URL}} |
| Pinned commit | {{full 40-character SHA}} — {{permalink to tree at SHA}} |
| Date read | {{YYYY-MM-DD}} |
| Licence | {{SPDX identifier or “not established”}} — {{pinned licence-file permalink}} |
| Languages | {{measured or source-evidenced languages}} |
| Measured scale | {{result}} — {{command, run date, and scope}} |
The SHA is required because a date cannot reconstruct a moving repository. Run measurements against that checkout and say exactly what each command proves; do not use an adjacent metric as evidence.
2. The core loop
Trace one agent turn from input through model decision, action, observation, and termination, naming the pinned files, functions, and executable tests that establish the path.
3. State and persistence
Describe the in-memory state, persisted state, storage boundary, and resume semantics, including what survives a process crash and what is replayed rather than restored.
4. Tools and the outside world
Follow a tool from declaration through schema/validation, invocation, isolation or sandboxing, result handling, and failure return to the agent.
5. Composition
Explain whether the pinned implementation composes agents through handoffs, sub-agents, graphs, or another boundary, and identify what data and control cross that boundary.
6. The human in the loop
Trace interruption, approval, rejection, editing, and steering mechanisms, or state the bounded evidence for their absence.
7. The abstraction bargain
Mark as Opinion the judgement about what the framework makes easy, what it makes hard, and what it deliberately leaves to applications; keep the implementation evidence beside each judgement.
8. What rungs takes
Map findings to the canonical catalogue without redefining patterns or changing the catalogue in a per-framework extraction.
| Pattern id | Verdict | Pinned evidence | Reason |
|---|---|---|---|
{{pattern-id or proposed new id}} | take / take-as-warning / leave | {{permalink or labelled opinion}} | {{what this framework changes about the existing claim}} |