Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

forge-with-docs

/forge-with-docs

Planuje nietrywialną zmianę w repozytorium, w którym słownik domenowy, model kontekstu i ADR-y są wiążące i wymagają aktualizacji.

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

Planuje nietrywialną zmianę w repozytorium, w którym słownik domenowy, model kontekstu i ADR-y są wiążące i wymagają aktualizacji.

Oryginalny opis (EN)

Use when planning a non-trivial change in a repository whose domain glossary, context model, or ADRs must remain authoritative.

Jak działa

  1. Load the domain canon first
  2. Resolve one decision at a time
  3. Keep the docs living
  4. Lock and hand off
  5. Source
Sekcje z nagłówków SKILL.md, w oryginale · 74 linii, 475 słów
Podgląd SKILL.md
---
name: forge-with-docs
description: Use when planning a non-trivial change in a repository whose domain glossary, context model, or ADRs must remain authoritative.
---

# Forge With Docs

Forge With Docs is the **docs-aware Act 1** variant of shared
[Forge](../forge/SKILL.md). Codex remains the requirements interviewer, plan
arbiter, and integration authority. Owner/repository rules bind; no product work.

## Load the domain canon first

Complete this load before the first owner question:

1. Read `CONTEXT-MAP.md` and each relevant referenced `CONTEXT.md`, or the root
   `CONTEXT.md`, plus any authoritative glossary or domain model.
2. Read the relevant existing ADRs, repository instructions, and the
   [context](CONTEXT-FORMAT.md) and [ADR](ADR-FORMAT.md) formats.
3. Start a **terminology ledger** containing the established term, definition,
   avoided synonyms, source document, observed code usage, proposed meaning, and
   status (`open`, `resolved`, or `rejected`).
4. First inspect code, tests, schemas, and call sites for discoverable local facts.
   Record canon/code drift instead of asking what inspection can answer.

Present canon/code drift as evidence; confirmed intent decides which side changes.

## Resolve one decision at a time

For every open requirement or terminology collision:

1. state the decision and cite the domain documents and code already inspected;
2. test it with concrete legal-domain scenarios, not only abstractions;
3. recommend one answer and explain its material tradeoff;
4. ask **one question at a time** and wait for the answer;
5. record the answer and resolve or reject the ledger entry before asking the next
   question.

Never batch unresolved decisions. Challenge reuse of an established term with a new
meaning; sharpen fuzzy terms and name preferred and avoided vocabulary.

## Keep the docs living

Update the glossary, `CONTEXT.md`, or `CONTEXT-MAP.md` as each decision settles;
never defer it all until after implementation.
Create a dated or sequential ADR only when the choice meets the threshold in
[ADR-FORMAT.md](ADR-FORMAT.md), and record its context, decision, and consequences.
Do not write speculative entries, unrelated docs, or product code. Act-1 writes are
settled domain docs, qualifying ADRs, `PLAN.md`, and `PLAN-REVIEW-LOG.md` only.

## Lock and hand off

Lock `PLAN.md` and initialize `PLAN-REVIEW-LOG.md` exactly as shared
[Acts 1–2](../forge/references/acts-1-2.md) requires, recording resolved terminology,
doc/ADR identities, acceptance, risks, and exclusions.

For the Act-2 start, pin the absolute plan and review-log controls and declare every
relevant glossary, context document, and ADR through `review_controls.domain_docs`.
Those domain declarations are a **canonical sorted unique** list of at most 64
**worktree-relative** `{path, sha256}` records. On each same-session review resume,
repeat the **same domain-document path set** with **current hashes**, together with
the current plan/review-log hashes and baseline. A changed set is a new contract.

Then **hand the locked plan unchanged into shared Acts 2–4**. The shared
[Acts 3–4](../forge/references/acts-3-4.md), [engine](../forge/ENGINE.md),
[routing policy](../forge/ROUTING-POLICY.md), and selected
[Sprint](../forge/profiles/sprint.md) or [Assured](../forge/profiles/assured.md)
profile remain the only execution authorities.

This variant **adds no gate**, **adds no approval**, **adds no routing**, **adds no
review**, **adds no build**, **adds no proof**, and **adds no commit cadence**.
It never transfers Codex integration authority or executor Git authority.

## Source

The docs-aware Act-1 method and formats are adapted from Matt Pocock's
`grill-with-docs` under the MIT License.
Pliki w paczce (4)
  • ADR-FORMAT.md 2 KB
  • CONTEXT-FORMAT.md 2 KB
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB

Wersje

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

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

  • 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.
  • 100decisions
    Zapisuje decyzje architektoniczne jako krótkie ADR w docs/adr i prowadzi słownik pojęć projektu w GLOSSARY.md.
  • 100s-domain-modeling
    Buduje i doprecyzowuje model domeny projektu: słownik pojęć w GLOSSARY.md oraz zapisy ADR przy zmianach terminów i reguł.
  • 100domain-modeling
    Buduje i wyostrza model domenowy projektu przy rozmowach o terminologii kodu oraz pisaniu i edycji pliku GLOSSARY.md i ADR.
  • 100docs-domain-modeling
    Buduje model domenowy projektu: glosariusz CONTEXT.md i język ubikwitarny, gdy trzeba ustalić terminologię lub agent używa niewłaściwych słów.
  • 90forge
    Kwestionuje większą zmianę w oprogramowaniu innym modelem i dzieli wdrożenie na ograniczone jednostki pracy.

Uwagi i zgłoszenia

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