ai-decision-doc-maintainer

Automate maintenance of Claude Code and Copilot decision documentation and D2 diagrams.

Updated May 7, 2026
One-click install
npx skills add https://github.com/Trophalaxeur/bismuth-blog --skill ai-decision-doc-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-decision-doc-maintainer
Source: https://github.com/Trophalaxeur/bismuth-blog/tree/main/.claude/skills/ai-decision-doc-maintainer
Command: npx skills add https://github.com/Trophalaxeur/bismuth-blog --skill ai-decision-doc-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Maintient à jour Claude Code / GitHub Copilot / homelab decision documentation in docs/ai-agent-decision-tree/. Use when you need to update the Markdown matrix, check pricing/quotas online, modify the D2 diagram, regenerate the diagram image, or refresh sources.

Core Features & Use Cases

  • Maintains the target files: Markdown decision matrix, D2 diagram, and diagram images.
  • Ensures references and visuals stay in sync with current tooling choices and pricing.
  • Use case: when decisions, pricing, or quotas change, run the skill to refresh the decision tree context and diagrams.

Quick Start

Invoke ai-decision-doc-maintainer to update the decision matrix and regenerate the D2 diagram in docs/ai-agent-decision-tree/.

Frequently Asked Questions about ai-decision-doc-maintainer

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

FAQPage Schema
How do I automate updating a Markdown decision matrix when Claude Code or Copilot pricing changes?

To automate decision matrix updates, this skill runs a shell script that verifies online pricing and quotas, then directly refreshes the Markdown decision matrix in your documentation directory.

What is the best way to keep a D2 decision tree diagram in sync with current tooling choices?

Keeping a D2 decision tree diagram in sync is handled by refreshing the D2 diagram source and automatically regenerating the diagram image to match your current tooling decisions.

How do I regenerate D2 diagram images for my AI agent decision tree documentation?

You can regenerate D2 diagram images by invoking the maintenance skill, which executes the update shell script to rebuild the visual outputs in the docs/ai-agent-decision-tree/ directory.

Can I use a shell script to enforce consistency checks across Markdown and D2 decision documentation?

Yes, you can enforce consistency checks using the included shell script, which applies checks and regeneration rules to keep both the Markdown matrix and D2 diagram current.

Do I need specific dependencies installed to run the decision documentation update script?

The skill requires no external dependencies to run, relying solely on the included shell script to handle the documentation, diagram, and source refreshing processes.