context-and-decisions SKILL.md skillA

context-and-decisions from affaan-m/ecc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add affaan-m/ecc/context-and-decisions@git:20261002.2d829c0

Pins git:20261002.2d829c0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
affaan-m/ecc
Path
.agents/skills/context-and-decisions/SKILL.md
Versions recorded
1
Latest version
git:20261002.2d829c0, committed Oct 2, 2026
Size
4,728 bytes
Repository stars
284,510
License
MIT

Govern stable domain context with a narrowly scoped CONTEXT.md when needed, and route hard-to-reverse decisions to ECC's existing architecture-decision-records skill. Use when domain terms require repeated explanation, one term has multiple meanings, unclear language causes module-boundary mistakes, or domain semantics must remain separate from architecture decisions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Domain Context and Decision Handoff

Govern “what these business terms mean” separately from “why this option was chosen.” Do not create an empty shell when no stable content exists.

## Domain Context Artifact: Domain Language Only

When terms require repeated explanation, one term has multiple meanings, or unclear language causes module-boundary errors, first reuse the repository's existing glossary/domain-model document or the `context` role in `.governance/docs-map.json`. Only when no equivalent exists should you lazily create the default `CONTEXT.md` from `templates/context.example.md`.

Record only:

- domain terms and precise definitions;
- relationships among core concepts;
- confirmed ambiguities and the chosen interpretation;
- ambiguities still awaiting confirmation from a domain owner.

Do not include implementation details, current state, task schedules, full requirements, decision rationale, or history. Keep those in code/MAP, STATUS/Issue Tracker, Spec, ADR, and LOG respectively. Terms must be traceable to code, contracts, or business evidence. Mark unconfirmed items as `needs confirmation`; do not guess.

## ADR Handoff: Reuse the Existing Capability
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add affaan-m/ecc/context-and-decisions@sha256:5158283621d6d152

The line at the top of this page pins the label git:20261002.2d829c0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_kghnhbllue2aw6vw.svg)](https://markdownregistry.com/a/art_kghnhbllue2aw6vw)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 2, 2026.

versioncommittedcommitsizeaudit
git:20261002.2d829c0 latest2026-10-02 2d829c0 4,728 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4728 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

affaan-m/ecc · 284,510 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kghnhbllue2aw6vw
GET https://markdownregistry.com/api/v1/resolve?ref=affaan-m/ecc/context-and-decisions
GET https://markdownregistry.com/api/v1/blob/5158283621d6d15288dab50fc2e884cf114b8d91137e45e619bf3dff4740f3e0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from affaan-m/ecc

agent-introspection-debugging SKILL.md skill
affaan-m/ecc · .agents/skills/agent-introspection-debugging/SKILL.md · Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and…
git:20260918.c752aac · audit A · 284,510 stars
agent-sort SKILL.md skill
affaan-m/ecc · .agents/skills/agent-sort/SKILL.md · Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras…
git:20260918.c752aac · audit A · 284,510 stars
api-design SKILL.md skill
affaan-m/ecc · .agents/skills/api-design/SKILL.md · REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning…
git:20260918.c752aac · audit A · 284,510 stars
article-writing SKILL.md skill
affaan-m/ecc · .agents/skills/article-writing/SKILL.md · Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice…
git:20260918.c752aac · audit A · 284,510 stars
backend-patterns SKILL.md skill
affaan-m/ecc · .agents/skills/backend-patterns/SKILL.md · Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express…
git:20260918.c752aac · audit A · 284,510 stars
benchmark-methodology SKILL.md skill
affaan-m/ecc · .agents/skills/benchmark-methodology/SKILL.md · Use after competitive-platform-analysis has produced a tiered competitor set. Scores each competitor across nine…
git:20260918.c752aac · audit A · 284,510 stars
brand-discovery SKILL.md skill
affaan-m/ecc · .agents/skills/brand-discovery/SKILL.md · Use when a brand needs to discover or articulate its identity through structured multi-session interviews. Covers…
git:20260918.c752aac · audit A · 284,510 stars
brand-voice SKILL.md skill
affaan-m/ecc · .agents/skills/brand-voice/SKILL.md · Build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that…
git:20260918.c752aac · audit A · 284,510 stars
bun-runtime SKILL.md skill
affaan-m/ecc · .agents/skills/bun-runtime/SKILL.md · Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel…
git:20260928.48decd0 · audit B · 284,510 stars
change-impact SKILL.md skill
affaan-m/ecc · .agents/skills/change-impact/SKILL.md · Perform evidence-backed impact analysis before changing code, data, interfaces, or governance documents, then compare…
git:20261002.4f08958 · audit A · 284,510 stars
coding-standards SKILL.md skill
affaan-m/ecc · .agents/skills/coding-standards/SKILL.md · Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed…
git:20260918.c752aac · audit A · 284,510 stars
competitive-platform-analysis SKILL.md skill
affaan-m/ecc · .agents/skills/competitive-platform-analysis/SKILL.md · Use when scoping a competitive landscape — identifying, categorising, and score-filtering a competitor set before any…
git:20260918.c752aac · audit A · 284,510 stars

Every file in affaan-m/ecc

Other files named context-and-decisions

context-and-decisions SKILL.md skill
qshanx/docs-governance · skills/documentation/context-and-decisions/SKILL.md · 兼容旧 context-and-decisions 调用;领域术语与 ADR 的形成和修改统一转交随插件提供的 domain-modeling。
git:20261012.bd30f6e · audit A · 218 stars

Browse by kind, by grade A, or by owner.