Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Vault ADR: Architecture Decision Records in Obsidian

    1

    Records big technical decisions as numbered ADRs in your Obsidian vault, so no agent undoes a choice without knowing why it was made.

    $4

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Vault ADR: Architecture Decision Records in Obsidian

    Vault ADR: Architecture Decision Records in Obsidian

    Example session with this skill installed

    Record an ADR: we store all prices as integer cents instead of floating-point dollars, because floats caused rounding errors in totals. We considered decimal.js but didn't want a dependency for this. Downside: every display needs formatPrice().

    • Read your context and instructions
    • Compiled the vault adr

    Wrote 01_Projects/shop-app/Decisions/0001-store-prices-as-integer-cents.md, created the Decisions/README.md index, and added an ADR-0001 line under Key Decisions in the project README.

    ---
    date: 2026-10-26
    status: accepted
    supersedes:
    superseded_by:
    tags: [adr]
    ---
    
    # 0001. Store all prices as integer cents
    
    ## Context
    Prices were previously held as floating-point dollars. Floating-point arithmetic caused rounding errors in totals, so sums of prices did not come out to exact amounts. We needed a representation that makes money arithmetic exact.
    
    ## Decision
    All prices are stored and computed as integer cents. Conversion to a human-readable dollar string happens only at display time, via `formatPrice()`.
    
    ## Alternatives considered
    - **decimal.js**: would solve the rounding problem, but we did not want to add a dependency for this.
    
    ## Consequences
    - ✅ Totals are exact; no floating-point rounding errors.
    - ✅ No third-party dependency.
    - ⚠️ Every place that displays a price must go through `formatPrice()`; forgetting it shows raw cents to the user.
    
    ## Links
    - Session: [[Chats/2026-10-26]]
    - Code: `src/money.js` (`formatPrice`), `src/cart.js`
    

    Index (Decisions/README.md):

    #DecisionStatusDate
    [[0001-store-prices-as-integer-cents|0001]]Store all prices as integer centsaccepted2026-10-26

    Connects securely to your tools. The creator never sees your data.

    About this skill

    A chat log says what happened. An ADR says why the code looks the way it does. Without one, the next agent (or the next person) will happily "fix" a decision you made on purpose.

    What it does

    • Notices when a session settles a decision that's expensive to reverse, like a framework, database, data model, auth approach or deployment target, and offers to record it.
    • Writes Decisions/0007-use-sqlite-for-local-cache.md with context, the decision, the alternatives considered and why they lost, consequences, and links to the session and the code.
    • Never invents reasons. If the why isn't known, it asks you.
    • Handles changes properly: a new ADR supersedes the old one, and both link to each other.
    • Keeps an index table in Decisions/README.md and a link in your project README.

    Ask it anything: "Why did we choose Postgres?" It answers from the ADRs and cites their numbers.

    Works with any agent that reads SKILL.md. No scripts, just Markdown in your vault. Tested end to end in real Claude Code sessions.

    • Records only what's known from the conversation and the code. If the reasons behind a decision were never discussed, it asks you or writes "Not recorded".
    • One decision per record. Big changes made of several decisions become several ADRs.
    • It offers ADRs for significant decisions only, not for naming, formatting or one-off bug fixes.
    • The project is identified by the workspace folder name, which must match the folder in your vault.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 21 days ago

    Permissions

    Read Files
    Write Files
    Environment Variables

    File Scopes

    $VAULT_PROJECTS_ROOT/**

    Reads and writes Markdown files only inside your vault's projects folder (Decisions/, the project README). Reads VAULT_PROJECTS_ROOT to find it. No scripts, no network access.

    Listed21 days ago

    What's inside

    Frequently Asked Questions

    An Architecture Decision Record: a short note that captures one technical decision with its context, the alternatives considered, and its consequences. It explains why the code looks the way it does.

    No. When a session settles a significant decision, it offers to record one. It writes immediately only when you ask for an ADR yourself.

    Accepted ADRs aren't rewritten. A new ADR supersedes the old one, and both are linked, so the history stays readable.

    No. Any folder of Markdown files works. Obsidian just makes the [[links]] between ADRs, chat logs and the README clickable.

    Yes. Vault Recall reads ADRs at the start of a session, Vault Digest includes new ADRs in the weekly recap, and Vault Import offers to turn big past decisions into ADRs.

    New in Productivity