Create learnings/ folder with structure and template #39

New Issue

HugoNijhuis · 2026-01-07T18:51:33Z

HugoNijhuis commented

2026-01-07 18:51:33 +00:00

Summary

Create a learnings/ folder to store captured learnings from retros. Learnings serve as both historical record and governance reference, while also being encoded into skills/commands/agents.

Structure

learnings/
├── README.md                         # How learnings work
└── YYYY-MM-DD-short-title.md         # Individual learnings

Learning Template

# [Title]

**Date**: YYYY-MM-DD
**Context**: What triggered this learning

## Learning
The insight we gained.

## Encoded In
- `skills/xxx/SKILL.md` - What was added/changed
- `commands/xxx.md` - What was added/changed

## Governance
What this learning means for how we work going forward.

README Content

Should explain:

Purpose of learnings (historical + governance + encoding)
How to write a learning
The encoding process
Periodic review process

Acceptance Criteria

learnings/ folder created
README.md explains the learnings system
Template documented for new learnings
Clear guidance on encoding vs storing

## Summary Create a `learnings/` folder to store captured learnings from retros. Learnings serve as both historical record and governance reference, while also being encoded into skills/commands/agents. ## Structure ``` learnings/ ├── README.md # How learnings work └── YYYY-MM-DD-short-title.md # Individual learnings ``` ## Learning Template ```markdown # [Title] **Date**: YYYY-MM-DD **Context**: What triggered this learning ## Learning The insight we gained. ## Encoded In - `skills/xxx/SKILL.md` - What was added/changed - `commands/xxx.md` - What was added/changed ## Governance What this learning means for how we work going forward. ``` ## README Content Should explain: - Purpose of learnings (historical + governance + encoding) - How to write a learning - The encoding process - Periodic review process ## Acceptance Criteria - [ ] `learnings/` folder created - [ ] `README.md` explains the learnings system - [ ] Template documented for new learnings - [ ] Clear guidance on encoding vs storing

HugoNijhuis referenced this issue

2026-01-07 18:52:06 +00:00

Update /retro command to store learnings and create encoding issues #42

HugoNijhuis referenced this issue

2026-01-07 18:52:27 +00:00

Rename repo from 'ai' to 'architecture' #44

HugoNijhuis added a new dependency 2026-01-07 18:52:39 +00:00

#42 Update /retro command to store learnings and create encoding issues

HugoNijhuis added a new dependency 2026-01-07 18:52:39 +00:00

#44 Rename repo from 'ai' to 'architecture'

HugoNijhuis referenced this issue

2026-01-07 18:52:51 +00:00