doc-steward

Automate documentation lifecycle management by running orchestrated phases for auditing, cleaning, API surface extraction, and index rebuilding to maintain a searchable docs index. This process identifies stale docs, archives orphaned artifacts, and ensures your repository stays tidy.

Notion synchronization works by treating Notion as the primary truth source for sprint and roadmap data, pushing human-friendly documentation summaries to it. The extraction process aligns API surfaces and roadmap details by cross-referencing code sources with Notion data.

Yes, you can audit and archive stale docs automatically using YAML frontmatter standards. The lifecycle orchestration relies on these frontmatter standards to identify freshness gaps, tag orphaned docs to a done state, and move unused artifacts.

The best way to extract an API surface and rebuild a searchable docs index is to execute deterministic phase orchestration across the root and docs/ workspace. This generates up-to-date API documentation from code and syncs summaries for a human-friendly overview.

You do not need to run individual phases; you can execute the full documentation audit at once. Running the all phase executes audit, clean, api, sync, and backlog-sync in sequence to handle the complete documentation lifecycle automatically.