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-core_docs-workflow.md

@@ -0,0 +1,47 @@
+# Autopilot docs workflow token and defaults
+
+Issue Description:
+Docs workflow failed due to missing org context and API access for issue search.
+
+State:
+Workflow reported a configuration error and never ran jobs.
+
+Action:
+Added issues read permission, defaulted ORG to repository owner, and allowed an ORG_READ_TOKEN override.
+
+Result:
+Workflow can run with default org and proper permissions.
+
+Rationale:
+Defaults reduce configuration drift and ensure GitHub API queries succeed.
+
+Diff Patch:
+```diff
+commit 1685a44293505df0fa2d5f7a7aa968a3d81a7261
+Author: Kim Harjamaki <ogeon@msn.com>
+Date:   Mon Dec 22 23:20:48 2025 +0200
+
+    Harden docs workflow token and defaults
+
+diff --git a/.github/workflows/autopilot-docs-daily.yml b/.github/workflows/autopilot-docs-daily.yml
+index 412350c..b26ed43 100644
+--- a/.github/workflows/autopilot-docs-daily.yml
++++ b/.github/workflows/autopilot-docs-daily.yml
+@@ -9,13 +9,14 @@ on:
+ permissions:
+   contents: write
+   pull-requests: write
++  issues: read
+ 
+ jobs:
+   docs:
+     runs-on: ubuntu-latest
+     env:
+-      ORG: ${{ vars.ORG }}
+-      GH_TOKEN: ${{ github.token }}
++      ORG: ${{ vars.ORG || github.repository_owner }}
++      GH_TOKEN: ${{ secrets.ORG_READ_TOKEN || github.token }}
+     steps:
+       - name: Checkout
+         uses: actions/checkout@v4
+```

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"