board-rebuild

board-rebuild is a command for Claude Code from GhostlyGawd/engineering-board. It costs 61 tokens per session (1,703 once invoked), scanned A, original, MIT.

A command that rebuilds the board index and structural graph from the Markdown entry files stored on disk. The index is a summary of entries, while the graph records their relationships and structure.

In plain words
What is it for?
Use it after changing board entry files or whenever the board looks out of date. It can rebuild every project or one named project.
Why use it?
It fixes cases where generated board files no longer match the underlying bugs, features, questions, or observations.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter.

Part of the engineering-board plugin — 6 skills, 21 commands, 8 agents, 4 hooks, 1 MCP server shipped together

Good fit Use it after changing board entry files or whenever the board looks out of date. It can rebuild every project or one named project.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/ghostlygawd/engineering-board/board-rebuild
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/GhostlyGawd/engineering-board

Made for: Claude Code.

Or install engineering-board, the plugin that ships this one along with the rest of its 6 skills, 21 commands, 8 agents, 4 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for board-rebuild

README.md
[![agentmods](https://agentmods.dev/badge/commands/ghostlygawd/engineering-board/board-rebuild.svg)](https://agentmods.dev/commands/ghostlygawd/engineering-board/board-rebuild)
Your own site
<a href="https://agentmods.dev/commands/ghostlygawd/engineering-board/board-rebuild"><img src="https://agentmods.dev/badge/commands/ghostlygawd/engineering-board/board-rebuild.svg" alt="Measured on agentmods" height="20"></a>
Per session 61 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,703 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00061 $0.01703
Opus 5 $0.00030 $0.00851
Sonnet 5 $0.00012 $0.00341
Haiku 4.5 $0.00006 $0.00170

Measured 7d ago against content hash e6dab84fb210, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

board-rebuild scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/board-rebuild.md · 120 lines

How it starts

The opening of the file, as written. The whole thing — 120 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/board-rebuild: regenerate BOARD.md and GRAPH.yml from the filesystem

The deterministic-cache refresh command. Treats the entry .md files in bugs/, features/, questions/, observations/ as the single source of truth and regenerates both BOARD.md (the index) and GRAPH.yml (the structural graph) from them. This is the fix for B004 (board state drifts from filesystem).

Safe to run anytime. Both outputs are deterministic: same input always produces byte-identical output (modulo generated_at in GRAPH.yml). No LLM calls in the regeneration step.

Other modifying commands should call this as their last step (intake, resolve, manual entry edits). That closes the staleness loop entirely.

Trigger

  • /board-rebuild: rebuild every project in BOARD-ROUTER.md
  • /board-rebuild <project-name>: rebuild just that project

Process

Step 1 — Resolve target board(s)

Resolve the board router in this order (first hit wins): $CLAUDE_PROJECT_DIR/engineering-board/BOARD-ROUTER.md (default since 1.1.0), then $CLAUDE_PROJECT_DIR/docs/boards/BOARD-ROUTER.md (compat). Target either the named project or all listed. Fall back to legacy docs/board/ if no router.

Step 2 — Scan entry files

For each project's board directory, list *.md files under bugs/, features/, questions/, observations/. Parse YAML frontmatter from each: id, type, priority, status, title, pattern, tags, blocked_by.

Step 3 — Validate

Report (do not auto-fix) any of:

  • Duplicate IDs: same id: field across two or more files. Indicates parallel-write corruption (B005).
  • Resolved entries still listed in BOARD.md: entry has status: resolved but appears in current BOARD.md's Open section. Will be removed in this rebuild.
  • Orphan resolved entries: entry has status: resolved but not in ARCHIVE.md. Should be archived manually or via /board-resolve. Do not auto-archive (resolutions need provenance).
  • Missing required frontmatter: id, type, title, discovered missing. Report path for manual fix.
  • Dangling blocked_by: references: blocked_by: lists a Q### that does not exist or is resolved. Report.

Read the full file on GitHub · 120 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 120 lines · 61 tokens per session scan A e6dab84fb210

Subscribe to this mod's changes

board-rebuild is a command published in the GitHub repository GhostlyGawd/engineering-board (0 stars, last pushed yesterday), licensed MIT. It adds 61 tokens to every session and 1,703 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.