Architecture decision records

Skill roronoazoroshao369/vibe-coding-os/skills/core/architecture-decision-records

Vibe Coding OS — Claude/Codex/Cursor skill framework with 139 skills, 111 commands, 95 templates, 22 tracked sources, 28/28 validation gates PASS. Quality Shield, Engineering Discipline Pack, plugin marketplace.From the repository description

Install

npx -y skills add roronoazoroshao369/vibe-coding-os --skill architecture-decision-records

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.5 KB, 328 tokens by cl100k_base, as published. Nobody here has run it

Skill: Architecture Decision Records

Purpose

Capture important technical decisions, tradeoffs, and consequences in small ADRs.

When to use

Use for decisions that will matter after the session: architecture, data model, workflow policy, dependency choice, or irreversible constraints.

Inputs

Decision topic, context, options considered, selected option, rationale, consequences, and follow-up checks.

Workflow

Decide whether the choice is ADR-worthy.
Use templates/adr-template.md.
Record context, decision, alternatives, consequences, and verification.
Link related PRD/issues/context terms.
Do not create fake ADRs for choices not made.

Outputs

An ADR draft or update, plus links from docs/adr/README.md or CONTEXT.md when appropriate.

Failure modes

Documenting every tiny choice, hiding uncertainty, omitting rejected options, or turning ADRs into essays.

Verification checklist

The ADR is dated; status is clear; decision drivers are named; consequences are honest; no secrets are included.

Ghi chú tiếng Việt

ADR giúp nhớ “vì sao chọn cách này”. Dùng khi quyết định có tác động lâu dài. File liên quan: docs/adr/README.md, templates/adr-template.md, CONTEXT.md. Upstream update thì chỉ học cấu trúc/trigger, không chép ADR mẫu.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.