agentdev-workflow-learning-promote

Evaluates and promotes accumulated learning entries into durable artifacts via a seven-step workflow.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-workflow-learning-promote-yogata
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentdev-workflow-learning-promote
Source: https://github.com/yogata/agent-dev-flow/tree/main/src/opencode/skills/agentdev-workflow-learning-promote
Command: npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-workflow-learning-promote-yogata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams accumulate raw learning entries in an inbox file, but without a structured triage process these insights are never classified, evaluated, or converted into reusable knowledge, and risky irreversible changes can happen without approval. ## Core Features & Use Cases - Structured Evaluation Pipeline: Reads and normalizes inbox.md entries, classifies them into problem classes, scores them on an 8-axis rubric, and generates an evaluation report. - Disposition Judgment with Review: Determines promote/defer/reject/duplicate outcomes, checks against existing countermeasures, and runs an adversarial review loop before decisions are finalized. - Autonomous Decisions with HITL Fallback: Auto-confirms items that can be uniquely determined and escalates only genuinely ambiguous items for human approval, then persists results with atomic deferred moves, pruning, and scoped git commits. - Use Case: After several development sessions, run the learning-promote command to triage all accumulated learnings, promote the valuable ones into promoted/ artifacts routed to backlog review, and safely archive the rest. ## Quick Start Ask the agent to run the /agentdev/learning-promote command to evaluate and promote the pending learning entries in the inbox.

Frequently Asked Questions about agentdev-workflow-learning-promote

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

FAQPage Schema
How do I promote accumulated learning entries into reusable artifacts?▼

Run the /agentdev/learning-promote command, which reads .agentdev/learning/inbox.md, classifies entries into problem classes, scores them on an 8-axis rubric, and generates promoted artifacts under .agentdev/learning/promoted/ for entries that pass evaluation.

What happens to learning entries that are not promoted?▼

Non-promoted entries are moved to deferred.md, a living pool that preserves deferred, unprocessed, and re-evaluation entries for future runs. Only staged, rejected, or duplicate entries are pruned, and deferred items are never auto-deleted.

Does learning-promote require manual approval for every decision?▼

No. Items that can be uniquely determined from available evidence are auto-confirmed without user approval, and only items genuinely requiring human judgment are presented for HITL approval. Destructive changes like bulk inbox clearing always require explicit approval.

Can promoted learnings be applied directly to the agent configuration?▼

No. Direct writes to .opencode/ or direct handoff to case-run are prohibited. Promoted artifacts must flow through /agentdev/backlog-review, then req-define, case-open, and case-ready before becoming requirements.

What happens if the learning-promote workflow is interrupted mid-run?▼

The workflow resumes from durable file state rather than conversation context. It reconstructs the current step from inbox.md, deferred.md, evaluation-report.md, and promoted/ contents, treating missing approval evidence as unapproved and redoing only incomplete steps.