Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

forge-with-docs

/forge-with-docs

Opiera plan zmiany na istniejącym modelu domeny, słowniku i ADR-ach i aktualizuje te dokumenty w miarę podejmowania decyzji.

Repozytorium
forge ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.10.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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.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

Opiera plan zmiany na istniejącym modelu domeny, słowniku i ADR-ach i aktualizuje te dokumenty w miarę podejmowania decyzji.

Oryginalny opis (EN)

Use when the user wants Forge planning grounded in an existing domain model, glossary, or ADR set, with those living documents updated as decisions settle. Use plain forge when no documentation alignment is needed. Do not use for review of already-written code or trivial changes.

Jak działa

  1. Unique to this skill
  2. Then: execution is NOT this skill's business
  3. Canonical references
  4. What NOT to do
Sekcje z nagłówków SKILL.md, w oryginale · 46 linii, 321 słów
Podgląd SKILL.md
---
name: forge-with-docs
description: Use when the user wants Forge planning grounded in an existing domain model, glossary, or ADR set, with those living documents updated as decisions settle. Use plain forge when no documentation alignment is needed. Do not use for review of already-written code or trivial changes.
---

# FORGE-WITH-DOCS — Grill Against the Domain Model, Then Build

Act 1 variant: the same relentless interview as `/forge`, but stress-tested against the
project's **existing domain model and glossary** — and the docs are updated *as
decisions crystallise*, not afterwards.

## Unique to this skill

1. **Load the domain.** Read `CONTEXT.md` (or the project's equivalent glossary/domain
   model) and any ADRs before the first question.
2. **Grill with the docs in hand.** One question at a time, recommending an answer for
   each; explore the codebase rather than asking what the code can answer. Additionally:
   - challenge each proposal against **established terminology** — if the plan reuses a
     term differently, resolve it before proceeding;
   - sharpen fuzzy terms into definitions the glossary can hold;
   - stress-test with **concrete scenarios**, not abstractions;
   - cross-reference the code for drift between canon and reality.
3. **Update the docs inline.** As a decision settles, write it: new or changed glossary
   entries into `CONTEXT.md`, and a dated ADR for each contestable architectural choice
   (context · decision · consequences).
4. **Lock the plan** into `PLAN.md` exactly as `/forge` Act 1 does, then hand to Act 2
   (`/forge-review` mechanics) for adversarial review.

## Then: execution is NOT this skill's business

Acts 2–4 run exactly as in [`../forge/SKILL.md`](../forge/SKILL.md). **This skill adds
no gate of its own.** In particular it does **not** impose a routing approval step:
routing follows the active profile like everywhere else — under `sprint` the overlay or
default executor is applied automatically with one line recorded and **no Gate-2 wait**.

## Canonical references

[`../forge/ROUTING-POLICY.md`](../forge/ROUTING-POLICY.md) (routing) ·
[`../forge/profiles/`](../forge/profiles/) (cadence) ·
[`../forge/ENGINE.md`](../forge/ENGINE.md) (engine, templates, admission) ·
[`../forge/references/`](../forge/references/) (detail, on demand)


## What NOT to do

- Don't skip the doc load — grilling without the domain model is just `/forge`.
- Don't let docs drift from decisions; write them as they settle.
- Don't add a routing or commit gate here. The profile owns cadence.
- Don't restate Act-3/4 procedure.
Pliki w paczce (4)
  • ADR-FORMAT.md 3 KB
  • CONTEXT-FORMAT.md 2 KB
  • SKILL.md 3 KB
  • THIRD-PARTY-NOTICES.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · 3orionkings/forge90MIT
3orionkings/forge90MIT

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

  • 100domain-model
    Przepytuje plan pod kątem istniejącego modelu domeny, doprecyzowuje terminologię i na bieżąco aktualizuje dokumentację (CONTEXT.md, ADR) w miarę zapadania decyzji.
  • 100domain-model
    Przepytuje plan pod kątem istniejącego modelu domeny, doprecyzowuje terminologię i na bieżąco aktualizuje dokumentację (CONTEXT.md, ADR) w miarę zapadania decyzji.
  • 90forge
    Planuje, buduje i testuje krzyżowo nietrywialną zmianę przed bezpieczną realizacją, a dla przeglądu planu, pojedynczego zlecenia albo odzyskiwania kieruje do innych skilli.
  • 90bootstrap-project
    Wdraża playbook w nowym lub istniejącym repozytorium: AGENTS.md, ADR 0001, dokumenty żywe, CI i zadania właściciela.
  • 100decisions
    Zapisuje decyzje architektoniczne jako krótkie ADR w docs/adr i prowadzi słownik pojęć projektu w GLOSSARY.md.
  • 100domain-modeling
    Buduje model domeny projektu, gdy zmienia się terminologia, albo przy GLOSSARY.md i zapisie decyzji ADR.

Uwagi i zgłoszenia

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