Preserve lessons from production incidents and near misses in a timestamped ledger. Consult relevant entries before database or release changes, and record each new lesson with a concrete rule and a test or automated check.
中文简介正在准备中。当前显示英语简介。
The project's episodic memory: a timestamped ledger of rules paid for with real outages and near-misses, one entry per incident, plus `work/`: the plans, designs and open thoughts behind planned or parked work. Load WHENEVER you write or review a DB migration or schema change, touch deploy/release workflows (.github/workflows/deploy-*, promote.yml, vercel config), plan a promote/release, respond to a prod incident, or when another skill references a learning. ALSO load after resolving any incident or near-miss: it must leave a new ledger entry in the same session. ALSO load before picking up or planning a larger initiative (goals, workflows, the factory as a state machine), and to persist a plan or open thought so someone else can continue it.
安装前可以查看交给 AI 代理的指令内容。
Every rule this repository paid for with downtime or a near-miss is one entry in a timestamped, append-only ledger. The ledger is the full history, in the order it was learned.
| Path | What it is |
|---|---|
MEMORY.md | The index. One line per entry, newest first: recorded time (UTC) and the rule. Generated. |
entries/<YYYY-MM-DDTHHMMSSZ>-<slug>.md | One entry. The filename timestamp is when it was recorded. |
scripts/new-entry.sh | Starts a new entry stamped with the current UTC time and rebuilds the index. |
scripts/index.sh [--check] | Rebuilds MEMORY.md from entries/, or fails if it is stale. |
work/<topic>/ | Plans, designs and open thoughts for planned, in-flight or parked work. Living documents, not part of the ledger. Index and rules: work/README.md. |
Entries recorded before 2026-09-25 were split out of the old single-file register. Their
recorded time is the commit that first wrote them (commit in the frontmatter).
grep -i '<keyword>' .agents/skills/learnings/MEMORY.md
grep -ril '<keyword>' .agents/skills/learnings/entries/
migration, CONCURRENTLY, deploy-dev, promote,
wake, Stop, gateway, preview, the file or route name.Done when every entry that names the surface you touch has been read.
Record in the same session. An incident that leaves no entry is not finished.
.agents/skills/learnings/scripts/new-entry.sh "<the rule, as an imperative>" [incident-date]
MEMORY.md in the same commit.Done when scripts/index.sh --check exits 0 and the entry is committed.
supersedes: <entry filename> in its frontmatter and state what changed.recorded in the frontmatter matches the
filename. It is the time of recording, never the incident date. The incident date goes
in incident_date.MEMORY.md is generated. Run scripts/index.sh after any entry change. It merges
with git's union driver, so two branches that each add an entry do not conflict. A
GitHub squash merge keeps a branch's index line where the branch put it, so the order
on main can drift until the next index.sh run. index.sh --check and
tests/unit/learnings-ledger.test.ts compare the lines, not their order: they fail on a
missing, extra, or retitled index line, or a malformed entry.PR #1234).entries/ is the only incident record.
Do not write a separate incident, RCA, spec, or runbook file, and do not link one.
The repository has no docs/ tree, and the pre-commit hook rejects new files under it.<session_id>.还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Review Slack access requests against Okta role and team information, then prepare narrowly scoped GitHub or AWS IAM permissions. Apply changes only after an eligible person's approval and record the grant, reasoning, approver, and timestamp.
中文简介正在准备中。当前显示英语简介。
Research companies and people before outreach or meetings. Combines business profiles, recent news, hiring signals, and key contacts into a sourced brief with talking points and suggested questions, adding relationship history when CRM data is connected.
中文简介正在准备中。当前显示英语简介。
Review daily Google Ads and Meta Ads results for budget pacing, declining performance, and unusual activity. Get prioritized findings with supporting numbers and concrete recommendations for a marketing team to assess and carry out.
中文简介正在准备中。当前显示英语简介。
Automate website tasks such as navigating pages, filling forms, clicking buttons, taking screenshots, and extracting data. The skill also supports web app testing, with specialized guides for Electron desktop apps, Slack, and cloud browsers.
中文简介正在准备中。当前显示英语简介。
Process emailed vendor invoices by extracting details, comparing them with purchase orders and invoice history, and recording duplicates, overcharges, or missing orders. Summarize results in Slack for human review; payment approval and execution remain with people.
中文简介正在准备中。当前显示英语简介。
Guide changes to Kortix billing code, admin controls, and pricing screens. Explain how plans, trials, enterprise contracts, and access exceptions should work, where pricing is defined, and which audited routes must handle account changes.
中文简介正在准备中。当前显示英语简介。