mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-18 15:06:28 +03:00
Magnus HedemarkandGitHub
a56360b9a2
Add a lifecycle method and reusable record for connecting architecture decisions to checks, evidence, review, exceptions, and retirement.\n\nAI-assisted: Jasper orchestrated implementation and verification with OpenCode. Signed-off-by: Magnus Hedemark <magnus919@pm.me>
40 lines
2.5 KiB
Markdown
40 lines
2.5 KiB
Markdown
# Adr Authoring
|
|
|
|
Preserve the reasoning behind consequential architecture choices so later contributors can understand, revisit, or supersede them responsibly.
|
|
|
|
## Why Install This Skill
|
|
|
|
Preserve the reasoning behind consequential architecture choices so later contributors can understand, revisit, or supersede them responsibly. It preserves a practical method, local reference material, and reusable templates so an agent can do more than produce a generic answer.
|
|
|
|
Use it when the work needs a repeatable process and an inspectable result. It is portable across Agent Skills-compatible clients and does not require a profile system or a particular task orchestrator.
|
|
|
|
## What You Get
|
|
|
|
| Path | What it provides |
|
|
|---|---|
|
|
| `SKILL.md` | Trigger conditions, workflow, and guidance for loading deeper resources. |
|
|
| `references/` | Reference material for ADR formats, lifecycle, sustainability, fitness-function design, and provenance. |
|
|
| `templates/fitness-function-record.md` | Fillable record connecting an ADR decision to a check and observed evidence. |
|
|
|
|
## Quick Start
|
|
|
|
Read `SKILL.md` for the decision workflow, then start from `references/adr-format.md`. When a decision needs ongoing confirmation, use `templates/fitness-function-record.md` with `references/fitness-functions.md`.
|
|
|
|
Install or expose this directory using your agent's standard Agent Skills loading mechanism, then ask for work that matches the triggers below.
|
|
|
|
## Triggers
|
|
|
|
- Write, review, and maintain architecture decision records with clear context, alternatives, consequences, confirmation links, and lifecycle governance. Use when a consequential technical decision or its enforceable architectural constraint must remain understandable.
|
|
- Define or review a fitness function's scope, cadence, evidence, threshold, ownership, exception handling, gaming resistance, review, or retirement.
|
|
- Do not use for system-wide evolutionary architecture design, general observability, or operating a named test or CI tool.
|
|
- Requests involving the method, deliverables, or review process described in `SKILL.md`.
|
|
- Work where a reusable template or reference from this skill would reduce avoidable mistakes.
|
|
|
|
## Requirements
|
|
|
|
No runtime dependency.
|
|
|
|
## Source and maintenance
|
|
|
|
This skill was extracted from [`magnus919/hermes-profiles`](https://github.com/magnus919/hermes-profiles) at commit [`867a555`](https://github.com/magnus919/hermes-profiles/commit/867a555). The portable methodology was retained; Hermes-specific profile, orchestration, and memory assumptions were removed.
|