refresh-human-docs

Regenerate docs/human/PROJECTS.md and DECISIONS.md from knowledge graph files.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/lightningfastsls/London_Lab --skill refresh-human-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-human-docs
Source: https://github.com/lightningfastsls/London_Lab/tree/main/.claude/skills/refresh-human-docs
Command: npx skills add https://github.com/lightningfastsls/London_Lab --skill refresh-human-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Regenerate human-readable documentation in docs/human/ from the knowledge graph and operational state, ensuring teams have current project dashboards and decisions.

Core Features & Use Cases

  • Reads the active goals from ops/goals.md and the knowledge graph topic maps from notes/, including all topic maps listed in the index.
  • Synthesizes ROADMAP*.md files and IMPLEMENTATION_PROGRESS.md to produce up-to-date docs/human/PROJECTS.md and docs/human/DECISIONS.md.
  • Overwrites the generated artifacts with generated timestamps and respects legacy ADR numbering when mapping decisions.

Quick Start

Run the refresh-human-docs action to regenerate docs/human/PROJECTS.md and docs/human/DECISIONS.md.

Frequently Asked Questions about refresh-human-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate human-readable documentation from a project knowledge graph?

You can generate human-readable documentation by reading ops/goals.md, notes/index.md, topic maps, ROADMAP*.md, and IMPLEMENTATION_PROGRESS.md to synthesize up-to-date docs/human/PROJECTS.md and docs/human/DECISIONS.md with timestamps.

How do I keep project dashboards and decision logs up to date with roadmap changes?

Regenerate project dashboards and decision logs by synthesizing ROADMAP*.md and IMPLEMENTATION_PROGRESS.md files, overwriting docs/human/PROJECTS.md and docs/human/DECISIONS.md with current timestamps to reflect the latest knowledge graph state.

Can I preserve existing ADR numbering when regenerating decision documentation?

Yes, regenerating decision documentation respects legacy ADR numbering when mapping decisions to docs/human/DECISIONS.md, ensuring existing architecture decision records maintain their original identifiers during the overwrite process.

What's the best way to automate docs generation from operational state and notes?

Automate docs generation by reading active goals from ops/goals.md and all topic maps listed in notes/index.md, then synthesizing these inputs into structured human-readable project and decision documents with generated timestamps.

Does this documentation regeneration approach require any external dependencies?

No external dependencies are required. The regeneration process reads existing project files including ops/goals.md, notes/index.md, topic maps, ROADMAP*.md, and IMPLEMENTATION_PROGRESS.md and overwrites target docs in docs/human/ directly.

When do I need to regenerate human docs from knowledge graph state?

You need to regenerate human docs when project goals, roadmap entries, or implementation progress change, ensuring docs/human/PROJECTS.md and docs/human/DECISIONS.md accurately reflect the current knowledge graph and operational state.