mirror of
https://github.com/mattpocock/skills.git
synced 2026-04-30 14:03:53 +07:00
Clarify guidance on CONTEXT.md updates: emphasize meaningful terms for domain experts and avoid coupling to implementation details.
This commit is contained in:
@@ -68,6 +68,8 @@ When the user states how something works, check whether the code agrees. If you
|
|||||||
|
|
||||||
When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
|
When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
|
||||||
|
|
||||||
|
Don't couple `CONTEXT.md` to implementation details. Only include terms that are meaningful to domain experts.
|
||||||
|
|
||||||
### Offer ADRs sparingly
|
### Offer ADRs sparingly
|
||||||
|
|
||||||
Only offer to create an ADR when all three are true:
|
Only offer to create an ADR when all three are true:
|
||||||
|
|||||||
Reference in New Issue
Block a user