module-context-capture

Records architectural decisions and invariants in a module's CONTEXT.md file.

23|10|Updated Aug 31, 2017
One-click install
npx skills add https://github.com/IntentArchitect/Intent.Modules --skill module-context-capture-intentarchitect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: module-context-capture
Source: https://github.com/IntentArchitect/Intent.Modules/tree/main/Tests/ModuleBuilderSkills/.opencode/skills/module-context-capture
Command: npx skills add https://github.com/IntentArchitect/Intent.Modules --skill module-context-capture-intentarchitect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design reasoning behind a module's code disappears when a work session ends, leaving future maintainers unable to tell deliberate constraints from accidental ones. This Skill captures that durable knowledge in a per-module CONTEXT.md file so decisions, invariants, and cross-module relationships survive across sessions. ## Core Features & Use Cases - Decision Capture: Records architectural decisions with their reasoning, including rejected alternatives, at the moment the decision is made. - Pre-Modification Reading: Requires reading the CONTEXT.md of every module before changing it, and flags conflicts instead of silently overriding deliberate design. - Lifecycle Maintenance: Creates CONTEXT.md only when the first durable decision lands, and updates or removes superseded entries to prevent stale guidance. - Use Case: Before modifying an Intent Architect module's template, you read its CONTEXT.md and discover the template must stay transport-agnostic; after introducing a new setting-driven wiring change, you record the decision and the alternative you rejected. ## Quick Start Read the CONTEXT.md of the module I am about to modify, then record the design decision we just made along with the alternatives we rejected.

Frequently Asked Questions about module-context-capture

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

FAQPage Schema
How do I document architectural decisions for a software module?▼

Create a CONTEXT.md file inside the module's project folder and record each decision with its reasoning, including rejected alternatives. Write entries when the decision is made, not reconstructed later from memory.

What should go in a module CONTEXT.md file?▼

Include architectural decisions with reasoning, invariants and constraints, technology limitations, accepted patterns, setting-driven wiring behavior, and cross-module relationships. Exclude transient task state, TODO lists, and anything already recorded in release notes or documentation.

When should I create a CONTEXT.md for a module?▼

Create it when the first durable decision actually lands, such as a design choice with a rejected alternative or an invariant other code depends on. Creating one earlier produces an empty template that future sessions learn to ignore.

Where should CONTEXT.md be stored in a repository?▼

Place it inside the module's project folder, such as Modules/Intent.Modules.X/CONTEXT.md, with one file per module. Never put it at the repository root, in transient build folders, or inside intent metadata folders.

What should I do when a code change conflicts with CONTEXT.md?▼

Stop and flag the conflict rather than silently overriding the documented design. Either the context is stale and should be updated deliberately as part of the change, or the change itself is wrong and needs reconsideration.