living-docs

Generate and update C4 diagrams and glossary from project documentation.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/nullhack/pytest-beehave --skill living-docs-nullhack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: living-docs
Source: https://github.com/nullhack/pytest-beehave/tree/main/.opencode/skills/living-docs
Command: npx skills add https://github.com/nullhack/pytest-beehave --skill living-docs-nullhack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate and update two living documents after a feature is accepted (Step 5) or on stakeholder request: the C4 architecture diagrams and the living glossary, both derived from existing project documentation; no new decisions are made.

Core Features & Use Cases

  • Automatically generate and update C4 context and container diagrams from discovery, architecture decisions, and completed feature files.
  • Maintain a living glossary derived from the project docs, architecture decisions, and domain model, extending existing entries rather than overwriting them.
  • On demand read phase to enrich diagrams and glossary with latest project context and decisions.

Quick Start

Refresh the living C4 diagrams and glossary after a feature is accepted or on stakeholder request.

Frequently Asked Questions about living-docs

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

FAQPage Schema
How do I automate C4 diagram generation from existing markdown documentation?

Automate C4 diagram generation by reading discovery, architecture, and completed feature docs to derive context and container markdown files. This keeps diagrams synchronized with project evolution without manual diagramming effort.

What is the best way to maintain a living glossary derived from project documentation?

Maintain a living glossary by deriving terms from discovery docs, architecture decisions, and completed features. The process extends existing glossary entries rather than overwriting them, ensuring domain terminology stays current.

How do I keep architecture diagrams in sync after a feature is accepted?

Keep architecture diagrams in sync by triggering an on-demand read phase after feature acceptance. This updates context and container diagrams using the latest project context and decisions from completed feature files.

Can I generate C4 context and container diagrams without modifying my original architecture decisions?

You can generate C4 context and container diagrams without modifying original decisions. The process reads existing architecture and discovery files strictly as inputs, ensuring your core architectural records remain immutable.

When should I update my living architecture diagrams and glossary?

Update living architecture diagrams and glossary during feature lifecycles for release readiness or on stakeholder request. This ensures documentation reflects current discovery, architecture decisions, and recently completed features.

Why do my architecture diagrams and glossary keep falling out of sync with my project docs?

Diagrams and glossary fall out of sync when maintained manually. Automating extraction from discovery, architecture, and completed feature docs ensures generated context, container, and glossary files match your project state.