update-overview

Regenerate four mermaid diagrams in overall.md from lodged specs.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/tim-hub/powerball --skill update-overview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-overview
Source: https://github.com/tim-hub/powerball/tree/main/pbl/skills/update-overview
Command: npx skills add https://github.com/tim-hub/powerball --skill update-overview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains a living overall.md in .powerball/lodge/ that captures the project’s cumulative state through four mermaid diagrams, reducing manual maintenance and keeping stakeholders oriented.

Core Features & Use Cases

  • Regenerates Feature Mindmap, Architecture, User Journey, and Data Model diagrams from lodged specs.
  • Reads lodged spec artefacts (exploration.md, plan.md, tasks.md) to reflect current work and decisions.
  • Supports targeted regeneration for a specific spec or a full project view.

Quick Start

Regenerate the project overview by running the update-overview process to refresh diagrams from all lodged specs in .powerball/lodge/.

Frequently Asked Questions about update-overview

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

FAQPage Schema
How do I automatically generate mermaid diagrams from project specs?

Automatically generating mermaid diagrams from project specs requires reading lodged spec artefacts like exploration.md, plan.md, and tasks.md. This process regenerates Feature Mindmap, Architecture, User Journey, and Data Model visuals directly from those lodged files to capture the cumulative project state.

What is a living project overview and how does it stay updated?

A living project overview is an overall.md file reflecting current work through four mermaid diagrams. It stays updated by automatically regenerating its visuals whenever new specs are lodged into the .powerball/lodge directory, reducing manual maintenance.

Can I regenerate a single architecture diagram instead of the full project overview?

Yes, you can regenerate a single architecture diagram instead of the full project overview. The process supports targeted regeneration for a specific lodged spec, allowing you to update individual visuals without regenerating all four diagrams.

Do I need spec artefacts in .powerball/lodge to update the overview?

Yes, you need spec artefacts in .powerball/lodge to update the overview. The process reads lodged exploration.md, plan.md, and tasks.md files directly from this directory to build and update the Feature Mindmap, Architecture, User Journey, and ER diagrams.

What's the best way to maintain an ER diagram for an evolving data model?

The best way to maintain an ER diagram for an evolving data model is to automate regeneration from lodged specs. By reading tasks.md and plan.md artefacts, the system updates the Data Model ER diagram automatically, ensuring it reflects current decisions without manual editing.

Why is my project overview diagram not reflecting recent spec changes?

Your project overview diagram is not reflecting recent spec changes because the update process must be triggered to read newly lodged specs. Running the update process regenerates all four diagrams from the current exploration.md, plan.md, and tasks.md files to capture the latest cumulative state.