Menü
Refresh Forge KB and workflow links in agent instruction files (CLAUDE.md, AGENTS.md, etc.)
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | refresh-kb-links |
| description | Refresh Forge KB and workflow links in agent instruction files (CLAUDE.md, AGENTS.md, etc.) |
Scan every coding-agent instruction file in the project and ensure each has
up-to-date links to the Forge knowledge base and generated workflow entry points.
This skill is invoked by /forge:refresh-kb-links or conversationally via /forge:ask.
Read the Forge config to determine the KB root path:
KB_PATH: !`node -e "try{console.log(require('./.forge/config.json').paths.engineering)}catch{console.log('engineering')}"`
Detect which of these files exist in the project root:
| File | Coding tool |
|---|---|
CLAUDE.md | Claude Code |
AGENTS.md | OpenAI Codex / generic |
AGENT.md | generic |
.github/copilot-instructions.md | GitHub Copilot |
.cursorrules | Cursor (legacy) |
.cursor/rules/*.mdc | Cursor (current) |
GEMINI.md | Google Gemini |
For each file found, check whether it already contains managed Forge sections.
Each file may have two independent managed sections:
Open marker (prefix match — tolerates minor text variations):
<!-- forge-kb-links
Close marker (exact):
<!-- /forge-kb-links -->
Open marker (prefix match):
<!-- forge-workflow-links
Close marker (exact):
<!-- /forge-workflow-links -->
Only include rows for files that actually exist on disk:
{KB_PATH}/MASTER_INDEX.md → "All sprints, tasks, bugs, and features"{KB_PATH}/architecture/INDEX.md → "Stack, processes, database, routing, deployment"{KB_PATH}/business-domain/INDEX.md → "Entity model and domain concepts"<!-- forge-kb-links: managed by Forge — do not edit manually -->
## Forge Knowledge Base
| Index | Contents |
|-------|----------|
| [MASTER_INDEX]({KB_PATH}/MASTER_INDEX.md) | All sprints, tasks, bugs, and features |
| [Architecture]({KB_PATH}/architecture/INDEX.md) | Stack, processes, database, routing, deployment |
| [Business Domain]({KB_PATH}/business-domain/INDEX.md) | Entity model and domain concepts |
Personas live in `.forge/personas/`.
<!-- /forge-kb-links -->
Only include rows for workflow files that actually exist on disk. Check each:
Atomic workflows (LLM-generated markdown in .forge/workflows/):
.forge/workflows/plan_task.md → "Research codebase → implementation plan".forge/workflows/implement_plan.md → "Execute approved plan → code changes".forge/workflows/architect_sprint_plan.md → "Sprint planning and task decomposition".forge/workflows/architect_sprint_intake.md → "Sprint intake and requirements elicitation"Orchestration is deterministic JS, not prose. The LLM orchestration workflows
(orchestrate_task / run_sprint / fix_bug) are retired — link the JS
drivers in .claude/workflows/ instead (only include rows where the file exists):
.claude/workflows/wfl-run-task.js → "Full task pipeline (plan → implement → review → approve → commit)".claude/workflows/wfl-run-sprint.js → "Full sprint orchestration".claude/workflows/wfl-fix-bug.js → "Triage → fix → verify"<!-- forge-workflow-links: managed by Forge — do not edit manually -->
## Forge Workflows
| Workflow | Purpose |
|----------|---------|
| [Plan](.forge/workflows/plan_task.md) | Research codebase → implementation plan |
| [Implement](.forge/workflows/implement_plan.md) | Execute approved plan → code changes |
| [Run task](.claude/workflows/wfl-run-task.js) | Full task pipeline (plan → implement → review → approve → commit) |
| [Run sprint](.claude/workflows/wfl-run-sprint.js) | Full sprint orchestration |
| [Fix bug](.claude/workflows/wfl-fix-bug.js) | Triage → fix → verify |
<!-- /forge-workflow-links -->
(Only include rows where the referenced file exists on disk.)
Before scanning agent instruction files, verify that the knowledge graph itself is complete. The collate tool generates INDEX.md files at every node of the graph; if they are missing, links in MASTER_INDEX.md are broken and agents navigate to dead ends.
Check the following, using KB_PATH as the root:
Sprint INDEX files — for every directory under {KB_PATH}/sprints/, check that
{KB_PATH}/sprints/{sprint-dir}/INDEX.md exists.
Task INDEX files — for every subdirectory under {KB_PATH}/sprints/{sprint-dir}/
that looks like a task folder (contains at least one .md file), check that its
INDEX.md exists.
Bug INDEX files — for every directory under {KB_PATH}/bugs/, check that
{KB_PATH}/bugs/{bug-dir}/INDEX.md exists.
If any INDEX files are missing, prepend this warning to the output (before the agent-file approval prompt):
⚠️ KB knowledge graph has broken links — INDEX.md files are missing:
△ {KB_PATH}/sprints/PROJ-S01/INDEX.md — missing
△ {KB_PATH}/sprints/PROJ-S01/PROJ-S01-T01/INDEX.md — missing
△ {KB_PATH}/bugs/PROJ-B01-some-bug/INDEX.md — missing
Run collate to regenerate them:
node "$FORGE_ROOT/tools/collate.cjs"
If all INDEX files are present (or there are no sprint/task/bug folders yet), skip this block entirely. Do not warn when the KB is intact.
For each detected agent instruction file, check both sections:
After scanning all files, present a single consolidated approval prompt:
🏮 forge:refresh-kb-links — KB & Workflow Visibility
Forge has generated a knowledge base and SDLC workflows for this project. Without links
to these in your agent instruction files, every new conversation starts blind — no KB
context, no workflow playbook.
Found agent instruction files:
〇 CLAUDE.md — no Forge KB links, no workflow links
〇 AGENTS.md — no Forge KB links, no workflow links
Add ## Forge Knowledge Base and ## Forge Workflows sections to each? [Y/n]
(or choose individually: [c])
Adapt the status lines to reflect the actual state:
〇 {filename} — no Forge KB links, no workflow links (both missing)〇 {filename} — KB links stale (KB section present but stale)〇 {filename} — workflow links stale (workflow section present but stale)〇 {filename} — KB links stale, workflow links stale (both stale)〇 {filename} — links current, no changes needed (both present and current — skip)If all detected files already have current links: output:
🏮 forge:refresh-kb-links — all KB and workflow links are current. No changes needed.
And return without prompting.
On approval ([Y] or per-file confirm):
Write the {KB_PATH} substitution with the actual resolved path value (not the literal
string {KB_PATH}). The resulting markdown should have real paths like engineering/MASTER_INDEX.md
or ai-docs/MASTER_INDEX.md.
On a second run where all links are already current, output the "all links current" message and return immediately. Do not re-write unchanged sections.
If the user later renames the KB folder:
node "$FORGE_ROOT/tools/manage-config.cjs" set paths.engineering <new-name>forge:refresh-kb-links to refresh the links in all agent instruction files.Sole authorized gateway for reading and writing the Forge JSON store (.forge/store/). Use whenever a workflow needs to write sprints, tasks, bugs, features, or events — or read/list/validate/transition them. All store mutations MUST go through store-cli.cjs, never by writing files directly.
Reference for the Forge NLP query grammar — entity synonyms, status synonyms, ordering tokens, FK phrases, and ID patterns. Use when constructing or debugging store-query-nlp queries, or to understand why a query returned unexpected results.
Query the Forge store using natural language. Use when you need to find tasks, bugs, sprints, or features by intent — e.g. 'open bugs in S12', 'blocked tasks', 'tasks implementing the auth feature', 'how many bugs are critical'. Returns structured JSON with entity IDs, titles, statuses, relationships, file refs, and INDEX.md excerpts.
Byte-precise, token-cheap code navigation via tree-sitter — outline a file, find or define a symbol, read one symbol's body, find callers, map a directory's dependency graph, go-to-def, and syntax-check after edits. The first move for any where-is / what's-in / who-calls question, in any language grove has a grammar for — with grep, rg, and read kept for text search and quick facts.