Organizational Learning
Keep raw feedback, candidate lessons, project rules, and formal BuildOS rules in distinct states. Resolve ordinary corrections in the current task. Load this skill only for inbox review, formal retrospectives, lesson promotion, or knowledge distillation.
Route by Outcome
- Submit or review feedback candidates: Feedback Review.
- Retrospect, deduplicate, promote, or retire resolved lessons: Organizational Learning.
- Promote cross-project improvements into BuildOS: BuildOS Evolution.
- Absorb external Skills/knowledge after current model and host calibration: Knowledge Distillation.
Run the project's validator when modifying formal Lessons Learned. Raw feedback does not need a Lessons ID.
Core Contract
- Capture: Use the local CLI only when BuildOS use in a real project shows that a skill, reference, template, script, hook, or rule caused error, misdirection, execution difficulty, empty guidance, unnecessary work, or inefficiency. Do not capture business requests or ordinary corrections automatically.
- Review: Deduplicate by root cause and classify as
discard, project, buildos_candidate, or needs_evidence.
- Promote: Calibrate against current official guidance for the target model and host. Absorb useful domain capability without importing obsolete prompting workarounds or process overhead. Keep project-specific rules with their owner; promote cross-project meaning with scoped evidence.
Record the component, concrete impact, and evidence or workaround. Dissatisfaction can start a candidate but a vague opinion is insufficient; frequency is not a mechanical threshold. Correct the source first. Do not add prompts, validators, or approvals for every mistake or duplicate a rule across skills, inboxes, logs, and lessons.
Handoff disputed facts or causes to Assurance and customer requirements to Product. Learning owns knowledge lifecycle, not domain facts or Git/release authorization.
1---2name: senmu-build-learning3description: Review BuildOS feedback, retrospectives, verified lessons, or external guidance for reusable rules. Not for ordinary corrections, logs, or independent audits.4---56# Organizational Learning78Keep raw feedback, candidate lessons, project rules, and formal BuildOS rules in distinct states. Resolve ordinary corrections in the current task. Load this skill only for inbox review, formal retrospectives, lesson promotion, or knowledge distillation.910## Route by Outcome1112- Submit or review feedback candidates: [Feedback Review](references/feedback-candidates-and-central-adjudication.md).13- Retrospect, deduplicate, promote, or retire resolved lessons: [Organizational Learning](references/organizational-learning-and-governance-closure.md).14- Promote cross-project improvements into BuildOS: [BuildOS Evolution](references/buildos-evolution-and-upstream-feedback.md).15- Absorb external Skills/knowledge after current model and host calibration: [Knowledge Distillation](references/engineering-knowledge-distillation-and-standard-promotion.md).1617Run the project's validator when modifying formal Lessons Learned. Raw feedback does not need a Lessons ID.1819## Core Contract20211. **Capture:** Use the local CLI only when BuildOS use in a real project shows that a skill, reference, template, script, hook, or rule caused error, misdirection, execution difficulty, empty guidance, unnecessary work, or inefficiency. Do not capture business requests or ordinary corrections automatically.222. **Review:** Deduplicate by root cause and classify as `discard`, `project`, `buildos_candidate`, or `needs_evidence`.233. **Promote:** Calibrate against current official guidance for the target model and host. Absorb useful domain capability without importing obsolete prompting workarounds or process overhead. Keep project-specific rules with their owner; promote cross-project meaning with scoped evidence.2425Record the component, concrete impact, and evidence or workaround. Dissatisfaction can start a candidate but a vague opinion is insufficient; frequency is not a mechanical threshold. Correct the source first. Do not add prompts, validators, or approvals for every mistake or duplicate a rule across skills, inboxes, logs, and lessons.2627Handoff disputed facts or causes to Assurance and customer requirements to Product. Learning owns knowledge lifecycle, not domain facts or Git/release authorization.