skills.rest
specvital
specvitalOFFICIAL
Explore all skills by this author →
GitHub

adr-discover

Identify architectural decisions lacking ADR documentation across Specvital repositories.

1|Updated Dec 17, 2025
Search Tags:#automation#architecture#documentation#adr#discovery#mult-agent
One-click install
npx skills add https://github.com/specvital/specvital.github.io --skill adr-discover
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-discover
Source: https://github.com/specvital/specvital.github.io/tree/main/.claude/skills/adr-discover
Command: npx skills add https://github.com/specvital/specvital.github.io --skill adr-discover

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR documentation is often missing or out of date across Specvital repositories, which makes it hard to track architectural decisions and onboard new team members.

Core Features & Use Cases

  • Discover ADR candidates across the Specvital platform repositories using a structured, multi-phase workflow.
  • Coordinate a collaboration pipeline (specialist, strategist, writer) to surface, prioritize, and format ADRs.
  • Produce adr-candidates.md with references to repositories and commits for review and governance.

Quick Start

Run the ADR discovery workflow to identify missing ADRs across all Specvital repositories and prepare an adr-candidates.md report.

Frequently Asked Questions about adr-discover

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

FAQPage Schema
How do I find undocumented architecture decisions across multiple repositories?▼

ADR discovery scans core, web, worker, and infra repositories to surface architectural decisions lacking ADR documentation. It outputs a prioritized adr-candidates.md list with repository references and related commits for governance review.

What is the best way to automate ADR backlog creation for software engineering teams?▼

Automating ADR backlog creation uses a multi-agent pipeline of specialist, strategist, and writer to surface, prioritize, and format new ADR candidates. It produces an adr-candidates.md report with repository references and related commits.

How does multi-agent ADR discovery work for tracking architecture changes?▼

Multi-agent ADR discovery coordinates specialist, strategist, and writer agents in a structured workflow to analyze architecture changes, feature evolutions, and policy decisions. They surface and format missing ADRs across repositories into an adr-candidates.md report.

Does ADR discovery check for duplicate architecture documentation across repos?▼

ADR discovery ensures non-duplicative results by specifying that only new ADRs are surfaced across core, web, worker, and infra repositories. The final adr-candidates.md list excludes redundant architecture decisions.

Can I trace discovered ADR candidates back to specific commits and PRs?▼

You can trace ADR candidates to specific commits and PRs because the discovery output includes repository references and related commit links. The generated adr-candidates.md list provides these references for governance tracking.

Related Skills

Explore More Software Engineering Skills→
bahayonghangbahayonghang
16

explore

Search codebases using glob, grep, LSP, AST, and git history.

Community
Basic
LetPeopleWorkLetPeopleWork
16

architecture-patterns

Document architecture decisions and patterns using ADR templates.

Official
Basic
rotnovrotnov

changelog-automation

Generate changelog entries from commits and pull requests following Keep a Changelog.

Community
Intermediate
jlissnerjlissner

grimoire-audit

Audit codebases to identify undocumented features and architecture decisions.

Community
Advanced