Docs Update

Purpose

Close the coherence loop between code and architecture docs. Compare knowledge graph truth against module doc frontmatter, update drifted fields, and optionally refresh narrative sections.

Mastery Levels (ShuHaRi)

Shu: Present every diff, ask before every change
Ha: Batch frontmatter changes with single HITL gate, narrative only for structural changes
Ri: Autonomous frontmatter updates, HITL only for narrative

Context

When to use: After stories that changed code structure, during /rai-story-close, after discovery refresh.

When to skip: Stories that only changed tests/docs/non-code. No graph available.

Inputs: Knowledge graph (.raise/rai/memory/index.json), module docs ().

<verification> Module list identified for comparison. </verification> <verification> Drifted fields identified per module. </verification> <verification> Frontmatter updates applied (or skipped by user). </verification> <verification> Narrative changes applied or no triggers found. </verification> <verification> Graph reflects updated docs. Coherence loop closed. </verification>

Docs Update

Purpose

Close the coherence loop between code and architecture docs. Compare knowledge graph truth against module doc frontmatter, update drifted fields, and optionally refresh narrative sections.

Mastery Levels (ShuHaRi)

Shu: Present every diff, ask before every change
Ha: Batch frontmatter changes with single HITL gate, narrative only for structural changes
Ri: Autonomous frontmatter updates, HITL only for narrative

Context

When to use: After stories that changed code structure, during /rai-story-close, after discovery refresh.

When to skip: Stories that only changed tests/docs/non-code. No graph available.

Inputs: Knowledge graph (.raise/rai/memory/index.json), module docs ().

Doc field	Graph truth	Comparison
`depends_on`	`code_imports`	Sort both, compare sets
`depended_by`	Reverse lookup from other modules	Computed
`public_api`	`code_exports`	Sort both, compare sets
`components`	`code_components`	Direct number

Item	Destination
Updated frontmatter	`governance/architecture/modules/*.md`
Narrative changes	`governance/architecture/modules/*.md` (with HITL)
Summary	Displayed

Rai Docs Update

Docs Update

Purpose

Mastery Levels (ShuHaRi)

Context

Rai Docs Update

Docs Update

Purpose

Mastery Levels (ShuHaRi)

Context

Steps

Step 1: Build Graph & Identify Affected Modules

Step 2: Compare Frontmatter Per Module

Step 3: HITL Gate — Apply Frontmatter

Step 4: Narrative Review (if triggered)

Step 5: Rebuild & Summarize

Output

Quality Checklist

References

Notion

Feishu Wiki

Gemini

Obsidian Vault Maintainer

Openclaw Pr Maintainer

Wiki Maintainer