omnilearn-workflow 1.0.0 → 1.0.1

package/commands/omnilearn-refine.md

@@ -28,6 +28,7 @@ Both scenarios follow the same core flow: research → analyze → produce struc
 .omnilearn/<skill>/
 ├── roadmap.md
 ├── SkillPreferences.md
+├── SkillConventions.md                  ← 🔑 Setup conventions read for consistent diagnostic tasks
 ├── progress-index.md
 ├── runs/
 │   └── YYYY-MM-DD-HHMMSS-refine-<topic>/

package/commands/omnilearn-roadmap-edit.md

@@ -32,6 +32,7 @@ This command performs the same rigorous research-backed process as `/omnilearn-r
 ├── UserPreferences.md
 └── <skill-name>/
     ├── SkillPreferences.md
+    ├── SkillConventions.md                  ← Preserved during edits
     ├── roadmap.md                          ← Will be updated
     ├── progress-index.md                   ← Must be preserved & updated
     ├── runs/

package/commands/omnilearn-roadmap.md

@@ -19,6 +19,7 @@ description: Create a comprehensive, real-world-ready learning roadmap for any s
 ├── UserPreferences.md                           ← Global user preferences (auto-read + updated)
 └── <skill-name>/                                 ← Normalized skill folder (e.g., "Rust", "Machine-Learning")
     ├── SkillPreferences.md                       ← Per-skill learning preferences
+    ├── SkillConventions.md                       ← 🔑 Setup conventions: package manager, project structure, deps, testing (auto-learned)
     ├── roadmap.md                                ← Master roadmap (the main deliverable)
     ├── progress-index.md                         ← Progress log — index of all runs
     ├── runs/                                     ← Research & execution logs

package/commands/omnilearn-start.md

@@ -30,7 +30,8 @@ The goal metric: **Can the user apply what they learned to real-world problems t
 .omnilearn/<skill>/
 ├── roadmap.md
 ├── SkillPreferences.md
-├── progress-index.md                       ← Overview index: links to topic-progress.md per topic
+├── SkillConventions.md                  ← 🔑 Setup conventions: package manager, project structure, deps, testing preferences (auto-learned)
+├── progress-index.md                   ← Overview index: links to topic-progress.md per topic
 ├── runs/                                   ← Skill-level run logs (action logs only, NOT progress)
 │   └── YYYY-MM-DD-HHMMSS-learning-<topic>/
 │       ├── agent-log.md                    ← What happened this run: decisions, actions taken
@@ -111,11 +112,12 @@ if [ ! -d "$SKILL_DIR" ] || [ ! -f "$ROADMAP" ]; then
 fi
 ```
 
-### 0.3 Read Progress, Preferences & Cross-Skill Inventory
+### 0.3 Read Progress, Preferences, Conventions & Cross-Skill Inventory
 
 Read these files to understand the current state:
 - `UserPreferences.md` (if exists) — learning style, experience level, goals
 - `SkillPreferences.md` — per-skill state, preferences
+- **`SkillConventions.md`** (if exists) — 🔑 **Setup conventions: package manager, project structure, deps, testing preferences. Read this BEFORE generating any scaffold or assignment — it ensures consistency.**
 - `progress-index.md` — overview of topic statuses
 
 **For any topics marked 🔵 In Progress**, read their `topic-progress.md` files to get the detailed state:
@@ -293,6 +295,7 @@ task(category="deep", run_in_background=false, timeout=600000, prompt="
    - Topics directory: {TOPICS_DIR}/{topic}/
    - User experience level: {from preferences}
    - User learning style: {from preferences}
+   - Skill conventions (package manager, project structure, deps, testing setup): {from SkillConventions.md — read before generating scaffold}
 ")
 ```
 
@@ -547,6 +550,7 @@ task(category="unspecified-high", run_in_background=false, timeout=300000, promp
    - Difficulty: {basic/intermediate/real-world}
    - Previous assignment concepts: {summary}
    - User performance on previous assignment: {observations}
+   - Skill conventions (package manager, project structure, deps, testing setup): {from SkillConventions.md — MUST follow these when generating scaffold}
 ")
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnilearn-workflow",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OmniLearn — AI-powered adaptive learning workflow for OpenCode. Multi-agent orchestration that creates personalized roadmaps, hands-on assignments, and tracks progress across any skill.",
   "keywords": [
     "opencode",