context

Retrieve relevant Architecture Decision Records for a given task description.

4|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rvdbreemen/adr-kit --skill context-rvdbreemen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context
Source: https://github.com/rvdbreemen/adr-kit/tree/main/skills/context
Command: npx skills add https://github.com/rvdbreemen/adr-kit --skill context-rvdbreemen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Ensures developers honor existing architecture decisions while coding, reducing rediscovery and contradictions.

Core Features & Use Cases

  • Relevant ADRs: Automatically retrieves the most relevant Architecture Decision Records (ADRs) based on a task description.
  • Contextual Information: Provides a summary of the ADRs, including title, decision, file path, and relevance score.
  • Implementation Guidance: Offers a brief statement on the net constraint of the decisions for the task, aiding in compliance.

Quick Start

Run the context skill with the topic 'mqtt discovery' to get the relevant ADRs for implementing MQTT discovery.

Frequently Asked Questions about context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check existing Architecture Decision Records before implementing code?

To check Architecture Decision Records before implementing code, you automatically surface relevant ADRs by providing a task description. The system retrieves matching records and provides summaries including the title, decision, file path, and relevance score to ensure compliance.

What is the best way to ensure code compliance with ADRs during development?

The best way to ensure code compliance with ADRs is to automatically retrieve relevant architecture decisions based on your task. This provides implementation guidance and a brief statement on the net constraint of the decisions, reducing contradictions and rediscovery during development.

How do I find relevant contextual information for a specific task like MQTT discovery?

To find relevant contextual information for a specific task like MQTT discovery, you run the context skill with your topic. It automatically surfaces the most relevant Architecture Decision Records, including their file paths and relevance scores for your implementation.

Can I get implementation guidance for existing architectural decisions automatically?

Yes, you can get implementation guidance for existing architectural decisions automatically. The system applies to code implementation workflows in projects with ADRs, offering a brief statement on the net constraint of the decisions to aid in compliance.

Why should I retrieve architectural decisions before writing new code?

You should retrieve architectural decisions before writing new code to ensure developers honor existing architecture decisions. This reduces rediscovery and contradictions, keeping your new implementation within established project guidelines.

Does this ADR retrieval method work without external dependencies?

Yes, this ADR retrieval method works without external dependencies. It utilizes internal scripts and references to automatically surface relevant Architecture Decision Records based on your given topic or task description.