본문으로 건너뛰기
cccskills
무료GitHub에 공개

learnings

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. 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.

연동 도구Vercel
설치 방법 보기

이럴 때 유용합니다

  • Review incident lessons before database changes
  • Check past release failures before deployment
  • Record lessons after resolving an incident
  • Link prevention rules to tests and CI checks

포함된 파일(200)

  • SKILL.md4.2 KB
  • entries/2026-08-10T191010Z-bot-pushed-release-prs-and-repo-actions-approval-policy.md655 B
  • entries/2026-08-10T191010Z-cancel-the-ci-run-before-killing-its-db-backend.md541 B
  • entries/2026-08-10T191010Z-cost-every-pending-prod-migration-before-promoting.md677 B
  • entries/2026-08-10T191010Z-never-backfill-data-inside-a-single-transaction-migration.md984 B
  • entries/2026-08-10T191010Z-node-pg-migrate-checkorder-is-index-wise-on-ledger-run-order.md648 B
  • entries/2026-08-10T191010Z-the-prod-frontend-must-never-deploy-before-the-api-serves-th.md820 B
  • entries/2026-08-10T191010Z-verify-ci-assertions-against-the-real-artifact-format-on-the.md692 B
  • entries/2026-08-10T194745Z-an-audit-reconstruction-trigger-is-only-safe-with-its-dedup.md681 B
  • entries/2026-08-10T194745Z-one-create-index-concurrently-per-table-at-a-time.md845 B
  • entries/2026-08-10T194745Z-the-vercel-prod-build-must-be-handed-the-release-version.md774 B
  • entries/2026-08-11T063009Z-a-deploy-workflow-must-not-cancel-a-build-it-cannot-outrun.md1.0 KB
  • entries/2026-08-11T120415Z-a-per-turn-hot-path-must-not-contain-an-unbounded-third-part.md1.2 KB
  • entries/2026-08-12T090712Z-a-cross-process-command-string-needs-a-test-that-runs-it.md1.3 KB
  • entries/2026-08-12T100900Z-a-deployed-api-is-not-a-deployed-daemon.md1.2 KB
  • entries/2026-08-13T075428Z-anything-created-per-deploy-needs-a-reaper-and-the-reaper-ne.md1.8 KB
  • entries/2026-08-13T202203Z-a-platform-injected-principal-must-never-have-its-authority.md1.9 KB
  • entries/2026-08-14T120355Z-a-tls-proxy-component-is-only-as-correct-as-the-third-party.md1.8 KB
  • entries/2026-08-14T120355Z-bun-diverges-from-node-in-three-load-bearing-ways-around-raw.md966 B
  • entries/2026-08-14T143643Z-a-control-split-across-api-and-daemon-is-only-live-when-both.md1.7 KB
  • entries/2026-08-14T171525Z-a-path-allowlist-that-gates-non-idempotency-must-list-every.md1.7 KB
  • entries/2026-08-14T171525Z-two-proxy-layers-must-agree-on-which-upstream-calls-legitima.md2.0 KB
  • entries/2026-08-16T152520Z-a-resource-scaled-timeout-moves-the-cliff-it-never-removes-i.md2.6 KB
  • entries/2026-08-17T010546Z-a-sandbox-lifecycle-grant-requires-exact-active-turn-evidenc.md1007 B
  • entries/2026-08-17T031949Z-a-persisted-user-message-is-not-proof-that-its-opencode-turn.md763 B
  • entries/2026-08-17T031949Z-presigned-uploads-must-suppress-runtime-inferred-content-typ.md813 B
  • entries/2026-08-17T031949Z-provider-lifecycle-renewal-must-use-the-provider-activity-pr.md819 B
  • entries/2026-08-17T043446Z-every-sandbox-stop-must-revoke-all-persisted-turn-authority.md867 B
  • entries/2026-08-17T055525Z-active-turn-renewal-cadence-must-stay-below-the-shortest-pro.md927 B
  • entries/2026-08-17T084017Z-a-reused-speculative-resource-needs-a-consumption-signal-eve.md1.6 KB
  • entries/2026-08-17T234452Z-a-shared-connector-catalog-needs-one-canonical-credential-sc.md681 B
  • entries/2026-08-17T234452Z-catalog-discovery-must-use-execution-credentials-and-fail-on.md997 B
  • entries/2026-08-18T123751Z-a-user-visible-string-is-a-shared-resource-file-ownership-cu.md2.0 KB
  • entries/2026-08-18T182601Z-a-request-response-log-must-never-cap-what-it-captures.md1.3 KB
  • entries/2026-08-18T182601Z-tests-release-s-own-load-can-knock-staging-over-then-the-edg.md5.3 KB
  • entries/2026-08-18T211800Z-a-test-lane-that-rewrites-tracked-files-is-a-concurrent-writ.md1.8 KB
  • entries/2026-08-18T211800Z-one-oauth-provider-per-concern-and-shape-validating-a-redire.md4.6 KB
  • entries/2026-08-19T013431Z-a-frontend-deploy-job-that-needs-an-unrelated-edge-job-ships.md2.2 KB
  • entries/2026-08-19T121505Z-create-index-concurrently-under-a-5-second-lock-timeout-cann.md2.6 KB
  • entries/2026-08-19T143259Z-a-picker-that-offers-a-model-the-runtime-does-not-know-is-a.md2.3 KB
  • entries/2026-08-19T163343Z-a-redirect-uri-a-protocol-handshake-and-a-cached-catalog-all.md4.0 KB
  • entries/2026-08-19T163833Z-a-store-swap-needs-the-fks-the-old-store-had-or-it-silently.md1.0 KB
  • entries/2026-08-19T163833Z-drizzle-kit-generate-reports-a-tty-prompt-as-no-schema-chang.md1.3 KB
  • entries/2026-08-19T163833Z-on-conflict-cols-cannot-run-against-a-view.md1.2 KB
  • entries/2026-08-19T165300Z-kortix-self-host-config-dir-isolates-the-config-not-the-cont.md2.1 KB
  • entries/2026-08-19T182307Z-a-validate-ships-only-with-a-reconciliation-the-target-data.md1.6 KB
  • entries/2026-08-19T182307Z-rewiring-writers-and-converting-their-table-to-a-view-must-b.md1.3 KB
  • entries/2026-08-20T014925Z-a-deployed-api-cannot-read-the-test-runner-s-filesystem.md805 B
  • entries/2026-08-20T014925Z-a-per-host-credential-never-goes-in-a-client-wide-header-bag.md1.3 KB
  • entries/2026-08-20T133711Z-transcript-shape-alone-may-never-end-a-turn-and-every-turn-n.md2.2 KB
  • entries/2026-08-20T140249Z-a-release-pipeline-is-only-as-green-as-its-quietest-dependen.md2.9 KB
  • entries/2026-08-20T141506Z-entitlement-is-a-property-of-the-subscription-and-has-an-act.md2.2 KB
  • entries/2026-08-20T143318Z-a-relay-that-authenticates-with-the-wrong-credential-fails-s.md2.3 KB
  • entries/2026-08-20T144326Z-a-url-that-carries-a-credential-must-never-reach-a-log-line.md1.1 KB
  • entries/2026-08-20T201722Z-positive-is-only-half-of-what-der-asks-of-an-integer-it-must.md2.8 KB
  • entries/2026-08-20T215609Z-a-browser-must-never-be-handed-a-5xx-for-an-expected-state-a.md2.3 KB
  • entries/2026-08-21T002423Z-git-stash-is-repo-global-never-pop-from-a-worktree.md1.3 KB
  • entries/2026-08-21T141138Z-a-jwks-is-not-evidence-of-how-tokens-are-signed-and-publishi.md2.8 KB
  • entries/2026-08-21T210836Z-normalize-missing-user-agent-at-webhook-ingress-before-aws-w.md774 B
  • entries/2026-08-21T215500Z-a-comment-saying-this-was-tried-and-reverted-is-a-decision-r.md3.1 KB
  • entries/2026-08-21T220546Z-a-limit-larger-than-the-thing-it-protects-is-not-a-limit-and.md3.9 KB
  • entries/2026-08-21T225649Z-mint-every-opencode-message-id-with-the-native-sortable-code.md668 B
  • entries/2026-08-22T134700Z-size-database-pools-for-the-rolling-fleet-not-the-steady-fle.md1.9 KB
  • entries/2026-08-22T152814Z-a-browser-retry-must-wait-for-the-result-it-is-retrying.md680 B
  • entries/2026-08-22T152814Z-a-selective-capacity-release-must-include-the-pool-isolation.md690 B
  • entries/2026-08-22T170743Z-a-self-host-has-two-version-axes-the-images-and-the-cli-bina.md1.9 KB
  • entries/2026-08-22T170743Z-validate-a-config-offline-before-applying-it-and-never-trust.md2.3 KB
  • entries/2026-08-22T172619Z-bind-public-vercel-runtime-metadata-to-the-deployment-not-th.md624 B
  • entries/2026-08-22T180722Z-admission-after-allocation-is-accounting-not-admission.md1.7 KB
  • entries/2026-08-22T182907Z-assert-an-asynchronous-timestamp-write-on-its-own-row.md667 B
  • entries/2026-08-22T183042Z-a-standalone-service-needs-explicit-caller-wiring-in-every-e.md1.2 KB
  • entries/2026-08-22T200406Z-prove-the-gated-query-ran-after-enabling-its-feature.md615 B
  • entries/2026-08-22T201022Z-fence-every-detached-lifecycle-mutation-with-a-durable-opera.md659 B
  • entries/2026-08-22T202833Z-a-sandbox-environment-carries-one-credential-not-a-boot-prot.md801 B
  • entries/2026-08-22T203014Z-two-dev-stacks-on-one-shared-db-share-one-work-queue.md3.3 KB
  • entries/2026-08-22T210421Z-every-stack-launcher-needs-the-tunnel-watchdog-not-only-pnpm.md1.5 KB
  • entries/2026-08-22T213442Z-assert-monotonic-timestamps-when-later-writes-can-advance-on.md603 B
  • entries/2026-08-22T214123Z-never-resolve-a-merge-inside-a-worktree-whose-api-runs-hot.md1.9 KB
  • entries/2026-08-22T220017Z-a-credential-boundary-cannot-depend-on-a-feature-flag.md1.2 KB
  • entries/2026-08-22T235936Z-webhook-signing-secrets-must-use-connector-delivery.md803 B
  • entries/2026-08-23T005512Z-a-cancelled-deploy-dev-can-advertise-a-sha-it-never-promoted.md2.4 KB
  • entries/2026-08-23T010517Z-keep-self-host-sandbox-gateway-urls-aligned-with-the-public.md649 B
  • entries/2026-08-23T141045Z-keep-the-legacy-relay-until-old-sessions-pass-a-real-cutover.md699 B
  • entries/2026-08-23T142556Z-give-reviewed-infrastructure-rollbacks-an-explicit-delete-pa.md598 B
  • entries/2026-08-23T152051Z-a-typed-list-from-a-remote-endpoint-is-not-a-list-normalize.md876 B
  • entries/2026-08-23T165540Z-a-websocket-upgrade-must-obey-the-same-wake-policy-as-the-ht.md1.0 KB
  • entries/2026-08-23T183033Z-a-channel-promotion-must-evaluate-after-skipped-sibling-surf.md668 B
  • entries/2026-08-23T183033Z-resolve-a-pnpm-global-package-through-pnpm-root-g.md530 B
  • entries/2026-08-23T190512Z-update-every-generated-dockerfile-when-the-sandbox-runtime-c.md931 B
  • entries/2026-08-23T200749Z-resolve-a-pnpm-global-binary-from-its-installed-shim-target.md955 B
  • entries/2026-08-23T220723Z-submit-an-initial-session-prompt-exactly-once.md518 B
  • entries/2026-08-23T224403Z-opencode-model-references-must-name-the-runtime-provider.md930 B
  • entries/2026-08-23T233325Z-missing-managed-runtime-binaries-are-recoverable-drift-not-a.md1.1 KB
  • entries/2026-08-24T010028Z-a-successful-surface-deploy-must-not-inherit-skipped-unrelat.md768 B
  • entries/2026-08-24T042438Z-a-transcript-list-must-never-carry-attachment-bytes.md1.5 KB
  • entries/2026-08-24T042438Z-a-wake-budget-is-a-deadline-not-an-attempt-count.md954 B
  • entries/2026-08-24T042438Z-sandbox-isolation-guards-read-the-agent-binding-never-the-ca.md1.2 KB
  • entries/2026-08-24T050055Z-a-re-framed-body-must-not-carry-the-provider-s-framing-heade.md1.3 KB
  • entries/2026-08-24T050055Z-measure-the-amplification-factor-never-decode-what-you-can-f.md1.5 KB
  • entries/2026-08-24T050055Z-the-edge-never-rewrites-an-origin-error.md1.2 KB
  • entries/2026-08-24T064349Z-browser-idle-is-not-network-idle.md491 B
  • entries/2026-08-24T064349Z-one-react-query-key-needs-one-poll-owner.md590 B
  • entries/2026-08-24T070350Z-shedding-load-only-works-if-you-also-stop-the-upload.md1.8 KB
  • entries/2026-08-24T071321Z-a-deliberate-runtime-failure-park-must-require-explicit-rest.md680 B
  • entries/2026-08-24T071321Z-fence-provider-status-caches-against-lifecycle-mutations.md680 B
  • entries/2026-08-24T082044Z-provider-traffic-credentials-need-a-cross-replica-refresh-bo.md676 B
  • entries/2026-08-24T102439Z-refuse-a-release-version-whose-tag-already-names-another-com.md632 B
  • entries/2026-08-24T144106Z-a-response-header-timeout-must-end-when-actual-provider-head.md694 B
  • entries/2026-08-24T144106Z-a-stale-readiness-observer-must-claim-the-runtime-row-before.md745 B
  • entries/2026-08-24T160408Z-a-snapshot-build-stuck-in-progress-silently-rolls-every-late.md1.5 KB
  • entries/2026-08-24T190358Z-size-sandbox-memory-from-measured-peak-rss-not-nominal-workl.md785 B
  • entries/2026-08-25T161753Z-a-sandbox-model-failure-is-a-version-question-before-it-is-a.md2.1 KB
  • entries/2026-08-25T184146Z-a-boot-budget-measures-lack-of-progress-not-wall-clock.md1.4 KB
  • entries/2026-08-25T184146Z-a-provider-s-204-is-not-a-renewal-read-the-deadline-back.md2.0 KB
  • entries/2026-08-25T184146Z-a-refresh-never-converges-a-booting-runtime-a-stub-launcher.md918 B
  • entries/2026-08-25T184146Z-a-runtime-started-from-stopped-owns-no-turn-settle-and-redel.md1.1 KB
  • entries/2026-08-25T184146Z-the-daemon-owns-the-opencode-binary-opencode-must-never-upgr.md1006 B
  • entries/2026-08-25T184146Z-the-runtime-s-body-limit-is-the-one-that-logs-never-the-one.md1.2 KB
  • entries/2026-08-25T185517Z-window-inline-images-inside-the-sandbox-the-edge-is-too-late.md1.1 KB
  • entries/2026-08-25T201351Z-a-gateway-may-not-refuse-a-request-parameter-the-client-send.md1.9 KB
  • entries/2026-08-25T204528Z-a-400-that-names-one-parameter-is-never-the-turn-s-final-ans.md1.2 KB
  • entries/2026-08-25T204528Z-regenerating-a-ca-on-every-listener-restart-breaks-trust-and.md706 B
  • entries/2026-08-25T215118Z-every-blocking-opencode-endpoint-must-be-exempted-in-both-pr.md2.4 KB
  • entries/2026-08-25T223945Z-a-guard-that-tolerates-its-own-tool-being-absent-guards-noth.md1.6 KB
  • entries/2026-08-25T223945Z-a-runner-label-is-a-tested-contract-and-a-third-party-runner.md1.8 KB
  • entries/2026-08-25T233332Z-a-turn-probe-never-lists-the-whole-root-the-list-is-unbounde.md3.5 KB
  • entries/2026-08-25T233332Z-bun-s-fetch-has-a-hidden-300-s-idle-timeout-every-model-hop.md1.6 KB
  • entries/2026-08-25T235640Z-a-ci-lane-that-runs-inside-a-third-party-sandbox-inherits-th.md1.5 KB
  • entries/2026-08-26T001920Z-image-bytes-never-live-in-the-transcript-memory-is-guarded-b.md2.4 KB
  • entries/2026-08-26T023903Z-a-non-prod-secrets-profile-must-never-hold-a-production-reac.md2.0 KB
  • entries/2026-08-26T130600Z-a-provider-s-resume-is-not-a-promise-that-your-processes-com.md1.2 KB
  • entries/2026-08-26T130600Z-a-retry-class-is-a-claim-about-the-failure-not-about-the-cal.md1.1 KB
  • entries/2026-08-26T130600Z-a-row-lock-held-to-commit-makes-batch-size-a-blast-radius-an.md1.7 KB
  • entries/2026-08-26T130600Z-a-stamped-failure-is-a-cooldown-never-a-gravestone-and-a-neg.md3.7 KB
  • entries/2026-08-26T130600Z-an-image-is-a-cache-a-boot-that-blocks-on-building-one-has-c.md1.1 KB
  • entries/2026-08-26T133113Z-an-alarm-on-a-metric-the-workload-violates-by-design-is-nois.md2.0 KB
  • entries/2026-08-26T141126Z-a-retry-that-inherits-the-previous-attempt-s-budget-is-not-a.md3.1 KB
  • entries/2026-08-26T144625Z-a-scheduled-control-that-crashes-is-a-control-that-never-ran.md1.4 KB
  • entries/2026-08-26T172314Z-a-runner-migration-re-tests-every-setup-action-one-job-on-a.md2.0 KB
  • entries/2026-08-26T174631Z-a-release-gate-flow-is-added-or-un-quarantined-only-in-the-p.md1.6 KB
  • entries/2026-08-26T181929Z-a-provider-handed-to-the-provisioner-is-a-preference-not-a-l.md955 B
  • entries/2026-08-26T181929Z-disabling-a-starter-default-does-not-disarm-the-fleet-alread.md840 B
  • entries/2026-08-26T181929Z-jitter-every-fleet-cron-identical-manifests-share-an-express.md857 B
  • entries/2026-08-26T182939Z-a-guard-that-has-never-fired-has-never-been-tested-and-an-ar.md2.0 KB
  • entries/2026-08-26T203523Z-github-release-needs-the-npm-publishes-so-an-npm-publish-fai.md2.3 KB
  • entries/2026-08-26T223614Z-a-react-effect-keyed-on-a-provider-issued-object-must-cache.md1.0 KB
  • entries/2026-08-26T223614Z-the-dev-edge-waf-403s-any-query-string-carrying-a-bare-local.md746 B
  • entries/2026-08-26T233208Z-a-web-api-the-middleware-needs-must-exist-in-the-image-s-run.md1.8 KB
  • entries/2026-08-27T000129Z-local-bun-is-not-image-bun-feature-detect-web-apis-and-a-gre.md1.3 KB
  • entries/2026-08-27T023454Z-a-fire-and-forget-scheduler-must-check-its-config-before-arm.md1.5 KB
  • entries/2026-08-27T023454Z-a-mocked-db-unit-test-is-not-a-real-insert-a-raw-sql-date-bi.md1.6 KB
  • entries/2026-08-27T023454Z-a-session-bound-sandbox-pat-is-default-denied-by-enforcetoke.md1.5 KB
  • entries/2026-08-27T023454Z-self-host-update-health-gate-deadlock-the-bug-that-sickens-a.md1.1 KB
  • entries/2026-08-27T120914Z-under-the-gateway-every-model-is-providerid-kortix-a-same-pr.md1.8 KB
  • entries/2026-08-27T125410Z-two-migrations-generated-from-the-same-parent-fork-the-drizz.md1.8 KB
  • entries/2026-08-27T142521Z-a-new-import-edge-into-a-widely-mocked-graph-breaks-hand-wri.md2.9 KB
  • entries/2026-08-27T161405Z-an-experiment-flag-that-deploy-dev-pins-to-an-explicit-false.md1.6 KB
  • entries/2026-08-27T201712Z-deployed-configuration-has-one-truth-and-it-is-not-the-file.md2.4 KB
  • entries/2026-08-27T203820Z-a-down-box-has-two-proxy-responses-the-sdk-must-treat-both-a.md2.9 KB
  • entries/2026-08-27T212328Z-a-reverse-proxy-in-front-of-next-js-owns-x-forwarded-host-or.md1.8 KB
  • entries/2026-08-27T230020Z-an-environment-that-shares-one-origin-between-frontend-and-a.md1.9 KB
  • entries/2026-08-28T035753Z-compose-up-d-does-not-restart-a-container-because-a-bind-mou.md1.9 KB
  • entries/2026-08-28T135146Z-deploy-preview-yml-runs-from-the-default-branch-so-everythin.md1.6 KB
  • entries/2026-08-28T152700Z-keep-lazy-optional-dependencies-type-lazy-across-shared-sour.md689 B
  • entries/2026-08-28T175711Z-oauth-loopback-redirect-uris-are-protocol-data-not-perimeter.md1.3 KB
  • entries/2026-08-29T142038Z-release-assertions-must-follow-the-named-data-source-not-an.md1.1 KB
  • entries/2026-08-29T170658Z-a-guard-nobody-armed-is-not-a-guard-and-a-path-only-allowlis.md3.9 KB
  • entries/2026-08-29T173032Z-a-root-only-package-smoke-can-publish-a-broken-optional-entr.md1.2 KB
  • entries/2026-08-29T195646Z-every-build-command-must-declare-its-executable-in-that-pack.md859 B
  • entries/2026-08-29T215838Z-an-action-endpoint-must-refresh-a-replicated-mirror-before-r.md1.1 KB
  • entries/2026-08-30T220332Z-a-proxied-websocket-that-carries-idle-traffic-needs-a-keepal.md2.2 KB
  • entries/2026-08-31T132158Z-an-explicit-pathspec-does-not-isolate-concurrent-agents-it-c.md2.0 KB
  • entries/2026-09-01T111934Z-a-pnpm-override-that-pins-one-exact-version-forks-the-depend.md1.5 KB
  • entries/2026-09-01T132809Z-pin-every-bundled-go-binary-to-the-scanner-s-fixed-dependenc.md771 B
  • entries/2026-09-01T192007Z-a-floor-that-refuses-a-debit-stops-the-bookkeeping-not-the-s.md2.9 KB
  • entries/2026-09-01T221926Z-a-runtime-that-only-updates-by-pulling-never-updates-a-box-t.md1.0 KB
  • entries/2026-09-01T221926Z-verify-converged-by-what-is-running-not-by-what-was-installe.md600 B
  • entries/2026-09-02T155917Z-a-read-that-fails-is-not-an-admin-decision-health-flags-fail.md1.7 KB
  • entries/2026-09-03T221010Z-a-column-declared-in-schema-ts-but-absent-from-the-migration.md2.8 KB
  • entries/2026-09-03T221010Z-a-durable-fifo-has-one-order-key-and-advances-at-one-boundar.md720 B
  • entries/2026-09-04T124823Z-a-persistent-environment-needs-a-self-healer-on-its-own-box.md4.1 KB
  • entries/2026-09-04T193140Z-a-green-synchronize-preview-does-not-prove-that-target-full.md731 B
  • entries/2026-09-05T140134Z-every-streamed-transcript-mutation-refreshes-runtime-activit.md617 B
  • entries/2026-09-05T140134Z-protocol-adapters-emit-the-target-vocabulary-consumers-fail.md597 B
  • entries/2026-09-05T152255Z-preview-fixtures-must-use-installed-libraries-and-forwarded.md708 B
  • entries/2026-09-05T160815Z-preview-bootstrap-secrets-must-derive-from-the-runtime-allow.md570 B
  • entries/2026-09-05T172319Z-a-failed-content-addressed-template-must-change-the-next-cre.md1.2 KB
  • entries/2026-09-05T174607Z-an-explicit-fallback-preview-must-not-inherit-the-persistent.md962 B
  • entries/2026-09-05T180936Z-a-dependency-engine-floor-must-invalidate-the-preview-base-i.md1003 B
  • entries/2026-09-05T191803Z-edge-middleware-imports-locale-constants-from-a-leaf-module.md606 B
  • entries/2026-09-05T192927Z-a-persistent-sandbox-does-not-inherit-a-replacement-template.md1.1 KB
  • entries/2026-09-06T030642Z-a-2xx-from-a-proxy-is-not-proof-the-origin-got-the-body.md1.3 KB
  • entries/2026-09-06T030642Z-a-compatibility-repair-must-recognize-the-current-writer-s-e.md744 B
  • entries/2026-09-06T030642Z-a-placeholder-s-release-is-a-latch-and-the-real-thing-must-d.md1.3 KB
  • entries/2026-09-06T030642Z-a-streamed-message-is-there-when-its-last-promised-part-land.md1.1 KB
  • entries/2026-09-06T030642Z-an-inline-attachment-allowlist-is-what-the-model-decodes-nev.md1.2 KB
  • entries/2026-09-06T030642Z-do-not-co-schedule-process-heavy-bun-package-suites.md539 B
  • entries/2026-09-06T030642Z-one-attachment-tile-translated-to-tokens-never-a-mockup-s-pi.md1.4 KB
  • entries/2026-09-06T030642Z-optimistic-ui-is-not-durable-the-queue-row-must-carry-what-t.md992 B
  • entries/2026-09-06T030642Z-resolve-competing-ui-sources-per-field-never-first-non-null.md1.3 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Project learnings: the episodic ledger

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.

PathWhat it is
MEMORY.mdThe index. One line per entry, newest first: recorded time (UTC) and the rule. Generated.
entries/<YYYY-MM-DDTHHMMSSZ>-<slug>.mdOne entry. The filename timestamp is when it was recorded.
scripts/new-entry.shStarts 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.

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).

Recall: before you touch a surface

  1. Search the index and the full text for the surface you are about to change:
    grep -i '<keyword>' .agents/skills/learnings/MEMORY.md
    grep -ril '<keyword>' .agents/skills/learnings/entries/
    
    Use the words of the surface: migration, CONCURRENTLY, deploy-dev, promote, wake, Stop, gateway, preview, the file or route name.
  2. Read every matching entry in full. Obey its Rule, and keep its Enforcement green.

Done when every entry that names the surface you touch has been read.

Record: after an incident or near-miss resolves

Record in the same session. An incident that leaves no entry is not finished.

  1. Start the entry:
    .agents/skills/learnings/scripts/new-entry.sh "<the rule, as an imperative>" [incident-date]
    
  2. Fill the four sections the script writes:
    • Rule: the imperative a developer can obey while coding.
    • Trigger surface: what someone is doing when it applies.
    • Incident: date, version or PR, blast radius, in one to three lines.
    • Enforcement: the test, lint, or CI gate that goes red when the rule breaks. An entry with an enforcer is a fact. One without is a TODO: name the enforcer to build.
  3. Commit the entry and MEMORY.md in the same commit.

Done when scripts/index.sh --check exits 0 and the entry is committed.

Ledger rules

  • Append-only. After an entry merges, its text does not change. When a rule changes, or an Enforcer moves or is retired, record a new entry. Put supersedes: <entry filename> in its frontmatter and state what changed.
  • One entry, one file, one timestamp. 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.
  • Keep an entry short: about 8 to 20 lines. Deep detail belongs in the PR body. Cite the PR number (PR #1234).
  • An entry is self-contained. The ledger in 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.
  • Synthetic identifiers only. An entry is committed text, so the AGENTS.md customer-data rule applies. Write "a customer", "an enterprise workspace", <session_id>.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Reviewing GitHub repository access requests from Slack
  • Preparing AWS IAM permissions for a specific task
  • Routing sensitive access requests for additional review
kortix-ai/suna2만2026년 10월 18일 업데이트

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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Research a prospective customer before outreach
  • Prepare background information for meeting attendees
  • Compare a competitor's products and positioning
kortix-ai/suna2만2026년 10월 18일 업데이트

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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Checking whether campaign budgets are being spent on schedule
  • Investigating rising acquisition costs or falling ad returns
  • Finding ads and keywords that spend without converting
kortix-ai/suna2만2026년 10월 18일 업데이트

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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Automate form entry and page navigation
  • Capture screenshots and extract page data
  • Explore web apps for bugs
kortix-ai/suna2만2026년 10월 18일 업데이트

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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Checking incoming invoices against purchase orders
  • Finding duplicate invoices and likely resends
  • Reviewing unit prices and remaining order balances
kortix-ai/suna2만2026년 10월 18일 업데이트

billing

무료

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.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Update billing logic and its specification together
  • Review how trials and enterprise contracts are handled
  • Find the code that defines prices and allowances
kortix-ai/suna2만2026년 10월 18일 업데이트

kortix-ai의 스킬 모두 보기

이 스킬의 문제 신고