Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

memory

/memory

Obsługuje katalog .corgi/memory z decyzjami, incydentami i powtarzalnymi poprawkami, które agent czyta przed działaniem i uzupełnia po jego zakończeniu, bez zapisywania sekretów.

Repozytorium
corgi ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Obsługuje katalog .corgi/memory z decyzjami, incydentami i powtarzalnymi poprawkami, które agent czyta przed działaniem i uzupełnia po jego zakończeniu, bez zapisywania sekretów.

Oryginalny opis (EN)

The memory convention: a committed `.corgi/memory/` store of decisions, incidents, and recurring fixes that suggest, debug, stories, and review read before acting and append to afterwards. Use to read prior decisions, record a decision or an incident fix, or propose a recurring fix as a skill. Read before act, confirm before write, never secrets.

Jak działa

  1. Guardrails (non-negotiable)
  2. File format - one fact per file
  3. The index
  4. Read-before-act (suggest / debug / stories)
  5. Confirm-before-write (stories / review)
  6. Learned skills - detect, PROPOSE, never install
Sekcje z nagłówków SKILL.md, w oryginale · 84 linii, 784 słów
Podgląd SKILL.md
---
name: memory
description: "The memory convention: a committed `.corgi/memory/` store of decisions, incidents, and recurring fixes that suggest, debug, stories, and review read before acting and append to afterwards. Use to read prior decisions, record a decision or an incident fix, or propose a recurring fix as a skill. Read before act, confirm before write, never secrets."
---

# Corgi workspace memory

A corgi workspace remembers things not in git or code: **why** a driver/port/template was chosen, how a past **incident** was fixed, **domain** facts, recurring **fixes**. Store is `.corgi/memory/` - committed, shared by the team via the repo, keyed to the `corgi-compose.yml` stack. This skill is the convention; `suggest`/`debug`/`stories`/`review` reference it.

## Guardrails (non-negotiable)

- **Opt-in.** No `.corgi/memory/` → reads skip silently (no memory is not an error); writes **offer** to create the store, never force it.
- **No secrets, ever.** Store is committed. Never write a credential, token, API key, password, connection string with a password, private hostname, or PII. Record *that* a secret exists and where it's configured ("import needs `STRIPE_KEY` in the api env"), never the value. `corgi memory lint` fails the store on a key-shaped string.
- **Confirm before write.** Drafting a fact is fine; writing it needs the user's OK (same spirit as the spec sign-off gate). One fact per durable outcome - not chatter.
- **Never auto-install a learned skill or template.** A recurring pattern produces a *proposal* a human approves; this skill never writes an executable skill or edits a plugin/template.

## File format - one fact per file

`.corgi/memory/<type>/<name>.md`, where `<type>` ∈ `decisions | incidents | domain | fixes` (the folder) and `<name>` is unique kebab-case == the filename stem:

```markdown
---
name: postgres-over-mysql
description: Chose Postgres for the main DB over MySQL - JSONB + partial indexes.
type: decision        # decision | incident | domain | fix
service: api          # optional corgi-compose service, or "stack"
created: 2026-06-08
links: ["[[billing-cycle-rules]]"]
pattern:              # fix-type only: the stable key recurrence is counted on
---

Short body. Why, not what. Reference related facts with [[their-name]].
```

- `description` is the one line the index shows and a reader sees first - make it carry the fact.
- `[[name]]` links form the **memory graph**; a link to a missing fact is a lint warning.
- `type` must match the folder. `fix` facts add `pattern:` (the recurrence key).

## The index

`.corgi/memory/index.md` is **generated** (`corgi memory index`) - never hand-edit it. Lists every fact's name + description by type. **Read the index first** (cheap), then open only the 1-3 fact files whose description matches your task. Don't dump the whole store into context.

## Read-before-act (suggest / debug / stories)

If `.corgi/memory/` exists, before acting:
1. `corgi memory list --json` (or read `index.md`) - scan descriptions.
2. Open only the matching facts.
3. Use them: **suggest** - don't propose what a `decision` rejected; cite a `domain` fact / past `incident` as evidence. **debug** - check `incidents/` for "seen this before?" and reuse the recorded fix. **stories** - honor `decision` constraints, reuse an `incident` fix for a regression, ground a free-text feature in `domain`.

## Confirm-before-write (stories / review)

After a notable, durable outcome, draft a fact and **show it for confirmation**:
- **stories** - a non-obvious bug root cause that could recur → `incident` (+ a `fix` with a `pattern:` if it's a code-level pattern); a cross-service contract choice → `decision`.
- **review** - a reviewer thread that settles a durable convention (Mode B, after the thread resolves) → `decision`.

On OK: `corgi memory add --type <t> --name <slug> --desc "<one line>" [--service <s>] [--pattern <key>]` scaffolds the file, then `corgi memory index` refreshes the index, then run `corgi memory lint` (must pass - catches secrets / broken links). Commit the new fact with the related change. No `.corgi/memory/` yet → offer to create it (`corgi memory add` creates the dir on first use); declined → skip, don't block.

## Learned skills - detect, PROPOSE, never install

After writing a `fix` fact, check recurrence:
1. `corgi memory list --type fix --json` → count by `pattern`.
2. A `pattern` seen **≥ 3 times** (default threshold) is a learned-skill candidate.
3. Write a **proposal** to `.corgi/memory/proposals/<date>-<pattern>.md`:

```markdown
---
name: retry-on-429
kind: skill        # skill | template
count: 3
sources: ["[[retry-on-429-billing]]", "[[retry-on-429-search]]", "[[retry-on-429-webhook]]"]
created: 2026-06-08
---

## Recurring pattern
We've added the same exponential-backoff-on-429 wrapper in 3 services (links above).

## Proposed remedy
A project skill `retry-on-429` (or a corgi template) that documents/scaffolds the
shared backoff helper so the next service reuses it instead of re-deriving it.

## Approval (human ticks to accept - nothing auto-installs)
- [ ] This pattern is real and worth standardizing
- [ ] Author it as a: ( ) project skill  ( ) corgi template
- [ ] Owner: ____   Target repo/path: ____
```

4. **Stop there.** Print the proposal path. Do **not** create a skill file, edit the plugin, or add a template - a human approves and authors it as a separate explicit task. Proposals are committed so the team sees the candidate.

Wersje

RepozytoriumWynikLicencja
Ta strona · andriiklymiuk/corgi100MIT
rjmurillo/ai-agents100MIT
rjmurillo/ai-agents100MIT
topoteretes/cognee-integrations100Apache-2.0
topoteretes/cognee-integrations100Apache-2.0
topoteretes/cognee-integrations100Apache-2.0
thebtf/engram100MIT
stxrmik/antigravity-plus100MIT
boshu2/agentops100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 728dd6d15479 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100setup
    Konfiguruje agenta corgi krok po kroku: wykonuje kroki, które program może zrobić sam, łączy telefon, Telegram, pasek menu oraz Jira, Linear i GitHub.
  • 100budget
    Odczytuje zużycie przez corgi agent usage --json i odpowiada liczbami, ile budżetu zostało i kiedy limit się odnowi, a przy zbliżaniu się do limitu proponuje corgi agent carry.
  • 100causal-memory
    Instaluje serwer MCP causal-memory i zapisuje decyzje oraz wyniki agenta, a przed działaniem przypomina je przy nietrywialnych wyborach, nieoczekiwanych porażkach i prośbach o zapamiętanie.
  • 100causal-memory
    Instaluje serwer MCP causal-memory i zapisuje decyzje oraz wyniki agenta, a przed działaniem przypomina je przy nietrywialnych wyborach, nieoczekiwanych porażkach i prośbach o zapamiętanie.
  • 100role-memory
    Prowadzi trwałą pamięć agentów w plikach markdown: kuratorowane fakty, decyzje i dziennik zdarzeń, odczytywany przed działaniem.
  • 100agent-memory-discipline
    Uczy, kiedy przywoływać pamięć długoterminową przed działaniem i kiedy zapisywać trwałe decyzje, poprawki i porażki, dla dowolnego backendu pamięci.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.