Skip to content
TrustedSkillsbeta
Back to all skills

Architecture Decision Record (ADR)

Checked
product-on-purpose·v1.0.0·writing·Apache-2.0

<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->

Install on your platform

Showing OpenClaw.

  1. 1

    Run this in your terminal

    terminal
    $

What we know about this skill

Publisher

product-on-purpose

Taken from the source listing. We haven't verified who controls this account.

Install target

Live repository

Not pinned. Installing fetches whatever the repository holds at the time you run the command.

No human has reviewed this code. The checks below are a static scan of the files at one commit — nobody has run this skill or judged whether it works. A skill runs with whatever access you give your agent, so read the source before you install it.

Automated safety checks

scanned

This skill passed all 6 checks. We read its files at one commit and looked for the things that make a skill dangerous to run — not for whether it works.

  • Declares what it does: passed

    SKILL.md parses and declares a name and a description.

    SKILL.md exists, its frontmatter parses, and it declares a name and a description.

  • No undeclared network calls: passed

    Makes no network calls.

    Every host the skill dials — from its scripts, its config endpoints or the commands it tells the agent to run — is either well-known package and API infrastructure or declared in its own frontmatter. Links in documentation are not counted.

  • No obfuscated payloads: passed

    No encoded or obfuscated payloads.

    No base64, hex or compressed blob is decoded and then executed, and no encoded shell commands.

  • No credential access: passed

    Reads no keys, tokens, keychains or credential files.

    Neither the code nor the SKILL.md instructions read SSH keys, cloud credentials, keychains, token stores, browser cookie databases or dotfiles that hold secrets.

  • No pipe-to-shell installers: passed

    No pipe-to-shell or download-and-run installers.

    No `curl … | sh` pattern, in the code or in the instructions, that runs code fetched at run time.

  • Pinned to a commit: passed

    Scanned product-on-purpose/pm-skills at 1cef1a9eae.

    The exact upstream commit SHA that was scanned is recorded, so the result refers to specific bytes.

Commit
1cef1a9eae
Manifest
skills/develop-adr/SKILL.md
Scanned
7 files, 557 lines
This is a static scan, not a review. It reads the skill's files; it does not run them, and it cannot tell you whether the skill is any good or whether the code does what its description says. A skill runs with whatever access you give your agent.
What each check looks for →

About this skill

What it does

This skill helps generate Architecture Decision Records (ADRs). ADRs are short, plain text documents that capture important decisions made during software development, including the context, options considered, and reasons for choosing a particular approach. The skill can create new ADRs from scratch or update existing ones with additional information about implementation details or outcomes. It aims to improve transparency and maintainability by documenting architectural choices.

When to use it

  • When deciding on a specific technology stack for a project (e.g., "Which database should we use?").
  • To document the rationale behind choosing a particular design pattern.
  • During discussions about scaling strategies or performance optimization.
  • To record decisions related to security and compliance requirements.

Key capabilities

  • Generates new ADR documents with standard sections (Context, Decision, Consequences).
  • Updates existing ADRs with implementation details and outcomes.
  • Supports various formatting options for clarity and readability.
  • Facilitates collaboration by providing a centralized record of architectural decisions.

Example prompts

  • "Create an ADR about our choice to use React for the frontend."
  • "Update the 'Database Selection' ADR with details on how we implemented caching."
  • "Generate a new ADR outlining the decision to migrate to serverless functions."

Tips & gotchas

This skill is most effective when used proactively during architectural discussions. Ensure all stakeholders are involved in the decision-making process and that the resulting ADR accurately reflects the agreed-upon approach.