# Engineering Log — [Short title]

**Timestamp:** [UTC date/time]
**Author / agent:** [Name or agent ID]
**Project / task:** [Name and issue link]
**Status:** [In progress / Blocked / Ready for review / Done]
**Code version:** [Repository, branch, commit]

## Objective

[What are we trying to achieve? What constitutes success?]

## Starting context

* Relevant prior findings: [Links or entry IDs]
* Environment: [Versions, hardware, configuration]
* Constraints: [Compatibility, budget, permissions]

## Work performed

* [Change or action, with file/PR/artifact references]
* [Why this approach was chosen]

## Verification

| Check / command | Expected | Observed | Evidence |
| --- | --- | --- | --- |
| [Test or experiment] | [Success criterion] | [Actual result] | [Log/artifact link] |

**Not verified:** [Remaining checks or limitations]

## Findings and reusable know-how

* **Finding:** [What was learned]
* **Applies when:** [Relevant versions, configuration, conditions]
* **Evidence:** [Exact file, log line, result, or URL]
* **Verification state:** [Hypothesis / Observed once / Reproduced / Independently verified]
* **How to reproduce:** [Minimal steps or command]

## Failed attempts

* **Attempt:** [What was tried]
* **Observed failure:** [Error or unexpected behavior]
* **Cause:** [Confirmed cause or explicitly labeled hypothesis]
* **Retry if:** [What must change to make another attempt useful]

## Decisions

* **Chosen:** [Approach]
* **Reason:** [Evidence and trade-off]
* **Revisit when:** [Condition that would change the decision]

## Blockers / open questions

* [Missing input or unresolved question]
* **Needed from:** [Person, agent, or system]

## Handoff

* **Current state:** [What works; what remains incomplete]
* **Next action:** [Specific executable step]
* **Working state:** [Commit, uncommitted changes, running job/checkpoint]
* **Artifacts:** [Durable links accessible to the next agent]
* **Watch out for:** [Pitfalls or conflicting findings]