本文へ移動
cccskills
無料GitHub で公開

learnings

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.

インストール方法を見る

含まれるファイル(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>.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Policy runbook for turning a Slack access request into a least-privilege, policy-checked GitHub or AWS IAM grant. Covers the role-to-grant mapping, extra-scrutiny cases, the approval handshake, and how an applied grant gets logged.

日本語の概要は準備中です。原文の説明を表示しています。

kortix-ai/suna2万2026年10月12日 更新

Get a complete picture of any company or person before outreach. This skill always works with web search, and gets significantly better with enrichment and CRM data.

日本語の概要は準備中です。原文の説明を表示しています。

kortix-ai/suna2万2026年10月12日 更新

Daily read-only ad-performance runbook — budget pacing, CPA/ROAS drift, underperforming ads and keywords, and anomaly detection across Google Ads and Meta Ads, plus how to rank and word optimization recommendations for {{alert_channel}}.

日本語の概要は準備中です。原文の説明を表示しています。

kortix-ai/suna2万2026年10月12日 更新

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

日本語の概要は準備中です。原文の説明を表示しています。

kortix-ai/suna2万2026年10月12日 更新

Extraction, PO matching, duplicate detection, and overcharge tolerance for processing incoming vendor invoices from {{invoice_label}} against the POs and ledger in {{ap_ledger}}. Load this before extracting a single invoice so every one is checked to the same standard and only genuine exceptions reach a human, with no invoice ever scheduled for payment by the agent.

日本語の概要は準備中です。原文の説明を表示しています。

kortix-ai/suna2万2026年10月12日 更新

Daily brand-mention monitoring loop for {{brand_terms}}. Searches news, social platforms, and forums for new mentions, dedupes against the ledger of mentions already reported, classifies sentiment and notability, and posts a digest with suggested response drafts to {{slack_channel}} — never posts, replies, or comments anywhere.

日本語の概要は準備中です。原文の説明を表示しています。

kortix-ai/suna2万2026年10月12日 更新

kortix-ai のスキルをすべて見る

このスキルの問題を報告する