← ClaudeAtlas

decision-capturelisted

Use when recording, updating, accepting, or superseding a durable project decision that constrains future work, including a maintainer's promotion of an already-recorded policy-level verification observation. Covers tracked Markdown decision records under .agenticloop/decisions/, maintainer ownership, proposed vs accepted state, source-linked discoverability, supersession, and decision.recorded events.
bartoszarendt/agenticloop · ★ 2 · AI & Automation · score 71
Install: claude install-skill bartoszarendt/agenticloop
# Decision capture Decision records are the small docs-first layer for durable project decisions. They are broader than the narrow ADR threshold. If a decision constrains future work and later agents would benefit from seeing it, it can earn a decision record even when it is not especially surprising or hard to reverse. ## When to Use Use this skill when a project decision needs a tracked Markdown record because it constrains future work. Common scopes include: - process, - architecture, - backend choice, - role boundaries, - quality rules, - security posture, - release rules, - product direction, - accepted project conventions, - verification. Strong ADR-style signals such as hard to reverse, surprising, or tradeoff-heavy still matter, but they are not the only trigger. ## Verification operating decisions This is a promotion path, not timeout handling. First use [[verification-evidence]] to record the task attempt. The maintainer then triages it and, when the observation affects repeated project work, records or updates the current `VF-...` fact in `.agenticloop/project.md`. Use this skill for verification only when that already-recorded fact represents a policy-level conclusion that constrains future work, such as a project rule to use CI rather than local execution for a class of checks. The decision cites the `VF-...` fact and its durable task/event evidence, states the policy and revisit trigger, and follows the normal acceptance gate. Do not use this skill for