skills.rest
pelchers
pelchersCOMMUNITY
Explore all skills by this author →
GitHub

adr-setup

Bootstrap and maintain .adr/ Architecture Decision Record workspaces with templates and lifecycle rules.

Updated Mar 6, 2026
Search Tags:#automation#architecture#templates#adr#conventions#session-management#workflows
One-click install
npx skills add https://github.com/pelchers/MockTrialGame --skill adr-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-setup
Source: https://github.com/pelchers/MockTrialGame/tree/main/.claude/skills/adr-setup
Command: npx skills add https://github.com/pelchers/MockTrialGame --skill adr-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a self-contained ADR workspace bootstrap and lifecycle tooling to standardize Architecture Decision Records across projects, reducing setup time and ensuring consistent conventions.

Core Features & Use Cases

  • ADR folder bootstrap: creates a standard .adr/ layout with orchestration, current, history, and agent_ingest folders.
  • Session lifecycle templates: includes templates for PRD, technical requirements, notes, and a primary task list to manage phase progress.
  • Phase management: enforces phase planning, execution, review, and archival with template guidance.
  • Audits and templates: ships reference conventions and template files to enforce consistency, auditability, and knowledge capture.
  • Use cases: bootstrap a new project, add a new ADR session to an existing workspace, and audit for conformance.

Quick Start

Initialize the ADR workspace for a new project using the provided templates and conventions.

Frequently Asked Questions about adr-setup

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

FAQPage Schema
How do I set up Architecture Decision Records for a new project?▼

Architecture Decision Record setup involves bootstrapping a standard `.adr/` workspace with orchestration, current, history, and agent_ingest folders to enforce consistency and traceability across your project.

What templates are included for managing ADR sessions?▼

Included ADR session templates cover PRD, technical requirements, notes, and a primary task list to manage phase progress, ensuring consistent knowledge capture and auditability throughout the lifecycle.

How do I enforce conventions and audit existing Architecture Decision Records?▼

Auditing Architecture Decision Records involves applying shipped reference conventions and template files to check conformance, enforce consistency, and ensure traceability across completed project phases.

Can I add a new ADR session to an existing workspace?▼

Yes, adding a new ADR session to an existing workspace uses the provided lifecycle templates and fixed folder layout to maintain phase planning, execution, review, and archival consistency.

What is the best way to manage the lifecycle of architecture decisions?▼

Managing architecture decisions effectively requires enforcing phase planning, execution, review, and archival using standardized templates and lifecycle rules within a dedicated `.adr/` workspace structure.

Related Skills

Explore More Software Engineering Skills→
im9im9
1

adr

Generate ADR documents with context, alternatives, and trade-offs.

Community
Intermediate
aslaiiaslaii

gsd-cleanup

Archive completed milestone phase directories into .planning/milestones/v{X.Y}-phases/.

Community
Intermediate
LetPeopleWorkLetPeopleWork
16

architecture-patterns

Document architecture decisions and patterns using ADR templates.

Official
Basic
simonheimlichersimonheimlicher
1

architecting-python

Generate Architecture Decision Records for Python architecture decisions.

Community
Advanced