Add memory guidelines and fix recording script

Author: Kim Harjamaki

AGENTS.md

@@ -0,0 +1,21 @@
+# Codex Agent Guidelines
+
+## Memory of successful fixes
+- After each successful fix, write a memory entry in `memory/examples/`.
+- Each entry must include: Issue Description, State, Action, Result, Diff Patch, and Rationale.
+- Keep entries short, factual, and scoped to the repo.
+- If a fix is later invalid, annotate the entry with an "Outdated" note instead of deleting it.
+
+## Verification and retries
+- Always verify changes by running the relevant workflow/test when possible.
+- If verification fails, adjust strategy and retry with a clean state; avoid compounding changes.
+- Stop after 2-3 failed attempts and surface a clear summary for human review.
+
+## Safety and scope
+- Make minimal, targeted changes. Avoid unrelated refactors.
+- Use least-privilege tokens; prefer `GITHUB_TOKEN`, fall back to PAT secrets only when required.
+- Do not assume files or APIs exist; confirm before using them.
+
+## Cross-repo reuse
+- Reuse patterns from `memory/examples/` when a new issue matches prior symptoms.
+- Keep project-specific details inside project memory entries only.

memory/examples/20251222_autopilot-demo_nonfailing.md

@@ -0,0 +1,40 @@
+# Autopilot demo CI made non-failing
+
+Issue Description:
+Demo CI intentionally exited with code 1, causing permanent failure.
+
+State:
+Workflow failed on every run by design.
+
+Action:
+Replaced the failing step with a non-blocking demo step.
+
+Result:
+Demo CI now passes on dispatch and push.
+
+Rationale:
+Demo workflows should validate plumbing without breaking CI status.
+
+Diff Patch:
+```diff
+commit 0ef24b2523aefde86fdafc496ba248681bf059e5
+Author: Kim Harjamaki <ogeon@msn.com>
+Date:   Mon Dec 22 23:12:45 2025 +0200
+
+    Make demo CI non-failing
+
+diff --git a/.github/workflows/demo-ci.yml b/.github/workflows/demo-ci.yml
+index 2d57f3e..2c7758c 100644
+--- a/.github/workflows/demo-ci.yml
++++ b/.github/workflows/demo-ci.yml
+@@ -9,7 +9,6 @@ jobs:
+   demo:
+     runs-on: ubuntu-latest
+     steps:
+-      - name: Intentional failure
++      - name: Demo sanity
+         run: |
+-          echo "Simulated failure for Autopilot demo."
+-          exit 1
++          echo "Simulated demo step (non-blocking)."
+```

scripts/record-fix.ps1

@@ -0,0 +1,45 @@
+param(
+  [Parameter(Mandatory=$true)][string]$Issue,
+  [Parameter(Mandatory=$true)][string]$State,
+  [Parameter(Mandatory=$true)][string]$Action,
+  [Parameter(Mandatory=$true)][string]$Result,
+  [Parameter(Mandatory=$true)][string]$Rationale,
+  [string]$Title = "Fix summary",
+  [string]$Commit = "HEAD"
+)
+
+$ErrorActionPreference = "Stop"
+$repoRoot = Resolve-Path (Split-Path -Parent $MyInvocation.MyCommand.Path) | Split-Path -Parent
+$memoryDir = Join-Path $repoRoot "memory\examples"
+if (-not (Test-Path $memoryDir)) { New-Item -ItemType Directory -Path $memoryDir | Out-Null }
+
+$timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
+$diff = git -C $repoRoot show --no-color $Commit
+$path = Join-Path $memoryDir ("{0}_fix.md" -f $timestamp)
+
+$content = @"
+# $Title
+
+Issue Description:
+$Issue
+
+State:
+$State
+
+Action:
+$Action
+
+Result:
+$Result
+
+Rationale:
+$Rationale
+
+Diff Patch:
+```diff
+$diff
+```
+"@
+
+$content | Set-Content -Path $path -Encoding UTF8
+Write-Host "Wrote memory entry: $path"