Pattern Proposal: Markdown template-driven knowledge capture
Summary
cas-knowledge/templates contains Markdown templates for patterns, rules, signals, learning records, experiments, ADRs, and promotion decisions, standardizing knowledge capture.
Candidate Pattern
- ID:
markdown-template-knowledge-capture - Classification: architectural
- Maturity: emerging
- Type: emerging
Observed Signals
No specific signals listed.
Evidence
Supporting Evidence
- cas-knowledge/templates/pattern_template.md - Template for pattern artifacts.
- cas-knowledge/templates/heuristic-to-pattern_template.md - Template for promoting heuristics to patterns.
- cas-knowledge/templates/signal_template.md - Template for signal artifacts.
- cas-knowledge/templates/learning_template.md - Template for learning records.
Scope Assessment
- Evidence Strength: medium
- Confidence: medium
- Applies to: ideas-to-life-cas
Rationale
- Intent: Reduce variation in how architectural learning artifacts are written and reviewed.
- Context: The project explicitly treats heuristics, patterns, signals, and decisions as first-class knowledge artifacts.
- Force: Knowledge records need comparable sections
- Force: Promotion from heuristic to pattern needs traceable rationale
- Force: Templates should be easy to copy and minimize authoring friction
Traceability
Artifact source: proposed-patterns