Skills adr-log

📦

adr-log

Name: adr-log
Author: Doyajin174

v1.0 Content revision r1 Safe ⚙️ External commands🌐 Network access

Document Architecture Decisions with ADRs

Teams forget why major technical choices were made. This skill helps draft, review, and organize ADRs with clear context, alternatives, and consequences.

Supports: Claude Codex Code(CC)

🥉 79 Bronze

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request

Review the Skillstore skill "adr-log" from https://skillstore.io/skills/doyajin174-adr-log.md and its manifest at https://skillstore.io/api/skills/doyajin174-adr-log/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/doyajin174-adr-log.md Signed manifest GET /api/skills/doyajin174-adr-log/manifest Signed lockfile GET /api/skills/doyajin174-adr-log/lockfile

Test it

Using "adr-log". We chose Next.js App Router for a new marketing and product site.

Expected outcome:

A complete ADR with accepted status, decision context, compared alternatives, expected benefits, tradeoffs, risks, and reference links.

Using "adr-log". Our team needs a decision history for database and authentication choices.

Expected outcome:

An ADR folder plan, numbering scheme, index outline, and checklist for consistent future records.

Using "adr-log". An older ADR chose MongoDB, but the product now requires stronger relational integrity.

Expected outcome:

A superseding ADR that explains the changed context, compares migration options, and records consequences for the team.

Security Audit

Safe

v8 • 7/6/2026 Open versioned report

The static command findings are false positives from markdown code fences, inline filenames, and optional CLI examples. The hardcoded URLs are reference links, and the entropy heuristic reflects readable markdown with Korean text, not obfuscation. No prompt injection, data exfiltration intent, or hidden executable behavior was found.

Files scanned

480

Lines analyzed

Review items

False positives ignored

No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.

Audited by: codex View Audit History →

Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report

Copy report link

https://skillstore.io/skills/doyajin174-adr-log/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/doyajin174-adr-log/security.svg)](https://skillstore.io/skills/doyajin174-adr-log?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/doyajin174-adr-log?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/doyajin174-adr-log/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/doyajin174-adr-log.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Academic citations (APA · BibTeX · CFF)

APA citation

Doyajin174. (2026). adr-log security audit report (audit version 8) [Author version 1.0]. Skillstore. https://skillstore.io/skills/doyajin174-adr-log/audits/8

BibTeX citation

@techreport{doyajin174-doyajin174-adr-log-2026,
  author = {Doyajin174},
  title = {adr-log security audit report (audit version 8)},
  institution = {Skillstore},
  year = {2026},
  number = {8},
  url = {https://skillstore.io/skills/doyajin174-adr-log/audits/8},
  note = {Author version 1.0}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "adr-log security audit report (audit version 8)"
version: "1.0"
type: report
authors:
  - name: "Doyajin174"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/doyajin174-adr-log/audits/8"
identifiers:
  - type: other
    value: "skillstore:doyajin174-adr-log:audit:8"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: High

Architecture

Maintainability

Content

Community

Spec Compliance

What You Can Build

Record Framework Decisions

Capture why a team selected a frontend, backend, database, or library option over alternatives.

Onboard New Engineers

Create a readable decision history that explains past tradeoffs for new team members.

Review High Impact Changes

Use ADRs during pull requests to document infrastructure, security, or platform decisions.

Try These Prompts

Create a Basic ADR

Use adr-log to draft an ADR for choosing PostgreSQL. Include context, alternatives, decision, consequences, risks, and references.

Review a Draft ADR

Review my draft ADR for clarity, missing alternatives, weak rationale, and unclear consequences. Suggest specific edits.

Build an ADR Index

Create an ADR index for these decisions with numbers, titles, statuses, dates, and short summaries.

Plan a Superseding ADR

Analyze these related ADRs and draft a new ADR that supersedes the outdated decision. Explain migration impact and remaining risks.

Best Practices

Write an ADR soon after team alignment, while the rationale is still clear.
Document serious alternatives and tradeoffs, not only the final choice.
Use a new ADR to supersede old decisions instead of silently rewriting history.

Avoid

Do not use ADRs for small implementation details with no lasting impact.
Do not write only the chosen option without context or rejected alternatives.
Do not keep decisions only in chat, meetings, or pull request comments.

Frequently Asked Questions

What is an ADR?

An ADR is a short document that records an important architecture decision and the reason behind it.

When should I use this skill?

Use it when a technical decision affects architecture, dependencies, security, operations, performance, or long term maintenance.

Can it create ADR files for me?

It can help draft file content and structure when the AI tool has permission to edit your workspace.

Does it require adr-tools?

No. The skill includes optional adr-tools examples, but plain markdown files are enough for ADR documentation.

Can I use it with Claude Code or Codex?

Yes. The report marks support for Claude, Codex, and Claude Code workflows.

How should old decisions be changed?

Mark the old ADR as superseded and create a new ADR that explains the updated decision.

Developer Details

Author

Doyajin174

License

MIT

Author version

v1.0

Skillstore revision

Version notice

The author-declared version is not valid SemVer.

Repository

https://github.com/Doyajin174/myskills/tree/main/.public/skills/adr-log

Ref

72d5025b022c77f7a51bdf5c1637c689c80e89d1

Maintenance freshness

7/18/2026

Usage

4 downloads · 233 views

File structure

📄 audit_output.json

📄 SKILL.md

adr-log

Install with my Agent

Agent-readable resources

Test it

Security Audit

Risk Factors

Copy report link

Markdown badge

HTML badge

Embed card

APA citation

BibTeX citation

CITATION.cff

Skillstore Score

What You Can Build

Record Framework Decisions

Onboard New Engineers

Review High Impact Changes

Try These Prompts

Best Practices

Avoid

Frequently Asked Questions

Developer Details