Name: doc-refresh
Author: zekiriabd

Prompt file imported from zekiriabd/SDD-Pro (.codex/prompts/doc-refresh.md). Fill in {{arguments}} before use. Copyright stays with the author.

Arguments: {{arguments}}

/doc-refresh

⚠️ Commande interne v7.0.0 — invoquée auto en fin de pipeline (/sdd-full, /dev-run, /qa-generate, arch Phase D). Régénère INDEX.md des ADRs via sdd_scripts/index_adrs.py (0 token, ~50 ms, idempotent). Préférer un orchestrateur en usage normal ; cette commande sert au debug/inspection ciblée.

Usage

/doc-refresh

Aucun argument. La commande scanne les ADRs du workspace et régénère l'index.

Fichier produit

Fichier	Description
`workspace/.sys/.context/adrs/INDEX.md`	Index ADRs (rebuild depuis `Glob workspace/.sys/.context/adrs/ADR-*.md`)

Quand l'utiliser

Manuel : après édition manuelle d'un ADR pour rafraîchir l'index.
Auto : fin de /sdd-full, /dev-run, /qa-generate, arch Phase D.

STEP 1 — Exécuter le script

python .sdd/python/sdd_scripts/index_adrs.py

Ou avec arguments explicites :

python .sdd/python/sdd_scripts/index_adrs.py \
  --adrs-dir workspace/.sys/.context/adrs \
  --output workspace/.sys/.context/adrs/INDEX.md \
  --template .sdd/templates/adrs-index.template.md

Le script :

Lit .sdd/templates/adrs-index.template.md
Glob workspace/.sys/.context/adrs/ADR-*.md
Parse pour chaque ADR : filename (timestamp ISO + slug), H1 titre, Status: body field (défaut Accepted), Phase: body field (heuristique slug si absent)
Render dans le template avec substitution {ADRRows}, {ADRCount}, {GeneratedAt}, {ProjectName}
Write atomique via .tmp + read-back self-check

STEP 2 — Confirmation

Le script émet 1 ligne (chat minimal succès) :

OK index_adrs — INDEX.md ({N} ADRs) refreshed

Si aucun ADR : OK index_adrs — INDEX.md (0 ADRs, empty) refreshed.

Codes d'erreur

Exit	Classe	Cause
`0`	—	succès
`1`	`[NOT_FOUND]`	template `adrs-index.template.md` manquant ou illisible
`2`	`[QA_OUTPUT_INVALID]`	atomic write self-check échec (corruption FS rare)

Idempotence stricte

Aucun état conservé entre runs
Le fichier INDEX.md est overwritten à chaque run
Peut être ré-invoqué sans risque, en parallèle de tout autre agent ou script (l'output ne croise aucune matrice de ownership.md §1, Partie A, ex-file-ownership.md)

Coût

0 token LLM ; latence ~50 ms ; aucun appel agent/build/test.

Install doc-refresh and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

Arguments: {{arguments}} # /doc-refresh > ⚠️ **Commande interne v7.0.0** — invoquée auto en fin de pipeline > (`/sdd-full`, `/dev-run`, `/qa-generate`, `arch` Phase D). Régénère > `INDEX.md` des ADRs via `sdd_scripts/index_adrs.py` (0 token, ~50 ms, > idempotent). Préférer un orchestrateur en usage normal ; cette > commande sert au debug/inspection ciblée. ## Usage ``` /doc-refresh ``` Aucun argument. La commande scanne les ADRs du workspace et régénère l'index. ## Fichier produit | Fichier | Description | |---|---| | `workspace/.sys/.context/adrs/INDEX.md` | Index ADRs (rebuild depuis `Glob workspace/.sys/.context/adrs/ADR-*.md`) | ## Quand l'utiliser - **Manuel** : après édition manuelle d'un ADR pour rafraîchir l'index. - **Auto** : fin de `/sdd-full`, `/dev-run`, `/qa-generate`, `arch` Phase D. ## STEP 1 — Exécuter le script ```bash python .sdd/python/sdd_scripts/index_adrs.py ``` Ou avec arguments explicites : ```bash python .sdd/python/sdd_scripts/index_adrs.py \ --adrs-dir workspace/.sys/.context/adrs \ --output workspace/.sys/.context/adrs/INDEX.md \ --template .sdd/templates/adrs-index.template.md ``` Le script : 1. Lit `.sdd/templates/adrs-index.template.md` 2. Glob `workspace/.sys/.context/adrs/ADR-*.md` 3. Parse pour chaque ADR : filename (timestamp ISO + slug), H1 titre, `Status:` body field (défaut `Accepted`), `Phase:` body field (heuristique slug si absent) 4. Render dans le template avec substitution `{ADRRows}`, `{ADRCount}`, `{GeneratedAt}`, `{ProjectName}` 5. Write atomique via `.tmp` + read-back self-check ## STEP 2 — Confirmation Le script émet **1 ligne** (chat minimal succès) : ``` OK index_adrs — INDEX.md ({N} ADRs) refreshed ``` Si aucun ADR : `OK index_adrs — INDEX.md (0 ADRs, empty) refreshed`. ## Codes d'erreur | Exit | Classe | Cause | |---|---|---| | `0` | — | succès | | `1` | `[NOT_FOUND]` | template `adrs-index.template.md` manquant ou illisible | | `2` | `[QA_OUTPUT_INVALID]` | atomic write self-check échec (corruption FS rare) | ## Idempotence stricte - Aucun état conservé entre runs - Le fichier `INDEX.md` est overwritten à chaque run - Peut être ré-invoqué sans risque, en parallèle de tout autre agent ou script (l'output ne croise aucune matrice de `ownership.md §1`, Partie A, ex-file-ownership.md) ## Coût - **0 token LLM** ; latence ~50 ms ; aucun appel agent/build/test.

{ "prompt": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nArguments: {{arguments}}\n\n# /doc-refresh\n\n> ⚠️ **Commande interne v7.0.0** — invoquée auto en fin de pipeline\n> (`/sdd-full`, `/dev-run`, `/qa-generate`, `arch` Phase D). Régénère\n> `INDEX.md` des ADRs via `sdd_scripts/index_adrs.py` (0 token, ~50 ms,\n> idempotent). Préférer un orchestrateur en usage normal ; cette\n> commande sert au debug/inspection ciblée.\n\n## Usage\n\n```\n/doc-refresh\n```\n\nAucun argument. La commande scanne les ADRs du workspace et régénère\nl'index.\n\n## Fichier produit\n\n| Fichier | Description |\n|---|---|\n| `workspace/.sys/.context/adrs/INDEX.md` | Index ADRs (rebuild depuis `Glob workspace/.sys/.context/adrs/ADR-*.md`) |\n\n## Quand l'utiliser\n\n- **Manuel** : après édition manuelle d'un ADR pour rafraîchir l'index.\n- **Auto** : fin de `/sdd-full`, `/dev-run`, `/qa-generate`, `arch` Phase D.\n\n## STEP 1 — Exécuter le script\n\n```bash\npython .sdd/python/sdd_scripts/index_adrs.py\n```\n\nOu avec arguments explicites :\n\n```bash\npython .sdd/python/sdd_scripts/index_adrs.py \\\n --adrs-dir workspace/.sys/.context/adrs \\\n --output workspace/.sys/.context/adrs/INDEX.md \\\n --template .sdd/templates/adrs-index.template.md\n```\n\nLe script :\n1. Lit `.sdd/templates/adrs-index.template.md`\n2. Glob `workspace/.sys/.context/adrs/ADR-*.md`\n3. Parse pour chaque ADR : filename (timestamp ISO + slug), H1 titre,\n `Status:` body field (défaut `Accepted`), `Phase:` body field\n (heuristique slug si absent)\n4. Render dans le template avec substitution `{ADRRows}`, `{ADRCount}`,\n `{GeneratedAt}`, `{ProjectName}`\n5. Write atomique via `.tmp` + read-back self-check\n\n## STEP 2 — Confirmation\n\nLe script émet **1 ligne** (chat minimal succès) :\n\n```\nOK index_adrs — INDEX.md ({N} ADRs) refreshed\n```\n\nSi aucun ADR : `OK index_adrs — INDEX.md (0 ADRs, empty) refreshed`.\n\n## Codes d'erreur\n\n| Exit | Classe | Cause |\n|---|---|---|\n| `0` | — | succès |\n| `1` | `[NOT_FOUND]` | template `adrs-index.template.md` manquant ou illisible |\n| `2` | `[QA_OUTPUT_INVALID]` | atomic write self-check échec (corruption FS rare) |\n\n## Idempotence stricte\n\n- Aucun état conservé entre runs\n- Le fichier `INDEX.md` est overwritten à chaque run\n- Peut être ré-invoqué sans risque, en parallèle de tout autre agent\n ou script (l'output ne croise aucune matrice de\n `ownership.md §1`, Partie A, ex-file-ownership.md)\n\n## Coût\n\n- **0 token LLM** ; latence ~50 ms ; aucun appel agent/build/test.", "variables": [ "arguments" ], "notes": "Arguments: ${arguments}", "metadata": { "source": { "provider": "github-codex-prompts", "repository": "https://github.com/zekiriabd/SDD-Pro", "path": ".codex/prompts/doc-refresh.md", "ref": "d61307fb26d4341b99c51c95629b6c43c5c35451", "url": "https://github.com/zekiriabd/SDD-Pro/blob/d61307fb26d4341b99c51c95629b6c43c5c35451/.codex/prompts/doc-refresh.md", "key": "zekiriabd/SDD-Pro/.codex/prompts/doc-refresh.md" } } }

doc-refresh

About