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.
- Autor
- 3orionkings ↗
- Repozytorium
- forge ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 28.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.
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
- Load the domain canon first
- Resolve one decision at a time
- Keep the docs living
- Lock and hand off
- Source
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · 3orionkings/forge | 90 | MIT |
| 3orionkings/forge | 90 | MIT |
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.