Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

flow-learn

/flow-learn

Przywraca orientację między maszynami i narzędziami, uzgadnia listy specyfikacji, wykrywa dryf kodu i dokumentacji oraz odświeża słowniki i ADR-y.

Repozytorium
flow ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
3
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (3). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Przywraca orientację między maszynami i narzędziami, uzgadnia listy specyfikacji, wykrywa dryf kodu i dokumentacji oraz odświeża słowniki i ADR-y.

Oryginalny opis (EN)

Use when reorienting across machines or harnesses (/flow:refresh), reconciling spec checklists (/flow:sync), auditing codebase or spec drift, sharpening domain glossaries and ADRs, or resynthesizing OKF v0.2 knowledge and .agents/skills/ (/flow:learn, /flow:resynthesize).

Jak działa

  1. Trigger
  2. Workflow
  3. Guardrails
  4. Output
  5. Validation
Sekcje z nagłówków SKILL.md, w oryginale · 46 linii, 601 słów
Podgląd SKILL.md
---
name: flow-learn
description: "Use when reorienting across machines or harnesses (/flow:refresh), reconciling spec checklists (/flow:sync), auditing codebase or spec drift, sharpening domain glossaries and ADRs, or resynthesizing OKF v0.2 knowledge and .agents/skills/ (/flow:learn, /flow:resynthesize)."
disable-model-invocation: true
---

# Flow Learn (Drift True-Up, Cross-Harness Refresh, & OKF Resynthesis)

<!-- lifecycle-ownership: owner=flow-learn; operations=learn,resynthesize,refresh,sync,docs -->

## Trigger

Use for `/flow:learn [scope]` (and aliases `resynthesize`, `refresh`, `sync`, `docs`). Can run at any point in a project's lifecycle—when switching machines or harnesses, mid-flow, post-flow, or standalone. Follow [`../flow/references/learn.md`](../flow/references/learn.md).

## Workflow

1. **Cross-Machine/Harness/Worktree Reorientation & Multi-Chapter Drift Audit (`refresh` + `sync` + `true-up`)**:
   - **Linked Git Worktree & Environment Check (`sync --from-main` / `sync --to-main`)**: When running inside a linked `git worktree`, verify `.venv` / `node_modules` symlinks from the primary checkout (`uv run --no-sync`), confirm `shared` (worktree `.agents/`) vs. `local-only` (primary checkout `$MAIN_WORKTREE/.agents/` symlink, or `/flow:learn sync --from-main` and `--to-main` when sandbox mounts forbid cross-worktree writes) routing, and flag any split-brain untracked worktree `.agents/` files.
   - **Spec, Chapter, & Task Reconciliation (`sync` / `refresh`)**:
     - Compare `tasks/*.md` frontmatter (`state`, `commit`, `claimed_by`), `chapters/<ch_id>/spec.md` (`state`, `planning_status`, `last_reviewed_commit`), `chapters/index.md`, and root `specs/<flow_id>/spec.md` (`chapters:`, `current_chapter`, checklist markers, `## 6. Current State & Remaining Plan Snapshot`) against live `git log` and working-tree state.
     - Mark tasks whose commits landed on another machine/session `state: completed` with their verified Git `commit` SHA, release stale cross-harness `in_progress` claims when no active work matches the working tree, and rewrite `chapters/index.md`, chapter `spec.md`, and root `spec.md` checklists and state snapshots in place in present tense.
     - Flag any open `tasks/<id>-<slug>.md` or downstream chapters whose target `files:` or `path/to/file::Symbol` signatures drifted so `/flow:revise <flow_id> [chapter_id]` can re-baseline them.
   - **Source-to-Knowledge Drift (`sources[].resource` Intersection)**:
     - Intersect modified or deleted files/symbols (`git status`, `git diff <last_verified_commit>..HEAD`) against every `.agents/bundles/knowledge/**/*.md` chapter's `sources[].resource` paths and `path/to/file::Symbol` anchors (sharding across `1` read-only subagent per domain on multi-domain repos; `type_name="self"` on Google Antigravity).
   - **Manifest & Toolchain Drift**:
     - Compare `pyproject.toml`, `Cargo.toml`, `package.json`, `go.mod`, `Makefile`, and CI workflows against `product/tech-stack.md`, `product/product.md`, and `knowledge/workflow.md`.
2. **Subagent-Sharded OKF v0.2 Knowledge Resynthesis (`.agents/bundles/knowledge/`)**:
   - Harvest confirmed discoveries across single-chapter and nested `chapters/<ch_id>/tasks/*.md` (`## Notes & Discoveries`) and promoted `research/*.md`.
   - When resynthesizing `>= 2` domains, fan out **1 isolated synthesis subagent per domain** (`type_name="self"` on Google Antigravity) so each domain chapter receives thorough present-tense updates with `status: stable`, `<= 40`-line `<!-- truth: start -->` blocks, `sources:` + `[^id]:` footnotes, and zero standalone `---` body rules.
   - Sharpen `knowledge/domains/<domain>.md` and apply the **ADR Filter** (*hard to reverse + surprising without context + genuine trade-off*) for `knowledge/decisions/adr-NNN-<slug>.md`, pruning chronological sediment and model-relative no-ops ([`../flow-docs/references/agent-context.md`](../flow-docs/references/agent-context.md)).
3. **Dynamic Project-Local Skill, Subagent, & Documentation Synchronization (`.agents/skills/`, `.agents/agents/`, & `docs/`)**:
   - Follow [`../multi-harness-plugins/SKILL.md`](../multi-harness-plugins/SKILL.md) to update `.agents/skills/<domain>/SKILL.md` (`<= 200` lines + `references/*.md`), `.agents/skills/review-<domain>/SKILL.md` (`references/checklist.md` + `references/false-positive-suppressions.md`), `.agents/skills/index.md`, paired subagents (`.agents/agents/<domain>-reviewer.md` and `<domain>-specialist.md` with `commandExecutionPolicy: sandbox`), and root `AGENTS.md`.
   - When updating user-facing guides, READMEs, or module docs, follow [`../flow-docs/SKILL.md`](../flow-docs/SKILL.md).
   - Remove any legacy `.agents/skills/flow-memory-keeper/` or copied global Flow skills.
4. **Frontmatter-Free Index Rebuild, `log.md` Audit Entry & True-Up Dashboard**:
   - Rebuild root `.agents/bundles/index.md` (`okf_version: "0.2"`) and frontmatter-free subdirectory `index.md` files (`product/index.md`, `knowledge/index.md`, `knowledge/<ns>/index.md`, `specs/index.md`, `chapters/index.md`), prepend a `synthesize` / `verify` entry to `.agents/bundles/log.md`, and report the **Project True-Up & Reorientation Dashboard**.

## Guardrails

- Never overwrite uncommitted user code changes or developer-owned content inside `<!-- project-customization: start -->` blocks.
- Rewrite updated knowledge chapters in place in present tense; never append chronological revision logs inside concept documents.
- Every knowledge claim must cite a verified repository path (`path/to/file::Symbol`) or primary source in `sources:`.

## Output

Return the **Project True-Up & Reorientation Dashboard** listing reconciled commits/claims, repaired `knowledge/**` chapters, updated `.agents/skills/` and `.agents/agents/`, and the next exact step.

## Validation

Confirm all `sources[].id` entries have matching `[^id]` footnotes in body prose, all relative links in `.agents/bundles/index.md` and `.agents/skills/index.md` resolve on disk, `spec.md` checklists match `tasks/*.md` frontmatter, and `.agents/bundles/log.md` records the synthesis entry.

Wersje

W bazie nie ma innych skilli o nazwie flow-learn.

Migawka bazy z 13.11.2026 · wersja paczki e7dee5dd7e86 (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

  • 100flow-sync-status
    Pomaga odnaleźć się w Flow między maszynami i harnessami, uzgadnia stan zadań ze specyfikacją, pokazuje kolejki statusów i sprawdza dryf pakietów.
  • 100flow-sync-status
    Pomaga odnaleźć się w Flow między maszynami i harnessami, uzgadnia stan zadań ze specyfikacją, pokazuje kolejki statusów i sprawdza dryf pakietów.
  • 100flow-next-spec-completion-review
    Sprawdza, czy wszystkie zadania specyfikacji Flow realizują wymagania ze specyfikacji.
  • 100vibe-spec-sync
    Pilnuje zgodności specyfikacji z kodem: wykrywa rozbieżności przy audycie i aktualizuje spec po zatwierdzeniu zmian.
  • 100vault-sync
    Wykrywa i naprawia rozjazd między wiedzą w vaulcie OKF a opisywanym kodem po większych zmianach schematu, interfejsów, workflow lub konfiguracji agentów.
  • 100doncheli-drift
    Wykrywa i uzgadnia rozbieżności między specyfikacją a implementacją.

Uwagi i zgłoszenia

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