Skip to content
Kitbay
Skill

context-and-decisions

MITUpdated on Nov 17, 2026305,644GitHub stars

A skill from the ECC collection that keeps a project's domain vocabulary apart from its design decisions.

What the skill teaches

A skill from the ECC collection that keeps a project's domain vocabulary apart from its design decisions. When business terms keep needing explanation or one word carries several meanings, the agent first reuses any existing glossary, and only with the user's approval starts a short CONTEXT.md holding terms, how concepts relate, settled ambiguities and open questions, each traced to code or other evidence. During discussion it points out contradictions and splits overloaded terms without deciding business rules itself. Decisions that are hard to undo are handed to ECC's architecture-decision-records skill, and tasks or status stay in the issue tracker. The approach adapts Matt Pocock's domain-modeling skill.

Capabilities

  • Keep a glossary of domain terms in CONTEXT.md
  • Separate overloaded terms and record the chosen meaning
  • Hand hard-to-reverse decisions to an ADR skill