oa-quality-guardians

Append new lessons, roadmap progress, and decisions to Markdown documentation files.

4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Open-Agents --skill oa-quality-guardians
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oa-quality-guardians
Source: https://github.com/OpenAEC-Foundation/Open-Agents/tree/main/.claude/skills/oa-quality-guardians
Command: npx skills add https://github.com/OpenAEC-Foundation/Open-Agents --skill oa-quality-guardians

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that core project documentation (LESSONS.md, ROADMAP.md, DECISIONS.md) is automatically updated with new learnings, completed tasks, and architectural decisions, preventing knowledge loss and maintaining project clarity.

Core Features & Use Cases

  • Automated Documentation Updates: Guardians are spawned to append new information to critical documentation files.
  • Knowledge Accumulation: Ensures lessons learned, roadmap progress, and decisions are persistently recorded.
  • Use Case: After a development session concludes, guardians automatically update LESSONS.md with new insights and ROADMAP.md with completed tasks, ensuring the project's knowledge base is always current.

Quick Start

Use the oa-quality-guardians skill to update documentation after a session ends.

Frequently Asked Questions about oa-quality-guardians

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

FAQPage Schema
How do I automatically update project documentation like lessons learned and roadmaps after a development session?

To automate documentation updates, you can use a skill that reads session logs and appends new, non-duplicated information to Markdown files. This ensures lessons learned, roadmap progress, and decisions are persistently recorded after sessions conclude.

What is the best way to maintain architectural decisions and knowledge bases without manual entry?

Maintaining architectural decisions and knowledge bases without manual entry involves spawning automated guardians. These guardians append new insights to specified Markdown files, preventing knowledge loss and maintaining project clarity automatically.

How do I prevent duplicate entries when appending new insights to Markdown documentation?

To prevent duplicate entries when appending new insights to Markdown documentation, the automation process specifically reads existing session logs and agent outputs. It identifies and appends only new, non-duplicated information to the target files.

When should I use automated post-session workflows for knowledge management?

You should use automated post-session workflows for knowledge management when a development session or batch concludes. This timing ensures that new learnings, completed tasks, and architectural decisions are captured immediately while context is fresh.

Does this documentation automation work without external dependencies?

Yes, this documentation automation works without external dependencies. It relies solely on reading internal session logs and agent outputs to update core project documentation files directly within your existing environment.

Can I use this approach to update multiple Markdown files like LESSONS.md and ROADMAP.md simultaneously?

Yes, you can update multiple Markdown files like LESSONS.md and ROADMAP.md simultaneously. The automation spawns guardians to append new information across critical documentation files, ensuring the entire project knowledge base remains current.